Pular para o conteúdo

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.

SintomaCausa provávelOnde olhar
Não responde em caixa nenhumaStatus em Rascunho, Em teste ou PausadoOperação
Não responde só numa caixaCaixa não marcada no agenteOperação › Caixas
Parou de responder no meio da conversaAlguém respondeu, ou o bot foi desligado aliBotão do bot na conversa
Para de responder sempre na mesma alturaLimite de respostas por horaOperação › Regras & ciclo
Parou pra conta inteira, do nadaOrçamento estourado com “pausar assistentes”Brain › Configurações › Orçamento & uso
Responde fora do assunto ou inventaFalta base, falta ferramenta ou roteiro vagoCérebro e Ferramentas
Demora muitoModelo pesado ou consulta trazendo trecho demaisBrain › Configurações › Provedores & modelos

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.

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.

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.

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.

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.

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 mostraO que fazer
Nenhuma ferramenta chamadaO roteiro não manda usar. Cite o nome técnico da ferramenta no prompt
Ferramenta chamada, resultado vazioDocumento ainda processando, base não vinculada ou pergunta que não bate com o texto
Resultado certo, resposta erradaUse “como responder” na consulta pra impor o formato
Troca um valor por outro numa listaTroque 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.

  • 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.

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.