Investigar execuções com falha usando o assistente de IA
Entregue a ele uma execução com falha: ele aponta a etapa que falhou, explica a causa, corrige o fluxo ali mesmo e roda de novo.
Quando uma execução falha, o que consome tempo geralmente não é corrigir, e sim encontrar — qual das centenas de eventos realmente deu errado e em qual campo. Esta página mostra como passar esse trabalho ao assistente de IA.
Comece pela página de detalhe da execução
- Abra a página de detalhe daquela execução com falha.
- Abra o assistente de IA: acima da caixa de texto surgem dois botões, diagnosticar e repetir. Clique em diagnosticar — ou simplesmente pergunte por que esta execução falhou; dá no mesmo.
- A resposta aponta a etapa que falhou, dá a causa direta do erro e diz como a configuração correspondente do fluxo deve mudar.
- Depois de concordar com a correção, deixe-o editar o fluxo direto e rode de novo.
O que ele realmente vê
A plataforma não joga o log inteiro da execução no modelo — sairia caro e afogaria o que importa. O assistente recebe um conjunto de evidências compactado:
- o status geral da execução, o progresso, os horários de início e fim e a mensagem de erro de nível superior;
- uma linha do tempo de status de todas as etapas: status, tipo, número de tentativas, duração e se a retomada automática já a resgatou;
- detalhe completo apenas da etapa que falhou e da atual: entradas, saídas, pilha de erro e a configuração daquela etapa;
- e a estrutura do próprio fluxo, para distinguir erro de configuração de problema no sistema externo.
As evidências são montadas no servidor sob as suas permissões: uma execução que você não vê, o assistente também não lê. O mesmo vale para fluxos compartilhados na equipe, conforme a sua posição nela.
«Deixe a IA corrigir» dentro do editor
Quando os problemas aparecem antes mesmo de rodar, há um caminho mais curto:
- o painel de diagnóstico no rodapé do editor pode entregar um problema específico — ou todos de uma vez — à IA para corrigir;
- a entrada no painel de propriedades da etapa abre o assistente com todo o contexto daquela etapa, sem copiar YAML na mão;
- o assistente ainda gera um diff; nada é salvo até você confirmar, e a mudança entra no histórico de desfazer do editor.
Tipos comuns de falha e até onde ele ajuda
| Tipo de falha | O que o assistente pode fazer |
|---|---|
| Erros de configuração (variável que não resolve, tipo de campo errado, etapa sem conexão) | Aponta o campo exato e dá a correção; você pode mandá-lo aplicar ali mesmo. |
| Credencial ausente ou expirada | Diz de qual serviço falta a autorização; você a adiciona ou substitui na página de Integrações. |
| Erros de uma API externa (limite de taxa, permissão insuficiente, parâmetros recusados) | Explica o que a resposta do serviço significa e sugere política de retentativa ou ajuste de parâmetros — mas problemas da própria conta no provedor você resolve no painel dele. |
| Uma etapa de código lançando exceção | Lê o script e a pilha de erro para localizar o comportamento e devolve o script corrigido. |
| Uma execução interrompida no meio | Usa o registro de retomada para dizer quais etapas já deram certo e de onde é mais seguro continuar. |
Em lote: o que falhou recentemente
Abra o assistente na lista de execuções e um dos botões rápidos é «ver execuções que falharam recentemente» — ótimo para uma varredura matinal das tarefas agendadas da noite antes de entrar em cada uma.
Leia a seguir
- Depuração de pontos de paragem — Quando precisar parar no meio e inspecionar variáveis, use pontos de interrupção em vez de diagnóstico depois do fato.
- Continuar automaticamente — As próprias interrupções podem ser configuradas para retomar sozinhas.
- Monitorização da execução — Como ler o fluxo de eventos, os logs e o custo.