O agente de IA não responde
Sintoma: o agente do Brain está criado, a caixa está conectada, e mesmo assim o cliente não recebe resposta. Esta página segue a ordem do mais comum pro mais raro.
Diagnóstico rápido
Seção intitulada “Diagnóstico rápido”| Sintoma | Causa provável | Onde olhar |
|---|---|---|
| Não responde em caixa nenhuma | Status em Rascunho, Em teste ou Pausado | Operação |
| Não responde só numa caixa | Caixa não marcada no agente | Operação › Caixas |
| Parou de responder no meio da conversa | Alguém respondeu, ou o bot foi desligado ali | Botão do bot na conversa |
| Para de responder sempre na mesma altura | Limite de respostas por hora | Operação › Regras & ciclo |
| Parou pra conta inteira, do nada | Orçamento estourado com “pausar assistentes” | Brain › Configurações › Orçamento & uso |
| Responde fora do assunto ou inventa | Falta base, falta ferramenta ou roteiro vago | Cérebro e Ferramentas |
| Demora muito | Modelo pesado ou consulta trazendo trecho demais | Brain › Configurações › Provedores & modelos |
1. Qual é o status do agente?
Seção intitulada “1. Qual é o status do agente?”Em Brain › Agentes, olhe o status. São quatro:
- Rascunho não responde ninguém.
- Em teste responde só nas conversas de teste listadas por ID. É a pegadinha mais comum: o agente parece no ar e não está.
- Ativo atende normalmente.
- Pausado está fora do ar.
Confira também o Pausar todos da lista de agentes. Ele tira a frota inteira do ar de uma vez.
2. A caixa está marcada no agente?
Seção intitulada “2. A caixa está marcada no agente?”A conexão é feita do lado do agente, em <agente> › Operação › Caixas. Não existe aba de IA dentro das configurações da caixa de entrada.
Pra ver o mapa completo, use Brain › Visão geral: ele lista toda caixa da conta e quem responde nela, inclusive as sem agente, com o botão de conectar.
Se o agente é especialista e recebe conversas por triagem, o vínculo não aparece nas Caixas dele. Quem traz a conversa é a ferramenta de encaminhar do orquestrador.
3. O bot foi desligado naquela conversa?
Seção intitulada “3. O bot foi desligado naquela conversa?”Dentro da conversa existe o botão do bot, com três estados: ativo, em espera porque um humano assumiu, e desligado de vez ali.
Quando um atendente responde, o bot para. É o comportamento esperado, e é o que evita a IA falando por cima da pessoa. Pra devolver a conversa ao ciclo, use devolver à triagem.
4. Horário e limites
Seção intitulada “4. Horário e limites”Em Operação › Regras & ciclo:
- Respeitar horário da caixa faz o agente calar fora do expediente. Confira o horário da caixa antes de culpar a IA.
- Máximo de respostas por conversa por hora trava a conversa depois de N respostas. Numa conversa longa, o silêncio começa exatamente no limite.
- Atender respostas de disparo precisa estar ligado pro agente assumir conversa criada por campanha.
5. Chave, modelo e orçamento
Seção intitulada “5. Chave, modelo e orçamento”Em Brain › Configurações, só pra administradores:
- Provedores & modelos: a chave do provedor aparece como Conectado ou Usando chave do sistema. Use Testar Conexão. Chave revogada ou com espaço no fim é erro clássico.
- Orçamento & uso: se o teto do mês estourou e a ação configurada é Pausar assistentes da conta, todo mundo para de uma vez. A barra fica âmbar a partir de 80 por cento do limite.
- Crédito acabado no painel do provedor tem o mesmo efeito, e não aparece aqui. Confira na OpenAI, Anthropic ou Google.
6. Responde, mas responde mal
Seção intitulada “6. Responde, mas responde mal”Aí não é conexão, é conteúdo. Vá pra aba Teste e olhe o chip “N passos do agente” abaixo da resposta. Ele mostra a ferramenta chamada, os argumentos, o resultado e o tempo de cada passo.
| O que o rastro mostra | O que fazer |
|---|---|
| Nenhuma ferramenta chamada | O roteiro não manda usar. Cite o nome técnico da ferramenta no prompt |
| Ferramenta chamada, resultado vazio | Documento ainda processando, base não vinculada ou pergunta que não bate com o texto |
| Resultado certo, resposta errada | Use “como responder” na consulta pra impor o formato |
| Troca um valor por outro numa lista | Troque a consulta pro modo lista exata |
Lembre que o playground não junta mensagens, não transcreve áudio e não fatia a resposta. Pra ver o comportamento real, use o status Em teste.
7. Demora
Seção intitulada “7. Demora”- Modelo pesado numa função de alto volume pesa. Em Provedores & modelos existe modelo por função.
- Consulta trazendo muitos trechos aumenta o tempo e o custo. Reduza o número de trechos na ferramenta de base.
- Ritmo entre mensagens, no Perfil, é proposital: a resposta longa sai fatiada com pausa. Não confunda com lentidão.
Perguntas soltas
Seção intitulada “Perguntas soltas”O agente responde em inglês. Escreva o roteiro em português e diga o idioma nele. O modelo segue a língua da instrução.
Ele inventa preço. Crie a ferramenta de consulta à base, mande o roteiro chamá-la antes de falar valor e use o modo lista exata. Preencha também a mensagem de não encontrado.
Dá pra usar outro provedor? Sim: OpenAI, Anthropic e Google Gemini, com chave própria em cada um.
O cliente achou o tom ruim. Revise o Perfil e o roteiro. Tom é instrução, não acaso.