Agent não responde corretamente
Diagnóstico quando o agent dá respostas erradas, genéricas ou não encontra informações do seu conteúdo.
Se o agent está respondendo mas as respostas são incorretas, genéricas ou "não encontrei essa informação" quando a informação existe no seu conteúdo, siga este diagnóstico.
Entender como o agent responde
Antes do diagnóstico, é importante saber que o agent não memoriza seu conteúdo — ele busca os trechos mais relevantes em tempo real (RAG) e gera a resposta com base neles.
Quando o agent diz "não encontrei", há duas causas possíveis:
- A informação não está nas fontes indexadas
- A informação está, mas a busca não recuperou o trecho correto
1. Verificar se a informação está indexada
Dashboard → agent → Treinamento → clique na fonte suspeita → Ver chunks.
Busque uma palavra-chave da informação esperada. Se o chunk aparecer, o conteúdo está indexado. Se não aparecer, a fonte não foi indexada corretamente.
Solução: Clique em Reindexar nessa fonte e aguarde a conclusão. Teste novamente.
2. Verificar a qualidade do chunk
Mesmo que o conteúdo esteja indexado, o chunk pode estar mal dividido. Exemplos:
- Tabelas cortadas no meio
- Resposta em páginas diferentes sem conexão semântica
- Cabeçalho sem o conteúdo correspondente
O que você pode fazer:
- Para PDFs com tabelas: reescreva a tabela como lista no campo Texto direto — o agent entende listas melhor que tabelas complexas
- Para sites com conteúdo em múltiplas páginas: adicione cada URL individualmente em vez de crawl de domínio completo
3. A pergunta é muito diferente do conteúdo
O RAG busca por similaridade semântica. Se o usuário pergunta "vocês aceitam PIX?" mas seu conteúdo diz "pagamento via transferência bancária instantânea", a busca pode não encontrar.
Solução: Adicione uma fonte de texto com sinônimos e reformulações:
Meios de pagamento aceitos:
- Cartão de crédito
- PIX (pagamento instantâneo)
- Boleto bancário
- Transferência bancária
4. O agent está "inventando" respostas
Se o agent está respondendo coisas que não estão nas suas fontes, verifique:
Configuração de comportamento: Dashboard → agent → Comportamento → ative "Responder apenas com base nas fontes".
Com essa opção ativa, o agent responde "não tenho essa informação" para perguntas fora do escopo em vez de tentar responder com conhecimento geral.
5. Respostas lentas (mais de 5 segundos)
Latência alta pode indicar:
| Causa | Diagnóstico |
|---|---|
| Muitas fontes para buscar | Mais de 500 chunks no agent → considere separar em 2 agents |
| LLM sobrecarregado | Verifique status.simple-agent.me |
| Conexão do usuário | Teste em rede diferente |
6. Respostas no idioma errado
O agent detecta o idioma da pergunta automaticamente e responde no mesmo idioma, desde que o conteúdo esteja disponível nesse idioma.
Se o usuário pergunta em inglês mas todo o conteúdo está em português, o agent pode misturar idiomas.
Solução:
- Adicione fontes no idioma desejado, ou
- Em Comportamento → Idioma fixo, force um idioma específico
7. O agent não usa informação recente
Se você atualizou o conteúdo do site mas o agent ainda usa a versão antiga:
- Dashboard → Treinamento → selecione a fonte
- Clique em Reindexar agora
- Aguarde o status mudar para
Ativo
O cache de embeddings é limpo a cada reindexação.
Usar o Playground para diagnóstico
O Playground (aba à direita no Agent Builder) é a melhor ferramenta de diagnóstico. Use-o para:
- Replicar a pergunta exata do usuário
- Clicar em Ver fontes usadas na resposta — aparece quais chunks foram usados
- Se os chunks estão corretos mas a resposta está errada, o problema é na geração (ajuste o prompt do sistema)
- Se os chunks estão errados ou ausentes, o problema é na indexação ou na formulação da pergunta
Widget não carrega → · Webhook falhando → · Reindexar fontes →