Agente de IA não respondeu ou respondeu errado
Se o seu agente de IA ficou calado ou deu uma resposta errada, este artigo mostra os pontos a conferir para colocá-lo nos trilhos.
🧩 Este recurso faz parte do módulo Agentes Inteligentes. Se ele não aparecer na sua conta, fale com o administrador para ativá-lo. Veja Planos e módulos.
Objetivo
Descobrir por que o agente de IA não respondeu ou respondeu errado e corrigir a configuração.
Pré-requisitos
- Módulo Agentes Inteligentes ativo
- Perfil Administrador
Tempo estimado
10 minutos.
Caminho de acesso
Bots → Agentes InteligentesIA
Passo a passo
- Abra Bots → Agentes
InteligentesIA e verifiqueseoagentestatusestádo agente: precisa estarativo/publicadoAtivo. Um agentepausadoPausado, Rascunho ou Arquivado não responde. - Confira o provedor de IA e a chave. Se a chave (API key) do provedor estiver ausente, vencida ou sem créditos, o agente não consegue gerar respostas. Veja
Configurar seu provedor de IA (chave própria)configurar-provedor-ia.
🖼️Janela PRINT — Tela de configuração do agenteProvedores, em Bots → Agentes Inteligentes,IA, destacandoonde fica a chave de IA que o provedoragente e a chave.usa
- Se ele respondeu, mas errado, revise a base de conhecimento: informações desatualizadas ou faltando levam a respostas imprecisas. Atualize os documentos. Veja
Alimentar a base debase-conhecimento(upload de documentos / RAG). - Revise as instruções do agente. Instruções vagas ou contraditórias geram respostas fora do esperado. Veja
Escrever boas instruções (prompt) para o agenteboas-instrucoes. - Verifique o limite de turnos (campo Máx. turnos no agente). Ao atingir o
númeroteto,máximoosdeturnostrocasseguintesnadaconversa,conversaosãoagentetransferidos paradeumresponderatendentee deve passar o atendimento a uma pessoa.humano. Confira as regras de supervisão e transferência. VejaDefinir supervisão humana e hand-off para agente humanosupervisao-handoff.
Resultado esperado
O agente volta a responder dentro do escopo definido e, quando não sabe ou atinge o limite, transfere para um atendente humano.
Erros comuns
- Sintoma: o agente não respondeu nada. Solução: quase sempre é a chave do provedor (ausente, vencida ou sem crédito) ou o agente pausado. Comece por aí.
- Sintoma: responde com informação errada. Solução: corrija a base de conhecimento e refine as instruções; a IA responde com base no que você forneceu.
- Sintoma: parou de responder no meio da conversa. Solução: provavelmente atingiu o limite de turnos; ajuste o limite ou configure a transferência para atendente.
- Sintoma: responde temas fora do assunto. Solução: deixe as instruções mais específicas sobre o que ele pode e não pode tratar.
Artigos relacionados
Configurar seu provedor de IA (chave própria)configurar-provedor-iaCriar um agente de IA no buildercriar-agente-iaAlimentar a base debase-conhecimento(upload de documentos / RAG)Definir supervisão humana e hand-off para agente humanosupervisao-handoff