- Introdução
- Criar
- Adicione um agente de IA a um fluxo de trabalho
- Chamar uma API externa
- Processar e-mails de entrada
- Crie um fluxo de trabalho de notificação do Slack
- Adicione aprovação humana a um fluxo de trabalho
- Crie um fluxo de trabalho de agente de chat
- Tratar erros
- Noções básicas de depuração
- Intervenção humana: escalonamento ou etapa humana
- Avaliando seus fluxos de trabalho
- HTTP Request
- Como os nós de conector funcionam
- Criar uma conexão
- Vendas e relacionamentos com clientes
- Suporte ao cliente e suporte técnico
- Mensagens e reuniões
- Email
- Marketing
- Mídias sociais
- Arquivos, documentos e assinatura eletrônica
- Projetos, colaboração e código
- Pessoas e recurso
- Finanças e comércio
- Modelos e agentes de IA
- Fala, visão e idioma
- Dados e localização
- Cloud, identidade e segurança
- Implantar e executar
- Exemplos
- Referência
Tratar erros
Route failed nodes to an error path, return the error details, retry temporary failures, and end the workflow cleanly on unrecoverable errors.
O que você cria
A workflow that routes a failing node to a separate path, records the failure with useful context, retries temporary failures where that makes sense, and ends cleanly when the error is unrecoverable. The result is a pattern that fits into any existing workflow.
Antes de começar
- Um fluxo de trabalho existente com pelo menos um nó que pode falhar e possui uma guia Tratamento de erro , por exemplo, uma Solicitação HTTP ou um nó Extração.
Nós usados
- Solicitação HTTP: o nó que pode falhar neste exemplo.
- Script: returns the error details.
- Encerrar: encerra o fluxo de trabalho em erros não recuperáveis.
Etapas
Com um agente de codificação configurado, você pode ignorar as etapas manuais. Pergunte:
Add error handling to the HTTP Request node in this Maestro Automate workflow: connect its error path to a Script node that returns the error message, retry temporary failures, and end the run with a Terminate node when the error can't be recovered.
Add error handling to the HTTP Request node in this Maestro Automate workflow: connect its error path to a Script node that returns the error message, retry temporary failures, and end the run with a Terminate node when the error can't be recovered.
Em seguida, abra o fluxo de trabalho na tela, confira as etapas abaixo e teste. Configure seu agente de codificação descreve a configuração.
1. Conecte o identificador de erro do nó
Por padrão, um nó com falha interrompe todo o fluxo de trabalho. Em vez disso, para lidar com a falha:
-
Abra o fluxo de trabalho na tela e selecione o nó que pode falhar.
-
Abra a guia Tratamento de erros e ative Habilitar tratamento de erros. Um identificador de erro aparece abaixo do identificador de saída principal.
-
Selecione o + no identificador de Erro , pesquise Script e selecione-o.
Isso cria um caminho de erro. Quando o nó falhar, a execução segue esse caminho em vez de interromper o fluxo de trabalho. Um nó sem um identificador Erro não é compatível com o tratamento de erros e uma falha lá interrompe o fluxo de trabalho e aparece na aba Incidentes .
2. Return the error details
In the Script node on the error path, read the error object at $vars.<node>.error and return the details:
const error = $vars.httpRequest1.error;
return {
message: "Error raised: " + error.message,
code: error.code,
status: error.status
};
const error = $vars.httpRequest1.error;
return {
message: "Error raised: " + error.message,
code: error.code,
status: error.status
};
The Script node's output appears in the execution trace, so the error details are visible when you inspect the run. The error object is only populated on the error path. The Error handling page lists the full set of error fields.
3. Tente novamente em caso de falhas transitórias (opcional)
Se houver probabilidade de a falha ser temporária, como uma interrupção de rede ou um limite de taxa, tentar novamente antes de parar ajuda. O nó de Solicitação HTTP tem novas tentativas integradas: configurar Contagem de novas tentativas em sua guia Avançado faz com que ele tente novamente a solicitação muitas vezes antes de disparar o identificador de erro. Apenas a falha final roteia para o caminho do erro.
Repetir apenas operações que podem ser executadas mais de uma vez com segurança. Tentar novamente um nó com efeitos colaterais, como escrever dados ou enviar uma mensagem, pode criar duplicatas.
4. Encerre se for irrecuperável
No caminho do erro, após o nó Script, adicione um nó Encerrar . Para retornar a descrição da falha, selecione Adicionar variável de saída no nó e dê a ela um valor que inclua o erro, por $vars.httpRequest1.error.message.
O fluxo de trabalho termina no nó Encerrar, e a execução é listada em Monitorar execuções.
5. Teste e Debug
Para disparar o caminho do erro intencionalmente:
- Defina temporariamente o URL no nó de Solicitação HTTP para um valor inválido (por exemplo,
https://this-will-fail.example.com). - Selecione Executar Depuração (ook) na barra de ferramentas inferior da tela e verifique se o trace de execução segue o caminho do erro.
- Restaure o URL correto.
In the trace, select the Script node and check its output for the error message.
Resultado
The workflow routes failures to the error path, returns the error details, optionally retries temporary failures, and ends cleanly with a descriptive failure status. An invalid URL in the HTTP Request node confirms that the error path works.
Estender este fluxo de trabalho
- Envie um alerta em caso de falha: no caminho do erro, antes do nó Encerrar, adicione uma Solicitação HTTP ou nó de conector para notificar um canal do Slack ou criar um incidente do ServiceNow .
- Continuar em vez de encerrar: se a etapa não for crítica, faça com que o caminho de erro defina um valor de fallback e participe novamente do caminho principal em vez de encerrar.
- Apply this pattern widely: the Error handling page describes more patterns, such as returning error details and continuing, fallback values, and escalation.
Próximas Etapas
- Implantar um fluxo de trabalho: faça o fluxo de trabalho ser executado sem você.
- Guias: mais fluxos de trabalho para criar.
- Community: compartilhe o que você construiu ou peça ajuda a outros construtores.