Raio-X das respostas#
Com um bot simples, o log de erro resolve. Este bot deixou de ser simples: uma resposta pode ter sido decidida pelo grafo de conhecimento, pela busca vetorial, pela textual, pelo NLP, por uma entrada que o autoaprendizado gravou sozinho, ou por uma intenção promovida ao NLP dias atrás.
Cada camada registrava a sua parte, e nenhuma compartilhava um fio com as outras — "por que ele respondeu isso?" virava arqueologia de log.
O que a tela mostra#
Cada mensagem tem um identificador, e a linha do tempo mostra tudo que decidiu a resposta:
- Quais fontes o modelo leu e de qual busca elas vieram.
- Qual camada respondeu — Atendente IA, base de conhecimento, intenções ou fallback.
- Quanto demorou.
- Quantos tokens custou.
- Qual ferramenta rodou, quando houve consulta ao ERP.
Quando usar#
A IA respondeu errado. O raio-x diz se ela leu a entrada errada da base, se não achou nada e improvisou, ou se leu a entrada certa e mesmo assim errou. As três causas pedem correções diferentes.
A IA não usou uma entrada que existe. Aqui você vê exatamente quais trechos foram para o modelo. Se a entrada certa não está entre eles, o problema é a busca — as palavras da pergunta não casam com as da entrada.
Uma resposta demorou muito. O tempo aparece por etapa.
O consumo subiu. Dá para ver quais respostas custaram mais.
Como ler as camadas#
| Camada | O que significa |
|---|---|
| Atendente IA | O modelo externo redigiu a resposta — custou token |
| Base de conhecimento | Respondida localmente por similaridade — custo zero |
| Intenções (NLP) | Reconhecida localmente — custo zero |
| Fallback | Ninguém soube responder |
Uma proporção alta das duas do meio é boa notícia: significa que a base está bem alimentada e o autoaprendizado está funcionando.
Fallback frequente é a sua lista de trabalho — veja Perguntas sem resposta.
Como fazer#
- Vá em Configurações → Raio-X das respostas.
- Localize a mensagem — pelo atendimento, ou pelo período.
- Abra a linha do tempo daquela resposta.
- Confira as fontes lidas.
- Corrija onde o raio-x apontou: na base, nas variações da entrada, ou nos limites do agente.
Se algo der errado#
A resposta não aparece no raio-x. Ela pode ser anterior à versão que passou a registrar isso.
A entrada certa está entre as fontes lidas e a resposta ainda assim está errada. O problema é a redação da entrada, ou a persona autorizando improviso. Veja Agentes.
Nenhuma fonte foi lida. A busca não encontrou nada. Acrescente as variações que o cliente usa de verdade à entrada da base.
A ferramenta de ERP falhou. O raio-x mostra isso; o conserto está em Consultar o ERP dentro do fluxo.