Resolução de Problemas

Organizado por "Sintomas que você vê".

Relacionado à execução

A execução permanece PENDING e permanece em RUNNING.

Verifique primeiro:

1. Verifique o topo do Histórico de Execução para um aviso com limite de concorrência. Free é 1 concorrente, Pro 5, Team 15 - o seu número de corridas simultâneas atingiu o limite?
2. Verifique se a etapa manual_approval deste workflow está travada na frente.
3. Deixe esperar mais 30 segundos – um instante ocasional.

Falha na execução: credential_not_found

Como consertar:

1. Veja o nome da credencial solicitado em error_message.
2. Open Credential Center - Existe realmente uma credencial com esse nome?
3. Você criou credenciais no "Team Namespace", mas atualmente está na função de Visualizador?
4. Há algo na lista, mas não foi analisado - efetue logout e login novamente para atualizar as permissões.

Falha na execução: rate_limit_exceeded

Razão:O limite atual do seu provedor LLM ou da plataforma é acionado.

Como consertar:

1. Adicione a estratégia de nova tentativa à etapa com falha:

- id: call_llm
  type: single
  agent: writer
  retry:
    max_attempts: 3
    backoff: exponential
    initial_delay_ms: 2000
    retry_on: [rate_limit, http_5xx]

2. Se você costuma avaliar_limit, a atualização do nível da conta do provedor BYOK é a solução fundamental.
3. Ao executar muitas tarefas em lote, use sub_workflow + max_parallel para controlar a simultaneidade.

Falha na execução: tempo limite

Razão:Uma única etapa excede seu valor de tempo limite ou toda a execução excede o tempo limite no nível do workflow.

Como consertar:

• passo do código: adicione um campo de timeout explícito no passo (em segundos, padrão 30).
• Etapa LLM: Pode ser que a geração do modelo seja muito longa;
• Todo o workflow é lento: adicione um campo de tempo limite na parte superior (em segundos, padrão 3600).

A saída do agente está vazia/irracional

Verifique primeiro:

1. Detalhes de execução â Clique nesta etapa â Veja "Histórico de chamadas de ferramenta do agente" para ver se você foi direcionado para a ferramenta errada.
2. Verifique se a variável de entrada está vazia - a etapa upstream foi ignorada pela condição?
3. Ajustar temperatura: 0–0,3 para tarefas de raciocínio/classificação;
4. descrição da tarefa, além de exemplos mais específicos de algumas cenas.
5. Tente mudar para um modelo mais forte (claude-opus-4-7/gpt-5).

Etapa de código relata permissão negada ou erro de rede

O passo de código é executado em uma caixa de areia de isolamento, com restrições:

• O sistema de arquivos é somente leitura - somente /tmp é gravável;
• A rede só pode sair, mas não entrar (não é possível monitorar a porta);
• CPU/memória/tempo de execução são limitados.

Como consertar:permissão negada geralmente significa que você está tentando gravar em um caminho diferente de /tmp - /tmp/something.

Salvar e editar relacionados

Prompt "YAML é inconsistente com DAG" ao salvar

Isso significa que a regra de ida e volta não foi satisfeita depois que você alterou manualmente o YAML.

• Nome do campo camelCase usado (deve ser Snake_case)
• Faz referência a uma predefinição ou agente excluído
• depende_on aponta para um ID de etapa que não existe

Clicar no botão "Verificar" fornecerá o número exato da linha - corrija-o de acordo com a localização do erro.

O editor não pode ser aberto/fica girando em círculos

1. Atualize-o.
2. Observe a barra de status mostrando "xxx está editando" - outra pessoa mantém o bloqueio de edição.
3. O administrador pode "forçar o desbloqueio" nas configurações da equipe.
4. Limpe o cache do navegador/altere o navegador para testar.

A diferença fornecida pelo assistente de IA não foi verificada após a aplicação.

Ctrl / Cmd + Z para desfazer—o editor suporta desfazer multi-nível. Em seguida, cole a mensagem de erro mais o YAML original de volta para o assistente e ele vai corrigi-lo.

Agendamento/Webhook relacionado

cron Não disparou no ponto

1. O "próximo horário de acionamento" na página de detalhes do cronograma é consistente com as expectativas?
2. Existe algum registro do "Histórico dos últimos 10 gatilhos"?
3. Observe o status do workflow: ele está pausado?
4. A verificação manual do próprio workflow com o botão "Acionar uma vez agora" é adequada.

Webhook O gatilho retorna 401/403

1. Método API Key: a chave na Autorização: Bearer ou cabeçalho X-API-Key está correta? A chave expirou, e ela tem o escopo WEBHOOK TRIGGER?
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. O ID do webhook no caminho URL está correto? O workflow correspondente foi excluído?

Webhook Trigger 200 mas a execução não inicia

200 significa apenas "solicitação aceita", a execução pode ser rejeitada:

• Se o workflow está pausado;
• Se este pacote atinge a cota de simultaneidade/agendamento;
• A verificação falhou quando o corpo foi mapeado para variáveis (os campos obrigatórios estão faltando/o tipo está errado).

Log do gatilho do webhook - Na aba “Histórico” da página de detalhes do agendamento, você pode ver os detalhes da análise da plataforma após o recebimento da solicitação.

Aprovação relacionada

manual_approval nunca envia notificações

1. A página "Configuração de Notificação" está vinculada a algum canal do Slack / Feishu / Email?
2. Log de auditoria → Filtrar aprovação_notify_failed - Veja por que a notificação não pode ser enviada (url do webhook inválido? E-mail devolvido?).
3. Quando a lista de aprovadores estiver vazia, ela notificará "todos os administradores e superiores" por padrão - sua conta é uma delas?

Aprovei, mas o workflow não continuou

O workflow pós-aprovação deve continuar dentro de 10 segundos.

1. Atualize a página de detalhes de execução.
2. O sistema está ocupado e pode ficar na fila por 30 segundos - etc.
3. Levante uma ordem de serviço após mais de 5 minutos.

Relacionado à equipe/permissão

Não consigo ver o workflow depois de trocar de equipe

Os workflows são isolados por equipe – eles não são exibidos entre equipes.

Colegas dizem que não têm permissão para alterar um determinado workflow

Ele é um visualizador nesta equipe?

Não sou o proprietário, mas quero transferir o workflow que criei

"Mover para equipe" exige que você seja Editor ou superior na equipe alvo.

Pagar/Faturar

Falha na cobrança do cartão de crédito

1. Página de cobrança â "Repetir débito".
2. Os cartões chineses podem ter risco controlado pelo Stripe, use Alipay/WeChat Pay.

O título da fatura está errado

Você pode alterar os detalhes da fatura na página de faturação antes que a fatura do próximo mês seja emitida. As faturas já emitidas requerem um e-mail para billing@braidrun.com para anular e reemitir.

Tentei de tudo mas ainda não funciona

1. "Ajuda" no canto inferior direito â Envie uma ordem de serviço.
2. Plano Empresarial → Entre em contato diretamente com o CSM dedicado.