Problemas comuns

Comece pela mesma pergunta de sempre: em que momento parou? Montar, publicar, acionar e executar falham por motivos diferentes.

Ao montar

Sintoma	Causa	O que fazer
Não consigo salvar: conflito	Outra pessoa alterou o rascunho	Recarregue e reaplique sua mudança
Um dado não aparece no seletor	Ele vem de uma etapa que roda depois	Reordene o fluxo
"O item" não aparece	Você está fora da etapa "Para cada item"	Essas origens só existem dentro do laço
Uma ferramenta aparece como não liberada	O espaço não a liberou	Ver Recursos liberados
Uma ferramenta aparece como "não confirmado"	Não foi possível verificar agora	Use o botão de verificar de novo

Ao publicar

A publicação valida tudo antes de criar a versão. As recusas mais comuns:

Mensagem	Significado	O que fazer
Etapa inalcançável	Ela não é atingida a partir do início	Ligue-a ao fluxo
Etapa sem saída	Só o Resultado pode não ter saída	Ligue-a ao próximo passo
Ciclo entre etapas	O fluxo volta sobre si mesmo	Refaça o trecho
Nenhum Resultado	Todo agente precisa de pelo menos um	Adicione a etapa Resultado
Referência a etapa posterior	Um dado é usado antes de existir	Reordene ou use outro dado
Endereço não liberado	O host não está na lista do espaço	Peça a liberação
Valor que parece credencial	Chave escrita direto num cabeçalho	Use referência a segredo
Limite acima do teto	O agente declara mais do que o espaço permite	Reduza, ou peça revisão do teto
Falta conta de execução	Etapas com IA exigem conta de execução	Ver Conta de execução
Versão já usada	Cada número é único no agente	Escolha o próximo

Ao acionar

Sintoma	Causa	O que fazer
O agendamento não dispara	A versão apontada não está mais ativa	Confira a versão ativa do ambiente
O agendamento parou depois de uma mudança	Os dados de entrada não servem mais	Corrija os dados do agendamento
A chamada HTTP devolve credencial inválida	Credencial errada, ou identificador inexistente	Confira os dois
A chamada HTTP recusa a entrada	Os dados não batem com o que o agente declara	Ajuste o corpo
A chamada HTTP devolve limite atingido	Frequência, simultaneidade ou tamanho	Ver Endereços HTTP
O endereço expirou	Endereços de development são temporários	Crie outro, ou torne-o permanente em produção

Ao executar

Sintoma	Causa provável	O que fazer
Falha imediata	Sem versão ativa no ambiente, ou conta de execução inativa	Ver Publicar
Uma etapa com IA falha por saída fora do formato	Um campo declarado não veio	Reduza os campos ou torne o objetivo mais explícito
Uma etapa com IA falha por pedir informação	O objetivo depende de algo que não foi entregue	Complete os dados de entrada
Uma chamada externa é bloqueada	O destino resolveu para um endereço interno	Confirme o endereço público do sistema
A execução expira	O prazo total acabou	Aumente o tempo limite ou reduza o trabalho
A execução parece travada	Está aguardando aprovação, espera ou nova tentativa	Veja a etapa atual na linha do tempo
Uma execução filha falhou	O problema está no agente chamado	Abra a execução filha

Quando o resultado "deu certo" mas não parece certo

Duas causas, nesta ordem:

1. Um erro foi tratado por desvio. O resultado declara as etapas com falha tratada. Procure essa lista antes de qualquer outra coisa.
2. A etapa com IA não tinha o que verificar. Sem campos declarados e sem ferramenta obrigatória, nada permite afirmar que ela cumpriu o objetivo. Ver Tarefa com IA.

Quando pedir ajuda

Tenha em mãos:

• o agente e a versão;
• o identificador da execução;
• em qual etapa parou e o código do erro.

Com isso, quem ajuda enxerga a mesma linha do tempo que você.

Próximos passos

• Erros de execução
• Acompanhar execuções
• Quando algo falha