O agente não está respondendo

Um agente pode deixar de responder no chat de teste do construtor, em um chatbot no seu site ou pela API. A causa é quase sempre uma das verificações abaixo. Percorra a lista de cima para baixo, porque as primeiras são as mais comuns e as mais rápidas de descartar.

Sintomas#

• Você envia uma mensagem e nada volta.
• O chat mostra um erro em vez de uma resposta.
• Um visitante do chatbot vê “Oops! Something went wrong. Please contact website owner!”

Causas prováveis, em ordem#

1. O workspace está sem créditos#

Agentes não podem ser executados sem créditos. Procure o aviso Modo somente leitura e verifique o número de créditos na parte inferior da barra lateral. Quem chama a API recebe “Insufficient credits to perform this action. Please recharge your credits.” Visitantes do chatbot veem “Sorry, you’ve reached your payment limit.” Consulte sem créditos.

2. A assinatura terminou ou o workspace está somente leitura#

Se o plano foi cancelado, o workspace fica inativo e as execuções são recusadas com “This workspace is inactive because its subscription ended.” Apenas o proprietário pode escolher um plano novamente.

3. Um aplicativo de que o agente precisa não está conectado#

Se uma ferramenta precisa de uma conta que você não conectou, você vê um aviso como “Slack integration is required, but was not found” ou “Component is not integrated”, e uma execução que chega a essa ferramenta falha com “is not configured. Please set up the integration first.” Abra Integrações e conecte-a. Consulte integração desconectada.

4. A memória está ativada sem categoria#

No construtor de agentes, Memória precisa de uma categoria. O construtor avisa “Pick a category, or turn Memory off. The agent refuses to run while Memory is on with none picked.” Escolha uma categoria em Avançado ou desative a memória. Consulte memória e histórico de chat.

5. Suas alterações foram salvas, mas não publicadas#

As edições são salvas como rascunho. Quem usa o agente em produção, incluindo um chatbot no seu site, vê a última versão publicada até você clicar em Publicar alterações. Um gatilho mostra “Publish to activate” até você fazer isso. Consulte compartilhar e publicar.

6. O chatbot está desativado ou com limite de requisições#

Em Chatbots, abra o chatbot e verifique se Chatbot enabled está ativado. Visitantes que enviam mensagens demais veem “Too many requests. Please try again later or sign in to continue.” Os limites ficam em Rate Limiting nas configurações do chatbot.

7. Uma etapa ou ferramenta falhou#

Uma ferramenta ou etapa do agente pode falhar mesmo quando o modelo em si funciona. Abra Histórico, encontre a sessão, ative o filtro Mensagens de erro e leia o evento que falhou. Consulte uma execução falhou.

Corrija o problema#

1. Envie uma mensagem de teste curta no chat do construtor e anote o texto exato de qualquer erro.
2. Compare esse texto com a lista acima e aplique a correção.
3. Publique se você alterou algo e teste novamente a partir do local que falhou, como o seu site.