Como depurar uma resposta ruim do agente de IA

Mais cedo ou mais tarde, um cliente vai receber uma resposta estranha. O agente pode ter inventado uma informação, ignorado uma regra, respondido fora do tom ou deixado de usar uma ferramenta. A tentação é reescrever as instruções inteiras, mas isso costuma piorar o problema. O caminho mais eficaz é investigar com método. Neste artigo, você entenderá um roteiro para diagnosticar respostas ruins e corrigir a causa certa. --- ## 1. Reconstrua a situação Antes de mexer em qualquer coisa, entenda o que aconteceu: - Leia a conversa completa, e não apenas a mensagem problemática. - Identifique o que o cliente pediu e o que o agente respondeu. - Verifique o canal, o horário e se havia dados do contato disponíveis. Muitas respostas aparentemente erradas fazem sentido quando se vê o contexto que o agente tinha. --- ## 2. Classifique o tipo de problema - **Informação incorreta:** o conteúdo da resposta estava errado. - **Informação ausente:** o agente não sabia e não admitiu. - **Comportamento fora das regras:** respondeu algo que não deveria. - **Tom inadequado:** longo demais, informal demais ou frio. - **Ferramenta não usada ou mal usada:** deveria ter consultado um sistema e não consultou. - **Resposta incompleta ou parcial:** parou antes de concluir. --- ## 3. Investigue as causas mais prováveis 1. **Base de conhecimento:** a informação existe? Está atualizada? Há contradição entre documentos? 2. **Instruções:** a regra está escrita? É clara? Existe outra regra que conflita? 3. **Habilidades e ordem de execução:** a habilidade certa foi acionada? Rodou antes ou depois do que deveria? Quando uma habilidade depende do resultado de outra, o consumo está configurado? 4. **Ferramentas:** o servidor estava disponível? O limite de chamadas foi atingido antes de concluir? 5. **Contexto do contato:** o histórico ou os dados do cliente influenciaram a resposta? --- ## 4. Corrija a causa, não o sintoma - Se faltava informação, atualize a base e não o prompt. - Se a regra era ambígua, reescreva com clareza. - Se havia conflito, remova a duplicidade. - Se a ferramenta falhava, trate o erro nas instruções e avise o cliente. Mudanças pequenas e pontuais são mais fáceis de avaliar. --- ## 5. Reproduza e valide Repita a pergunta, com variações, em um contato de teste. Confirme que a resposta melhorou e que outros comportamentos não foram afetados. Se necessário, reinicie o contato de teste para simular um cliente novo. --- ## 6. Registre o aprendizado Anote o caso, a causa e a correção. Padrões recorrentes revelam melhorias estruturais, como seções do conhecimento que precisam ser reescritas ou regras que merecem mais destaque. --- ## Conclusão Depurar um agente é investigar contexto, conteúdo, instruções, habilidades e ferramentas, nessa ordem de probabilidade. Com método e correções cirúrgicas, cada resposta ruim vira uma oportunidade concreta de melhorar o atendimento.