Solução de problemas do agente de IA: não responde, não executa ações ou entra em loop

Diagnóstico passo a passo das causas mais comuns de um agente de IA ficar em silêncio, ignorar uma ferramenta configurada ou repetir a mesma resposta.

Jul 11, 2026

Veja este passo no vídeo · Solução de problemas

Quando um agente de IA fica em silêncio, não executa a ação que você descreveu no prompt, ou parece repetir a mesma resposta sem parar, quase sempre é um destes motivos. Verifique na ordem.

1. O agente não responde de jeito nenhum

  • Agente inativo: na aba Identidade do editor do agente, confirme que o status está ativo.
  • Fora do horário: se na aba Comportamento o Horário de atendimento estiver em Horário comercial ou Personalizado, fora dessas janelas a IA não responde com o modelo: envia a mensagem de Fora do horário (se você escreveu uma) e/ou passa a conversa para a equipe. É intencional. No teste você vê o aviso de fora do horário e pode clicar em Testar como se estivesse no horário.
  • Orçamento diário de tokens: não é a causa. Esse campo do editor não trava mais o agente (está desativado em toda a plataforma).
  • Cota do plano e Saldo Omnifox esgotados: cada plano tem uma cota mensal de tokens de IA. Quando acaba, a IA continua com o seu Saldo Omnifox se houver saldo e a opção Continuar com o seu Saldo ao ultrapassar o limite estiver ativada; caso contrário, o sistema para de chamar o modelo e escala a conversa em vez de deixar o cliente sem resposta. Confira o uso e recarregue em Configurações → Faturamento.
  • Canal configurado como "nunca": se a estratégia de roteamento de IA do canal for "nunca", esse canal simplesmente nunca aciona o bot.

2. O agente responde mas não executa a ação esperada

  • A ferramenta está desligada para esse agente: cada ferramenta (fechar conversa, atribuir, etc.) tem seu próprio interruptor na aba Ações personalizadas do editor. Se estiver desligado, o modelo nunca vê essa ferramenta disponível, mesmo que o prompt a mencione.
  • A ferramenta não está incluída no seu plano: agendar, remarcar e cancelar compromissos no calendário do Omnifox está em todos os planos; as ações HTTP exigem Impulsa ou superior; atualizar dados ou etiquetas do contato, disparar workflow e agendar reunião (link do Cal.com) exigem Crece; atender chamadas de voz (handle_call) exige o Escala.
  • O prompt não diz QUANDO usá-la: o modelo só chama uma ferramenta quando o system prompt descreve explicitamente a condição de disparo (ex.: "se o cliente confirmar que está resolvido, feche a conversa").
  • Parâmetros mal formados: se uma ferramenta exige um valor exato (ex.: um stage de lifecycle ou um workflow_id numérico) e o modelo não o tem, a chamada falha silenciosamente para o cliente, mas fica registrada no log/traço do Sandbox.

3. O agente entra em loop / repete a mesma resposta

  • Use o Sandbox (testador ao vivo) do editor para reproduzir a conversa e ver o traço completo turno a turno.
  • Ative a trava anti-loop: na aba Comportamento, o campo "Escalar para um humano após N respostas sem resolver" corta o ciclo automaticamente após N respostas seguidas sem fechamento (veja o artigo dedicado).
  • Verifique o limiar de confiança (auto_handoff_confidence_threshold): se estiver muito baixo, o modelo pode continuar respondendo mesmo sem confiança.
  • Se o cliente envia várias mensagens seguidas em poucos segundos, o anti-spam (Comportamento → Anti-spam) agrupa essas mensagens em uma única resposta — se estiver desligado, pode gerar respostas duplicadas ou cruzadas.

Exemplo

Um agente de Vendas nunca fechava conversas mesmo quando o cliente dizia "obrigado, tudo certo". Ao checar a aba Ações, close_conversation estava desligado para esse agente — ativar o interruptor (o prompt já tinha a instrução) resolveu na hora.

Dicas

  • Sempre teste as mudanças no Sandbox antes de supor que "o modelo errou" — a maioria dos casos é configuração, não o modelo.
  • Se o problema persistir depois de checar tudo isso, contate o suporte com o ID da conversa afetada.
Isso foi útil?

Artigos relacionados

Fale conosco no WhatsApp