A página de análise de Busca Assistiva do Eddy AI oferece uma visão completa de como os leitores interagem com o 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 pela 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.
A análise avançada de IA do Eddy adiciona análise de escopo de consulta não respondida, tópicos, taxonomia, utilização de conteúdo e decomposição dos tipos de consulta. Se a opção Tente a nova análise de IA do Eddy estiver disponível para o seu projeto, leia análises avançadas de IA Eddy. Para verificar a disponibilidade do seu projeto, entre em contato com seu Gerente de Sucesso do Cliente ou o suporte do Document360.
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.
Acesse a análise de busca por IA do Eddy
- Navegue até Analytics () na barra de navegação da esquerda no portal da Base de Conhecimento.
- No painel de navegação à esquerda, 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)
Clique em Tentar novas análises de IA do Eddy para acessar as novas análises avançadas da IA do Eddy.
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 de tempo 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 Personalizado , você pode selecionar apenas o mês do 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 conversa. |
| Total de consultas | Contagem total de perguntas individuais feitas ao Eddy AI. Consultas 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 de 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 da consulta 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 não respondidas o mais baixas possível em relação às buscas respondidas . 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 de conversas está disponível apenas para projetos KB site 2.0 . 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 de 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 contagens para cada categoria. Use este gráfico para identificar quais aspectos das respostas do Eddy AI os leitores acham mais insatisfatórios.
Consultas populares
Esta seção mostra os cinco principais temas de busca para o mês selecionado, agrupados por palavras-chave. Ela destaca os tópicos que os leitores pesquisam com mais frequência 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; as perguntas subsequentes são dobradas 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. Tópico de consulta — os 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 tópicos 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, Gostam ou Não Gostam. Isso abrange o feedback recebido sobre respostas da IA Eddy 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 de 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. Passar o mouse sobre um número de citação revela o título do artigo; clicar nele abre o artigo fonte no site da Base de Conhecimento.
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 fonte. Se o artigo tiver sido excluído desde então, o link exibirá uma página de Erro 404 .
Os detalhes das citações não estão disponíveis na OpenAPI ou na documentação da API. Eles só são acessíveis pelo portal da base de conhecimento ou pelo site da base de conhecimento.
Análises avançadas de IA em Eddy
A análise avançada de Eddy AI amplia a experiência de análise de Eddy AI com análises mais profundas de como os leitores usam a Eddy AI e onde ela falha. Além do volume de consultas e feedback, ela agrupa as consultas em tópicos, classifica as perguntas não respondidas conforme se sua documentação deveria cobri-las e mostra quanto do seu conteúdo a Eddy AI utiliza ao gerar respostas.
Análises avançadas de Eddy AI estão disponíveis para planos selecionados e devem ser ativadas para o seu projeto. Se você não vir a opção Tentar nova análise de Eddy AI na página de análise de Pesquisa Assistiva do Eddy AI, entre em contato com seu Gerente de Sucesso do Cliente ou o suporte do Document360 para verificar a disponibilidade do seu projeto.
O que você pode analisar
Use análises avançadas de IA Eddy para responder perguntas como:
- Das dúvidas que a Eddy AI não conseguiu responder, quantas estavam no escopo, ou seja, perguntas que sua documentação deveria cobrir?
- Quais temas os leitores estão mais perguntando e quais estão falhando?
- Que tipos de mensagens os leitores enviam: perguntas, declarações, solicitações de solução de problemas ou comandos?
- Quanto do seu conteúdo publicado o Eddy AI realmente se baseia, e quais artigos ele cita com mais frequência?
Abra a página de análises avançadas
- Navegue até Analytics () > Eddy AI no portal da base de conhecimento.
- Clique em Tentar novas análises da Eddy AI. A página de análises avançadas aparece, com três abas a: Análise de consultas, Utilização de conteúdo e Interação do Usuário.
- Por padrão, os dados do mês passado são exibidos. Use o seletor de meses no cabeçalho da página para selecionar um mês diferente do calendário.
.png)
Abra a página de análises avançadas na opção Tentar nova análise de IA do Eddy a cada vez. Selecione Voltar para a análise clássica.
Análise de consultas
A aba de análise de consultas mostra quantas consultas a Eddy AI respondeu, quantas não respondeu e sobre o que os leitores estavam perguntando.
Peças métricas
O topo da aba mostra as seguintes métricas como peças. Cada peça também mostra a mudança em relação ao mês anterior e um indicador de tendência.
| Campo | Descrição |
|---|---|
| Total de consultas | Contagem total de perguntas individuais feitas ao Eddy AI. Consultas 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 nenhum resultado. |
| Conversas totais | Número total de conversas no Eddy AI, onde uma ou mais consultas contam como uma conversa. |
Análise da consulta não respondida
Dúvidas não respondidas são classificadas conforme se sua documentação era considerada responsável. Clique em Ver detalhes para expandir a divisão.
| Campo | Descrição |
|---|---|
| No escopo | Dúvidas sobre temas que sua documentação deve abordar. Priorize essas questões ao abordar lacunas de conteúdo. |
| Fora do escopo | Consultas sobre temas fora do escopo da sua base de conhecimento. |
| Escopo incerto | Consultas que não poderiam ser classificadas com confiança como dentro do escopo ou fora do escopo. |
Tendência de consulta
O gráfico de tendência de consultas apresenta quatro séries dia a dia ao longo do mês: consultas, dúvidas respondidas, perguntas não respondidas e conversas.
.png)
Cartões temáticos
| Campo | Descrição |
|---|---|
| Respostas às perguntas | Os tópicos com o maior número de perguntas respondidas, com uma contagem para cada um. |
| Perguntas sem resposta | Os tópicos com o maior número de perguntas não respondidas dentro do escopo, com uma contagem para cada um. Essas são suas lacunas de conteúdo mais claras. |
Conversas
A seção Conversas lista consultas individuais em três sub-abas, cada uma agrupando-as de forma diferente.
| Sub-aba | Descrição |
|---|---|
| Todas as consultas | Cada consulta, com seu status de resposta e quaisquer curtidas ou desgostos recebidos. Use a opção Filtros para filtrar por status de resposta (Todos, Respondidos, Não Respondidos) e feedback (Todos, Curtidos, Não Curtidos, Sem feedback). |
| Tópicos | Consultas agrupadas em tópicos, grupos de perguntas relacionadas que compartilham um tópico comum. Cada linha exibe o nome do cluster, se o cluster foi respondido ou não respondido, e o número de perguntas que contém. Expanda uma linha para visualizar as perguntas individuais e clique em Mostrar mais para ver além das cinco primeiras. Use o menu suspenso de Todos os tópicos para filtrar por Todos os tópicos, Respondidos, Dentro do escopo ou Fora do escopo. |
| Taxonomia | Tópicos agrupados em uma taxonomia, uma área temática mais ampla que contém múltiplos tópicos. Cada linha exibe o nome da taxonomia, o número de tópicos e o número de perguntas. Clique em Visualizar para abrir uma lista dos tópicos dentro daquela taxonomia e suas contagens de perguntas. |
.png)
Utilização de conteúdo
A aba de utilização de conteúdo mostra quanto da sua base de conhecimento a Eddy AI usa ao gerar respostas.
| Campo | Descrição |
|---|---|
| Conteúdo usado pela Eddy AI | A porcentagem do seu conteúdo publicado que a Eddy AI usou ao gerar respostas. |
| Artigo citado por Eddy AI | O número de artigos que a Eddy AI citou em suas respostas. |
| Artigos lidos por Eddy AI | O número de artigos que a Eddy AI mencionou ao gerar respostas. |
| Taxa de utilização de conteúdo | Um gráfico mostrando a porcentagem acumulada de conteúdo usado ao longo do mês. |
| Uso de conteúdo por IA Eddy | Uma tabela listando cada artigo, o número de vezes que a Eddy AI o utilizou (Ocorrência) e sua taxa de ocorrência em porcentagem. A tabela exibe até 20 artigos. |
Use esta aba para identificar os artigos que têm mais peso nas respostas da Eddy AI e para identificar conteúdos que a Eddy AI nunca utiliza.
.png)
Interação do usuário
A aba de interação do usuário mostra que tipo de mensagens os leitores enviam para a Eddy AI e como avaliam as respostas.
| Campo | Descrição |
|---|---|
| Total de consultas | Contagem total de perguntas individuais feitas ao Eddy AI. |
| Curtidas totais | Número total de curtidas recebidas nas respostas do Eddy AI. |
| Total desgostos | Número total de dislikes recebidos nas respostas do Eddy AI. |
| Distribuição de tipos de consulta | Um gráfico mostrando como as consultas são distribuídas em quatro tipos de mensagens. Clique em um tipo de consulta para filtrar a tabela de Consultas . |
| Consultas | Uma tabela listando as consultas individuais para o tipo de mensagem selecionado. O título mostra o tipo de consulta e sua contagem total. |
As consultas são classificadas nos seguintes tipos de mensagem:
| Tipo de mensagem | Descrição |
|---|---|
| Perguntas | Mensagens formuladas como uma pergunta direta, como "Como eu publico um artigo?" |
| Declarações | Mensagens formuladas como uma afirmação em vez de uma pergunta, como "O botão de publicar está faltando." |
| Solução de problemas | Mensagens relatando um problema ou perguntando como resolver um erro. |
| Comandos | Mensagens formuladas como uma instrução, como "Mostre-me a referência da API." |
.png)
Filtros e navegação
- Mês — os dados são mostrados para um mês inteiro de cada vez. Mudar o mês atualiza todos os quadros da página.
- Versão e idioma do workspace — os dados são direcionados para a versão do workspace e o idioma selecionados na barra superior. Mudar qualquer um deles atualiza todos os painéis da página.
- Paginação — as tabelas exibem 10 linhas por página. Mudar o mês, versão, idioma ou um filtro retorna cada tabela à primeira página.
Coisas para saber
- Todos os dados desta página são exibidos em UTC, não no seu fuso horário local.
- Os dados estão disponíveis apenas para meses inteiros do calendário. Intervalos de datas semanais e personalizados não são suportados.
- Os dados de análise avançada são processados mensalmente. Se o processamento do mês selecionado ainda não estiver concluído, os painéis exibem 0 e nenhum dado disponível.
- Os tiles e gráficos atualizam periodicamente, então podem mostrar valores mais baixos que as tabelas abaixo deles. Se isso acontecer, verifique novamente mais tarde no dia.
- Exportar gráficos e tabelas da página de análises avançadas ainda não está disponível. Para exportar dados de conversa, use o Export CSV na página de análise de Busca Assistiva da Eddy AI .
- Um projeto recém-criado ou copiado não possui dados analíticos avançados até que o primeiro processamento mensal desse projeto seja concluído.
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 Analytics para um único idioma mostra apenas consultas feitas nesse idioma, que podem parecer menores que o uso total de créditos.
- Interações não cobráveis - cumprimentos simples como "Oi" ou "Olá" são registrados 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 dúvidas 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 o quadro de feedback regularmente. Respostas marcadas como "imprecisas" ou "informações faltantes" são os itens mais sinalizáveis a serem investigados.
- Cruze referências dos artigos mais referenciados - esses artigos têm o maior peso nas respostas de IA Eddy. Garanta que sejam precisos, atualizados e abrangentes.
- Use a tabela de Conversas para validar citações - expanda consultas individuais para confirmar que os artigos fonte estão corretos e atualizados. Artigos de fonte excluídos resultam em links de citação quebrados.
- Comece com dúvidas não respondidas dentro do escopo – se análises avançadas de IA Eddy estiverem disponíveis para o seu projeto, trabalhe primeiro pelos tópicos não respondidos dentro do escopo. Eles representam perguntas que sua documentação deveria responder.
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. 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 Eddy AI 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 para 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 à Eddy AI. Uma conversa é uma sessão que contém uma ou mais consultas. Por exemplo, um leitor fazendo três perguntas de acompanhamento em uma única sessão conta como uma conversa com três consultas.
Por que não vejo a opção Tentar nova análise de IA do Eddy?
A disponibilidade depende do seu plano, e o recurso deve estar ativado para o seu projeto. Também confirme que você tem acesso à análise — você precisa de acesso de administrador ou proprietário, ou de uma função personalizada com permissão de visualização de análise. Para verificar a disponibilidade do seu projeto, entre em contato com seu Gerente de Sucesso do Cliente ou o suporte da Document360.
Por que os tiles na página de análise avançada mostram 0 quando as tabelas abaixo mostram dados?
Os tiles e gráficos na página de análises avançadas atualizam periodicamente, enquanto as tabelas leem os dados processados mais recentes. Se os tiles mostrarem 0 e as tabelas mostrarem resultados, os valores dos tiles ainda não foram atualizados. Verifique novamente mais tarde no dia.
Posso abrir a página de análises avançadas diretamente usando a URL dela?
Não. Abra a página de análises avançadas na opção Experimentar nova análise de Eddy AI na página de análise de Busca Assistiva Eddy AI a cada vez. Digitar a URL diretamente ou atualizar a página no seu navegador retorna à página de análise de Pesquisa Assistiva do Eddy AI .