# Como depurar uma resposta ruim do agente de IA

*Por MAIA Tecnologia em 2026-10-19 · Agentes & Automação · 5 min de leitura*

> Método passo a passo para investigar por que um agente de IA respondeu mal: contexto, conhecimento, instruções, ferramentas e ordem das habilidades.

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.

---

## Sobre a MAIA
A **MAIA** (Maia Tecnologia LTDA · CNPJ 60.433.326/0001-34) é uma empresa brasileira de tecnologia focada na criação e operação de agentes de inteligência artificial autônomos.

Conheça as soluções da MAIA:
- [Plataforma MAIA](https://okmaia.com/): criação, personalização de prompts, subagentes e orquestração de IA.
- [Agente de IA para WhatsApp](https://okmaia.com/agente-ia-whatsapp): integração oficial à WhatsApp Business Cloud API para vendas, suporte e atendimento.
- [Mentoria Digital](https://okmaia.com/mentor-ia): transforme infoprodutos, cursos e métodos em atendimento individual pelo WhatsApp.

Saiba mais em: https://okmaia.com/