Analytics

O Analytics reúne métricas operacionais da organização em /admin/analytics. O acesso aos dados de Visão Geral, Agentes, Usuários, Modelos, Créditos e SLA exige a permissão analytics.view. A aba Logs usa a permissão independente audit_log.view e também pode ser aberta diretamente em /admin/analytics/logs.

O item Analytics pode desaparecer do menu lateral quando a organização ainda não tem nenhuma mensagem. Isso não altera as permissões da rota: o menu é orientativo, enquanto o acesso direto continua protegido pelas permissões acima.

Entenda os períodos antes de comparar números

As abas não compartilham um único filtro global:

• os quatro cards da Visão Geral, os rankings de Agentes e Usuários e os dados de Modelos são acumulados, sem corte de 30 dias;
• somente o gráfico Conversas por Dia da Visão Geral mostra os últimos 30 dias;
• Créditos tem seus próprios filtros de agente, canal e datas;
• SLA tem um seletor próprio de 7, 30 ou 90 dias, além de período personalizado;
• Logs começa em 7 dias e oferece 24 horas, 7 dias ou 30 dias.

Por isso, não compare dois cards apenas porque estão na mesma página. Confirme primeiro qual período e qual população cada um representa.

As sete abas

• Visão Geral: totais acumulados e um gráfico de conversas iniciadas nos últimos 30 dias.
• Agentes: até 10 agentes não arquivados, ordenados pelo total acumulado de conversas.
• Usuários: até 10 membros não removidos, ordenados pelo total acumulado de conversas.
• Modelos: respostas de IA, tokens e créditos agrupados pelo modelo registrado.
• Créditos: lançamentos do histórico de créditos no período e filtros selecionados.
• SLA: fila atual e desempenho histórico da primeira resposta humana.
• Logs: trilha de ações em agentes e bases de conhecimento.

Visão Geral

Os cards mostram:

• Total de Conversas: todas as conversas da organização; o texto menor informa quantas estão atualmente com status ativo.
• Total de Usuários: vínculos da organização que não foram removidos. Atualmente, a contagem também inclui membros sem vaga ativa no plano; confirme assentos em Configurações → Usuários.
• Créditos Consumidos: soma acumulada de credits_used nas conversas, não apenas o mês atual.
• Agentes Ativos: agentes com pelo menos uma conversa entre os 10 agentes devolvidos pelo ranking. Esse card pode subcontar organizações com mais de 10 agentes usados e não deve ser tratado como inventário completo.

O gráfico Conversas por Dia é a única parte desta aba limitada aos últimos 30 dias. Ele conta conversas pela data de criação em UTC e preenche com zero os dias sem novas conversas.

Agentes

A lista mostra até 10 agentes não arquivados, ordenados pelo total acumulado de conversas. Se a organização tiver menos de 10 agentes, podem aparecer agentes com zero conversas. A barra de cada linha é proporcional ao primeiro colocado.

Clique em Detalhes para abrir /admin/analytics/agents/:agentId. O detalhamento começa em 30 dias e permite 7, 30, 90 dias ou período personalizado. Ele reúne:

• cards de conversas, mensagens, créditos e execuções de ferramentas;
• atividade diária;
• uso e erros de ferramentas;
• distribuição por modelo e canal;
• média, cobertura, distribuição e conversas de baixa satisfação.

Um agente arquivado ainda pode ser aberto por URL e recebe o badge Arquivado na página de detalhes, embora não apareça no ranking principal.

Usuários

A aba mostra até 10 membros não removidos, ordenados pelo total acumulado de conversas. Cada linha traz nome, e-mail, conversas e créditos associados a conversas cujo user_id é o daquele membro. Se houver menos de 10 membros, pessoas sem conversas também podem aparecer.

Como a consulta atual não exclui plan_restricted_at, um membro sem vaga ativa no plano pode continuar nesta lista. Use Configurações → Usuários para verificar quem realmente ocupa uma vaga ativa.

Modelos

Esta aba considera apenas mensagens do assistente que tenham um modelo registrado. Os dados são acumulados e não seguem o gráfico de 30 dias da Visão Geral.

Ela contém:

• Total de Mensagens, Modelos Utilizados e Modelo Mais Usado;
• Distribuição por Modelo, com a participação percentual de cada modelo;
• Uso por Modelo, com a quantidade de respostas;
• tabela de Modelo, Mensagens, Tokens (In/Out), Créditos e Créditos por Mensagem.

Mensagens sem identificação de modelo não entram nessa distribuição.

Créditos

Os filtros Agente, Canal, Data Inicial e Data Final atualizam a aba imediatamente. O intervalo inicial vai da data de 30 dias atrás até hoje, inclusive. Não há botão Aplicar.

O seletor de canal oferece Web, Telegram, WhatsApp e Público. Todos os canais mantém os demais canais no resultado, mas o seletor atual não permite isolá-los. Lançamentos sem conversa são agrupados como Web pela consulta.

A aba mostra:

• Total de Créditos: soma absoluta dos lançamentos de credit_usage no filtro;
• Total de Mensagens: apesar do nome e da legenda, conta todos os lançamentos de crédito no período, inclusive operações que não são mensagens, como crawl, automação, pesquisa de contexto e transcrição de reunião;
• Média por Dia: total de créditos dividido pelos dias do intervalo, incluindo dias sem consumo;
• Uso por Dia: quantidade de lançamentos e créditos por data;
• Top Agentes por Consumo: até 10 agentes associados a lançamentos, com quantidade de lançamentos, créditos e canal principal. O canal principal é o que tem mais lançamentos, não necessariamente o de maior custo.

Os totais gerais podem incluir consumo sem agente. Já o ranking ignora lançamentos sem agent_id; por isso, a soma das linhas não precisa coincidir com o card Total de Créditos.

SLA

A aba SLA de atendimento humano separa estado atual de histórico:

• Fila atual ignora o período selecionado e conta ciclos que ainda aguardam primeira resposta humana. Em risco, Atrasadas e Sem responsável são subconjuntos de Total aguardando. Um item entra em risco quando falta até 25% do prazo, respeitando uma janela mínima de 5 minutos.
• os cards Respostas humanas, Dentro do SLA, Tempo médio de resposta e Violações consideram ciclos concluídos cuja primeira resposta humana ocorreu no período escolhido;
• Desempenho por atendente usa o mesmo período e ordena primeiro quem tem mais violações. A tabela mostra respondidas, na meta, violações, cumprimento e tempo médio; também identifica ex-membros ou respostas sem atendente reconhecido.

Use 7, 30, 90 dias ou Personalizado. O período personalizado só é aplicado depois de escolher as duas datas e clicar em Aplicar.

Logs

Logs exige audit_log.view, independentemente de analytics.view. Quem tem somente essa permissão abre diretamente /admin/analytics/logs e vê apenas a aba Logs.

Os filtros disponíveis são:

• Período: últimas 24 horas, 7 dias ou 30 dias;
• Usuário: autor da ação;
• Ação: criação, edição, remoção e vínculos de agentes, ferramentas, categorias e bases;
• Buscar por nome: pesquisa somente o nome da entidade, não o texto completo das alterações.

A tabela mostra Quando, Usuário, Ação e Entidade, em lotes de 50 registros. Clique em uma linha para ver autor, data, valores anteriores e posteriores e metadados disponíveis. O botão Carregar mais atualmente substitui o lote visível pelo próximo, em vez de anexá-lo; registre os dados necessários antes de avançar.

Como investigar um desvio

1. Identifique se a dúvida é acumulada, do período de Créditos, do período de SLA ou dos últimos 30 dias da Visão Geral.
2. Para custo, filtre Créditos primeiro por data e depois por agente. Lembre que “mensagens” nessa aba significa lançamentos do histórico de créditos.
3. Para desempenho de um agente, abra Agentes → Detalhes e escolha o período apropriado.
4. Para atraso humano, compare a Fila atual com o histórico de SLA; a fila não muda quando você troca o período.
5. Para descobrir quem alterou um agente ou uma base, use Logs e abra o detalhe da linha.