Painel administrativo → Análises — uso, custo e tráfego da sua base de conhecimento. Esta seção está disponível apenas para as funções Admin e Owner e é dividida em cinco abas: Dashboard, Histórico de pesquisa, Tokens, Tráfego, Feedback.
A seleção de período (Hoje / 7 dias / 30 dias / 90 dias) está disponível nas abas Dashboard, Tokens e Feedback. O Histórico de pesquisa usa um intervalo de datas arbitrário, e o Tráfego usa 30 dias fixos.
#Dashboard
Três gráficos para o período selecionado:
- Consultas e qualidade — quantas consultas de pesquisa os usuários enviaram durante o período (pelo portal de pesquisa, widget, API ou modo de pesquisa por IA) e a pontuação média de qualidade das respostas produzidas.
- Distribuição de qualidade — um gráfico de pizza: um detalhamento da métrica "Qualidade" do primeiro gráfico — como as respostas se distribuíram pelos níveis de qualidade.
- Fontes das respostas — um gráfico de pizza: a partir de que as respostas foram construídas (os tipos estão na tabela abaixo).
A legenda é interativa. Clicar em um item da legenda sob qualquer gráfico ativa ou desativa aquela série de dados no gráfico — por exemplo, para ocultar o cache e ver apenas as respostas geradas.
#Tipos de resposta (fonte)
| Tipo | O que significa |
|---|---|
| AI-generated (LLM) | Uma resposta nova gerada pela IA com base nos seus artigos. |
| Cache (CACHE_HIT) | A resposta foi servida do cache — esta pergunta ou uma semelhante já foi feita antes e a resposta foi salva. É retornada instantaneamente e não gasta tokens. |
| Technical answer (fallback) | A IA não conseguiu produzir uma resposta de qualidade a partir dos seus artigos: ou nenhuma informação relevante foi encontrada, ou o serviço de IA estava temporariamente indisponível. Em vez de gerar uma, o sistema retornou uma resposta técnica preparada. |
| Erro | A consulta não pôde ser processada por um motivo técnico: a base ainda não está indexada ou a indexação está em andamento, ocorreu um erro de índice, ou a consulta foi bloqueada por um filtro (entrada sem sentido). A indisponibilidade da IA não se enquadra aqui — esse caso vai para "Technical answer". |
#Histórico de pesquisa
Uma lista cronológica de todas as consultas. Filtros: pesquisa pelo texto da pergunta, intervalo de datas (de / até), idioma, tipo de resposta. O botão CSV — exportar para um arquivo.
Colunas da tabela:
| Coluna | O que mostra |
|---|---|
| Pergunta | O texto da consulta do usuário |
| Idioma | O idioma da consulta |
| Tipo | Tipo de resposta: AI-generated / CACHE_HIT / Technical / Erro |
| Cache | HIT — resposta do cache, MISS — gerada de novo |
| Qualidade | A pontuação de qualidade da resposta em % (para respostas em cache — um traço) |
| Tokens | Quantos tokens a resposta consumiu (para cache — um traço) |
| Latência | O tempo para produzir a resposta, ms |
| País | O país da consulta (por geolocalização) |
| Data | Quando a consulta foi enviada |
#Tokens
Consumo de tokens de IA no período. Seis métricas: Total de consultas, Total de tokens, Tokens (entrada), Tokens (saída), Tokens de indexação (embedding ao indexar artigos), Média por consulta.
O que são tokens. Um token é a unidade que os modelos de IA usam para medir a quantidade de texto (aproximadamente ¾ de uma palavra, ou ~4 caracteres). O consumo do LLM é contado em tokens: para a entrada (sua pergunta + os fragmentos de artigo passados ao modelo) e para a saída (a resposta gerada). Os tokens de indexação são gastos uma vez — quando um artigo é criado ou alterado e convertido em uma representação vetorial (embedding) para a pesquisa. O seu plano inclui um limite mensal de tokens, e esta aba mostra exatamente esse consumo.
O gráfico "Consumo de tokens" tem três séries: Tokens/dia (barras), Total acumulado (linha) e Limite do plano (tracejada). A legenda é interativa — uma série pode ser ocultada ao clicar. Abaixo estão dois detalhamentos:
- Por tipo de resultado — AI-generated / CACHE_HIT / Technical.
- Por tipo de IA — pesquisa, editor, geração, chat, sistema, indexação (embedding).
#Tráfego
Dados de 30 dias. Três métricas: Total de consultas, Países, Idiomas. Abaixo estão listas com participações:
- Por país — distribuição das consultas por geografia.
- Por idioma — distribuição por idioma da consulta.
- Por tipo de resultado — AI-generated / Technical answer / CACHE_HIT.
- Consultas populares — as perguntas mais frequentes do período com o número de ocorrências (por exemplo, "como criar um novo artigo · 4×").
#Feedback
Avaliações "Este artigo foi útil?" dos usuários no período. Três métricas: Total de respostas, Positivas (%), Negativas. Abaixo estão um gráfico por dia, um detalhamento dos motivos do feedback negativo e uma lista de artigos com feedback negativo (o link leva ao editor do artigo). Enquanto não houver avaliações, a seção mostra "Ainda não há feedback".