Resolução de problemas
Uma execução falhou
Como encontrar uma execução falhada no Histórico, ler o seu erro e corrigir as causas habituais.
Uma execução falha quando um passo não consegue terminar: uma ferramenta dá erro, uma app não está ligada, o espaço de trabalho não tem créditos ou o plano não permite um passo. Todas as execuções são guardadas, por isso pode ler o que aconteceu depois de ter falhado.
Sintomas#
- O agente interrompe-se a meio ou dá uma resposta vazia ou genérica.
- Um fluxo de trabalho termina mais cedo, ou uma linha de lote mostra Failed.
- Uma execução agendada não fez nada.
- Vê um aviso de erro depois de clicar em publicar, como “A validação falhou. Corrija os erros assinalados nos componentes.”
Encontrar a execução no Histórico#
- Clique em Histórico na barra lateral.
- Ative o filtro Mensagens de erro para listar apenas as sessões que continham um erro. Também pode filtrar por Agente ou fluxo de trabalho e por chatbot.
- Abra uma sessão. Use Simples ou Verboso para alterar a quantidade de detalhe que vê.
- Leia os eventos de cima para baixo. Estão etiquetados como Mensagem do utilizador, Resposta do chatbot, Mensagem do sistema, Hook de chat, Chamada de ferramenta e Consulta do agente. Procure nos eventos Chamada de ferramenta aquele que reporta o erro.
O painel de métricas acima da tabela (Mostrar métricas) apresenta um gráfico de Total de erros ao longo do tempo. O seu plano limita até onde o histórico recua. Consulte planos e limites. Para execuções em lote, a tabela tem as colunas Estado e Erro, e Reexecutar falhadas ou Tentar novamente a linha voltam a executar as linhas falhadas.
Erros comuns e correções#
| O que vê | Causa | Correção |
|---|---|---|
| “Créditos insuficientes para realizar esta ação. Recarregue os seus créditos.” | O saldo está vazio | Sem créditos |
| “Limite de créditos do espaço de trabalho atingido” | Um limite de gastos do espaço de trabalho | Aumente-o em Definições → Créditos |
| “NAME não está configurado. Configure primeiro a integração.” | O passo precisa de uma app que não está ligada | Ligue-a em Integrações |
| “…está ligada, mas faltam-lhe as permissões necessárias. Volte a ligar a integração e conceda as permissões adicionais.” | A ligação não tem uma permissão | Volte a ligar e aceite todas as permissões |
| “…requer nova autorização. O token de atualização expirou ou foi revogado. Volte a ligar a integração.” | A sessão expirou ou foi revogada | Volte a ligar a conta |
| “O componente NAME só pode ser usado com o plano …” | O passo não está no seu plano | Substitua o passo ou faça upgrade |
| “Limite permitido de … atingido. Atualize o seu plano.” | Atingiu um limite do plano ao criar algo | Remova um ou faça upgrade |
| “A validação falhou. Corrija os erros assinalados nos componentes.” | Falta uma definição obrigatória num passo | Corrija os passos assinalados e volte a publicar |
Execuções agendadas#
Se o espaço de trabalho ficou sem créditos, o sistema desliga o agendamento em vez de tentar novamente para sempre. Abra-o e volte a ativá-lo quando tiver créditos. Consulte agendamentos.
Corrigir#
- Encontre a sessão falhada e copie o erro exato.
- Compare-o com a tabela, aplique a correção e volte a executar a mesma entrada.
- Se o erro vier de um serviço externo e não conseguir perceber porquê, teste o passo isoladamente a partir do canvas. Consulte testes e registos de execução.
Veja quanto custou uma execução
Verifique Transações se não tiver a certeza de quanto gastou uma execução. Cada cobrança é apresentada com o seu tipo e contexto. Consulte créditos.