A página de análise de Busca Assistiva Eddy AI oferece uma visão completa de como os leitores interagem com a Eddy AI em toda a sua base de conhecimento — acompanhando conversas, volumes de consultas, buscas respondidas e não respondidas, e feedback dos leitores. Use esta página para identificar lacunas de conteúdo, medir a eficácia da busca por IA e tomar ações direcionadas para melhorar a cobertura da sua documentação.
Para saber mais sobre os idiomas suportados pelo Eddy AI, clique aqui.
Por que usar a análise de busca da Eddy AI
Use a página de análise de busca da Eddy AI quando quiser:
- Identifique perguntas sem resposta — encontre tópicos que seus leitores procuram, mas não conseguem responder, sinalizando lacunas de conteúdo.
- Monitore o desempenho das buscas por IA — acompanhe tendências de consultas respondidas versus não respondidas ao longo do tempo para avaliar o quão bem o Eddy AI atende seus leitores.
- Audite o feedback dos leitores — revise gostos, desgostos e comentários de feedback para avaliar a qualidade e relevância das respostas geradas por IA.
- Investigue conversas individuais — analise interações específicas com usuários para validar a precisão das citações e a qualidade da resposta.
Antes de começar
Você deve ter acesso administrativo, proprietário ou personalizado ao portal da Base de Conhecimento.
Como acessar análises de busca da Eddy AI
- Navegue até Analytics () na barra de navegação da esquerda no portal da Base de Conhecimento.
- No painel de navegação esquerdo, clique em Eddy AI. A página Eddy AI - Busca Assistiva aparece.
- Por padrão, os dados do mês atual são exibidos.
.png)
Uso de filtros para personalizar os dados
Por padrão, a página mostra métricas do mês atual. Para ajustar o período ou escopo:
- Clique no menu suspenso do filtro Mês .
- Escolha um intervalo pré-definido (Este mês, Mês Passado) ou selecione Personalizado para especificar um mês específico. Ao usar o filtro Customizado , você pode selecionar apenas o mês no calendário.
- Clique em Filtrar para restringir os resultados por tipo de aplicação: Todos, Site da base de conhecimento, Widgets da base de conhecimento, Chatbot, API pública ou extensões como Freshdesk ou Zendesk.
Entendendo a página de análise
Peças métricas
O topo da página exibe as seguintes métricas de desempenho como blocos:
| Campo | Descrição |
|---|---|
| Conversas totais | Número total de conversas no Eddy AI, onde uma ou mais consultas contam como uma conversa. Disponível apenas no site KB 2.0. Uma única mensagem também é contada como uma conversa. |
| Total de consultas | Contagem total de perguntas individuais feitas ao Eddy AI. Dúvidas são perguntas individuais dentro de uma conversa. |
| Respostas às perguntas | Número total de consultas que retornaram um resultado. |
| Perguntas sem resposta | Número total de consultas que não produziram resultados. |
| Curtidas totais | Número total de curtidas recebidas nas respostas de busca, indicando uma resposta satisfatória. |
| Total desgostos | Número total de desgostos recebidos, indicando uma resposta insatisfatória. Os motivos de não gostar incluem: conteúdo difícil de entender, impreciso ou irrelevante, fontes/referências/citações incorretas, informações ausentes, não gostar do estilo e outros (com comentário em texto livre). |
| Feedback total | Número total de comentários de feedback recebidos para respostas de busca assistiva por IA. |
Se múltiplos chatbots forem implantados, os dados de todas as instâncias de chatbot são fundidos em um único conjunto de resultados. Da mesma forma, os dados de todas as instâncias dos widgets da base de conhecimento são combinados.
Análise de consultas
O gráfico de análise de consultas permite que você explore o desempenho das consultas ao longo do tempo. Você pode interagir com ele usando as abas no topo:
- O eixo horizontal exibe datas com base no filtro de Mês selecionado.
- Tudo — veja a comparação de perguntas respondidas, não respondidas e conversas em um único gráfico.
- Respondido — visualize consultas que retornaram um resultado.
- Sem resposta — visualize consultas que não produziram nenhum resultado.
- Curtidas — veja curtidas recebidas nas respostas de busca.
- Não curtidas — veja as descurtidas recebidas nas respostas de busca.
- Feedback — veja os comentários recebidos nas respostas de busca.
- Conversas — veja tendências de conversa. Disponível apenas para projetos KB site 2.0 .
- Passe o mouse sobre o gráfico para ver métricas de uma data específica.
- Exportar imagem — baixe o gráfico de análise de consultas como um arquivo .png.
Mantenha as buscas por Respostas o mais baixas possível em relação às buscas por Respostas . Buscas não respondidas normalmente ocorrem quando informações relevantes estão faltando na sua documentação. Manter o conteúdo atualizado ajuda a reduzir esses casos.
Métricas de profundidade de conversa
O gráfico de métricas de profundidade da Conversa está disponível apenas para projetos do site 2.0 da KB . Ele mostra a distribuição de consultas por conversa junto com o número total de conversas.
- Passe o mouse sobre cada barra para ver a contagem exata das conversas. O gráfico acompanha conversas de 1 a 5 consultas, com qualquer coisa além de 5 consultas agrupada como 6+.
- Clique no ícone Exportar imagem () para baixar o gráfico como um arquivo .png.
Gráfico de retroalimentação
O gráfico de feedback mostra a distribuição dos desgostos por razão, junto com as contagens para cada categoria. Use este gráfico para identificar quais aspectos das respostas da IA Eddy os leitores consideram mais insatisfatórios.
Consultas populares
Esta seção mostra os cinco principais temas de busca para o mês selecionado, agrupados por palavras-chave. Ele destaca os temas que os leitores mais procuram e com que frequência cada tema aparece.
Consultas populares são geradas apenas quando há pelo menos um mês completo de dados disponível.
Perguntas sem resposta
Esta seção mostra os cinco principais temas de busca do mês selecionado em que a Eddy AI não conseguiu retornar um resultado. Esses temas destacam as lacunas de conteúdo mais comuns na sua base de conhecimento.
O pós-processamento de consultas ocorre mensalmente ao longo de 30 dias de dados. Os dados são enviados para a OpenAI, que identifica as palavras-chave mais comuns e as agrupa em até 10 tópicos principais. Consultas que não se encaixam em um tema são agrupadas sob "Outros."
Artigos mais referenciados
Esta seção lista os cinco artigos mais frequentemente citados pela Eddy AI nos resultados de busca do mês selecionado, junto com a contagem de citações de cada um.
Passe o mouse sobre o título de um artigo e clique em Visualizar na Base de Conhecimento () para abrir o artigo no site da Base de Conhecimento.
Conversas
A seção Conversas oferece uma visão detalhada e tabular de cada interação do usuário — incluindo a consulta completa, status da resposta e qualquer feedback recebido.
A tabela inclui as seguintes colunas e controles:
a. Campo de busca — insira uma palavra-chave ou frase para encontrar uma conversa ou pergunta específica.
b. Conversas — exibe a primeira pergunta de cada conversa; Perguntas subsequentes são colapsadas por padrão. Expanda uma linha para ver todas as perguntas ou clique em uma consulta para abrir um painel lateral mostrando a conversa completa, informações do usuário (se disponíveis), grupo de usuários e a data e hora da interação.
Se uma conversa começou em um mês anterior e continua no mês atual, ela é atribuída ao mês em que começou.
c. Tema de consulta — tópicos são atribuídos a partir da lista de consultas populares. São necessários pelo menos 30 dias de dados para gerar um tópico de consulta. Apenas os 5 temas mais populares são exibidos.
d. Resposta — indica se a pergunta foi respondida () ou não respondida ().
e. Ícone de feedback — mostra se o feedback foi um tipo de gosto () ou não gostar ().
f. Feedback — exibe uma tag de feedback se a consulta recebeu feedback. Clique para navegar até o gerenciador de feedback da Eddy AI para ver todos os detalhes do feedback.
g. Informações do usuário — para projetos mistos e privados , exibe o nome ou endereço de e-mail do usuário que enviou a consulta (quando disponível). Para usuários do JWT sem nome, o endereço de e-mail associado é mostrado, se disponível.
h. Grupo de usuários — exibe o grupo de leitores ou grupo de usuários associado ao usuário, se aplicável.
i. Filtrar — filtrar conversas por:
- Estado da resposta: Todos, Respondidos ou Não Respondidos.
- Feedback: Todos, nenhum, gostem ou não gostem. Isso abrange o feedback recebido sobre respostas da Eddy AI do site da base de conhecimento, widget, chatbot e API pública.
- Tema da consulta: Filtra consultas dos meses anteriores (indisponíveis para o mês atual). As opções incluem Selecionar todas (exibe tanto cinco consultas populares quanto cinco sem resposta), Consultas populares e Consultas não respondidas.
j. Exportar CSV — baixar os dados filtrados da conversa como um arquivo .csv. Clique no ícone Download () para recuperar o último conjunto de arquivos exportados.
Quando a configuração de informações do leitor Anonimizar está ativada, as informações identificáveis pelo leitor vinculadas às conversas da IA do Eddy são anonimizadas. Nomes de usuário, endereços de e-mail e IDs de leitor não aparecerão em análises ou exportações.
Visualizando artigos fonte de IA Eddy
Quando você expande uma consulta na seção Conversas , a resposta exibe citações numeradas (por exemplo, 1 2 3) no final. Ao passar o mouse sobre um número de citação, aparece o título do artigo; clicar nele abre o artigo fonte no site da Knowledge Base.
Isso permite validar rapidamente as fontes que a Eddy AI usou para gerar uma resposta e identificar conteúdos que podem precisar ser atualizados. Links de citação sempre apontam para a versão mais recente publicada do artigo original. Se o artigo já foi excluído, o link exibirá uma página com Erro 404 .
Detalhes das citações não estão disponíveis na OpenAPI nem na documentação da API. Eles só são acessíveis pelo portal da base de conhecimento ou pelo site da base de conhecimento.
Entendendo o uso e análises de crédito por IA
Em alguns casos, a contagem de consultas mostrada nas análises de busca do Eddy AI pode diferir dos créditos de uso consumidos pelo recurso Eddy AI. Isso pode acontecer por dois motivos:
-
Projetos multilíngues — se seu projeto suporta múltiplos idiomas (por exemplo, inglês e alemão), os créditos são consumidos em todos os idiomas. No entanto, a visualização de Análise para um único idioma mostra apenas consultas feitas nesse idioma, que podem parecer menores que o uso total de crédito.
-
Interações não cobráveis — saudações simples como "Oi" ou "Olá" são registradas no Analytics para maior completude, mas não consomem créditos. Como resultado, a contagem de consultas no Analytics pode ser um pouco maior do que o número de créditos utilizados.
Se você atingir o limite de uso, entre em contato com o suporte para atualizar ou verificar seus dados detalhados de uso.
Melhores práticas
- Revise as consultas não respondidas mensalmente — use a seção Consultas Não Respondidas para identificar lacunas recorrentes de conteúdo e atualizar ou criar artigos para resolvê-las.
- Aja com base no feedback de não gostar — confira regularmente o gráfico de feedback. Respostas marcadas como "imprecisas" ou "informações faltantes" são os itens de maior sinal a serem investigados.
- Cruze os artigos mais referenciados — esses artigos têm o maior peso nas respostas de IA Eddy. Certifique-se de que sejam precisos, atualizados e completos.
- Use a tabela de Conversas para validar citações — expanda as consultas individuais para confirmar que os artigos de origem estão corretos e atualizados. Artigos de fonte excluídos resultam em links de citação quebrados.
FAQ
Por que não consigo filtrar os dados semanalmente?
Consultas populares e palavras-chave de busca sem resposta são derivadas de métodos algorítmicos de agrupamento que exigem pelo menos 30 dias de dados para categorizar as palavras-chave com base na frequência de resposta. A filtragem semanal não é suportada porque o conjunto de dados é pequeno demais para agrupamento preciso.
Como resolvo consultas para as quais não é gerada resposta?
Revise as palavras-chave listadas na seção Perguntas Não Respondidas. Use essas palavras-chave para identificar artigos relevantes e atualizar ou criar conteúdo que aborde diretamente o tema. Você também pode usar o gerenciador de feedback da IA Eddy para acompanhar o feedback das perguntas não respondidas até a resolução.
Como funciona a análise de conversas com IA do Eddy quando uma conversa abrange vários idiomas?
A conversa é registrada na tabela de conversas para cada idioma utilizado. No entanto, métricas específicas como buscas totais, consultas respondidas, consultas não respondidas e feedback são atualizadas apenas para o idioma em que cada interação ocorreu.
Como funciona a análise de conversas com IA do Eddy quando uma conversa abrange vários espaços de trabalho?
A conversa é registrada na tabela de conversas de cada espaço de trabalho utilizado. Métricas específicas, como buscas totais, consultas respondidas, consultas não respondidas e feedback, são atualizadas apenas para os idiomas usados dentro do respectivo espaço de trabalho.
Como as consultas são diferentes das conversas?
Uma consulta é uma pergunta individual feita ao Eddy AI. Uma conversa é uma sessão que contém uma ou mais dúvidas. Por exemplo, um leitor fazendo três perguntas de acompanhamento em uma única sessão conta como uma conversa com três perguntas.