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.
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
stagede lifecycle ou umworkflow_idnumé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.
Artigos relacionados
-
Crie seu primeiro agente de IA
Aprenda o que um agente de IA faz no Omnifox, como dar instrucoes, conecta-lo a um canal e testa-lo no sandbox antes de falar com clientes reais.
-
Como escrever boas instruções para seu agente de IA
Aprenda a redigir instruções claras para que seu agente de IA responda com o tom, os limites e as ações corretas.
-
Guia completo dos Agentes de IA
Os Agentes de IA a fundo, em 65 capítulos: criar, instruções, ferramentas, conhecimento, comportamento, teste, caixa de entrada, fluxos, análise e consumo, com cada opção explicada.
-
Conectar seu agente de IA ao WhatsApp, Instagram, Messenger e chat do site
Um agente sem canais não atende ninguém. Conecte-o ao seu WhatsApp, Instagram, Messenger ou ao chat do seu site na seção Conexões e ative-o para ele começar a responder.
-
Comece aqui: os Agentes de IA em 8 minutos
O essencial dos Agentes de IA em um vídeo curto: criar um agente, as instruções, ferramentas, conhecimento, canais, o teste, o horário e a passagem para uma pessoa.