Dépannage

Organisé par « Symptômes que vous voyez ». Localisez rapidement le plus proche et suivez « Comment réparer ». Si le problème ne peut pas être résolu, accédez à la « FAQ » ou soumettez un bon de travail.

Lié à l'exécution

L'exécution reste en attente et reste en cours d'exécution.

Vérifiez d'abord :

1. Vérifiez si un message « limite de concurrence atteinte » figure en haut de l'« Historique d'exécution ». Concurrence : 1 pour Free / 5 pour Pro / 15 pour Team — votre nombre d'exécutions simultanées a-t-il atteint la limite ?
2. Vérifiez si l'étape manual_approval de ce workflow est bloquée au premier plan.
3. Laissez-le attendre encore 30 secondes – un instant occasionnel. Le bon de travail est EN ATTENTE après plus de 2 minutes.

Échec de l'exécution : credential_not_found

Comment réparer :

1. Examinez le nom des informations d'identification demandé dans error_message.
2. Open Credential Center - Un identifiant portant ce nom existe-t-il réellement ? Les majuscules, les traits de soulignement/tirets doivent être cohérents.
3. Avez-vous créé des informations d'identification dans « Team Namespace » mais vous êtes actuellement dans le rôle Viewer ? Le spectateur ne peut pas référencer les informations d'identification.
4. Il y a quelque chose dans la liste mais il n'a pas été analysé - déconnectez-vous et reconnectez-vous pour actualiser les autorisations.

Échec de l'exécution : rate_limit_exceeded

Raison :Votre limite actuelle ou celle du fournisseur LLM de la plateforme est déclenchée.

Comment réparer :

1. Ajoutez une stratégie de nouvelle tentative à l'étape ayant échoué :

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

2. Si vous ratez souvent la limite, la mise à niveau BYOK du niveau de compte du fournisseur est la solution fondamentale.
3. Lorsque vous exécutez de nombreuses tâches par lots, utilisez sub_workflow + max_parallel pour contrôler la simultanéité.

Échec de l'exécution : délai d'attente

Raison :Une seule étape dépasse sa valeur de délai d'attente, ou l'exécution entière dépasse le délai d'expiration au niveau du workflow.

Comment réparer :

• code step : ajoutez explicitement un champ timeout sur le step (en secondes, 30 par défaut).
• Étape LLM : Il se peut que la génération du modèle soit trop longue ; réduisez max_tokens ou utilisez un modèle plus rapide.
• L'ensemble du flux de travail est lent : ajoutez un champ de délai d'attente en haut (en secondes, 3 600 par défaut).

La Sortie de l'agent est vide/déraisonnable

Vérifiez d'abord :

1. Détails de l'exécution → Cliquez sur cette étape → Regardez « Historique des appels de l'outil de l'agent » pour voir si vous avez été dirigé vers le mauvais outil.
2. Vérifiez si la variable d'entrée est vide : l'étape en amont est-elle ignorée par la condition ?
3. Ajustez la température : 0 à 0,3 pour les tâches de raisonnement/classification ; 0,6 à 0,9 pour la créativité.
4. description de la tâche ainsi que quelques exemples plus spécifiques.
5. Essayez de passer à un modèle plus puissant (claude-opus-4-7 / gpt-5).

L'étape de code signale une autorisation refusée ou une erreur réseau

L'étape de code s'exécute dans un bac à sable d'isolation, avec des restrictions :

• Le système de fichiers est en lecture seule - seul /tmp est accessible en écriture ;
• Le réseau ne peut que sortir mais pas entrer (impossible de surveiller le port) ;
• Le processeur, la mémoire et le temps d'exécution sont limités.

Comment réparer :l'autorisation refusée signifie généralement que vous essayez d'écrire sur un chemin autre que /tmp - /tmp/something à la place. La plupart des erreurs réseau sont causées par le bac à sable bloquant votre hôte cible (la plateforme dispose d'une liste blanche de sortie). Vous pouvez soumettre un bon de travail pour ajouter la liste blanche.

Concernant l'enregistrement et l'édition

Invite "YAML n'est pas cohérent avec DAG" lors de l'enregistrement

Cela signifie que la règle de l'aller-retour n'est pas satisfaite après avoir modifié manuellement le YAML. Raisons courantes :

• Nom du champ camelCase utilisé (doit être Snake_case)
• Fait référence à un préréglage ou à un agent supprimé
• depend_on pointe vers un identifiant d'étape qui n'existe pas

En cliquant sur le bouton "Vérifier", vous obtiendrez le numéro de ligne exact - corrigez-le en fonction de l'emplacement de l'erreur.

L'éditeur ne peut pas être ouvert / continue de tourner en rond

1. Actualisez-le. Généralement transitoire.
2. Regardez la barre d'état indiquant "xxx est en cours d'édition" - quelqu'un d'autre détient le verrou d'édition. Il se libérera automatiquement après 5 minutes d'inactivité ou contactera l'autre partie.
3. L'administrateur peut "forcer le déverrouillage" dans les paramètres de l'équipe.
4. Vider le cache du navigateur/changer de navigateur pour tester.

La Différence donnée par l'assistant AI n'a pas pu être vérifiée après l'application.

Ctrl / Cmd + Z pour annuler — l'éditeur prend en charge plusieurs niveaux d'annulation. Collez ensuite le message d'erreur et le YAML d'origine dans l'assistant, il le corrigera.

Lié à la planification/Webhook

cron Ça Ne s'est pas déclenché à ce moment-là

1. La « prochaine heure de déclenchement » sur la page des détails du planning est-elle conforme aux attentes ? L’inadéquation des fuseaux horaires est la cause la plus courante.
2. Existe-t-il un enregistrement de « l'historique des 10 derniers déclencheurs » ? Dans le cas contraire, il se peut que le workflow ait été archivé ou supprimé.
3. Examinez l'état du flux de travail : est-il en pause ? Le programme de pause compte toujours, mais ne se déclenchera pas réellement.
4. Vérifier manuellement le flux de travail lui-même avec le bouton « Déclencher une fois maintenant » est très bien.

Webhook Le Déclencheur renvoie 401/403

1. Méthode API Key : la key transmise dans le header Authorization: Bearer ou X-API-Key est-elle correcte ? La key a-t-elle expiré, dispose-t-elle de la portée WEBHOOK_TRIGGER ?
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. L'ID de webhook dans l'URL path est-il correct ? Le workflow correspondant a-t-il été supprimé ?

Webhook Déclenchez 200 mais l'exécution ne démarre pas

200 signifie uniquement « demande acceptée », l'exécution peut être rejetée :

• Si le flux de travail est suspendu ;
• Si ce package atteint le quota de simultanéité/planification ;
• La vérification a échoué lorsque le corps a été mappé à des variables (les champs obligatoires sont manquants/le type est incorrect).

Journal de déclenchement du Webhook - Dans l'onglet « Historique » de la page des détails de planification, vous pouvez voir les détails de l'analyse de la plateforme après réception de la demande.

Lié à l'approbation

manual_approval ne envoie jamais de notifications

1. La page « Configuration des notifications » est-elle liée à n'importe quel canal Slack/Feishu/E-mail ?
2. Journal d'audit → Filtre approbation_notify_failed - Découvrez pourquoi la notification ne peut pas être envoyée (URL du webhook invalide ? Rebond d'e-mail ?).
3. Lorsque la liste des approbateurs est vide, elle en informe par défaut « tous les administrateurs et supérieurs » : votre compte en fait-il partie ?

J'ai approuvé mais le flux de travail n'a pas continué

Le flux de travail post-approbation devrait se poursuivre dans les 10 secondes. N'a pas continué plus d'une minute :

1. Actualisez la page des détails de l'exécution. Est-ce qu'il FONCTIONNE déjà ?
2. Le système est occupé et peut être mis en file d'attente pendant 30 secondes, etc.
3. Créez un bon de travail après plus de 5 minutes.

Lié à l’équipe/à l’autorisation

Impossible de voir le flux de travail après avoir changé d'équipe

Les workflows sont isolés par équipe : ils ne sont pas affichés entre les équipes. Assurez-vous d'avoir sélectionné la bonne équipe (déroulez vers le bas dans le coin supérieur droit). Si vous passez de « Individuel » à « Équipe », vous devez recréer le flux de travail dans l'équipe ou passer d'individuel.

Des collègues disent qu'ils n'ont pas la permission de modifier un certain flux de travail

Est-il un Viewer dans cette équipe ? La visionneuse est en lecture seule. Mettez-le simplement d'administrateur à éditeur.

Je Ne suis pas le propriétaire, mais je souhaite transférer le workflow que j'ai créé

"Déplacer vers l'équipe" nécessite que vous soyez rédacteur ou supérieur dans l'équipe cible. Rejoignez simplement l’équipe cible vous-même.

Payer/facture

Échec du prélèvement par carte de crédit

1. Page de facturation → « Réessayer le débit ». Après 3 échecs, le forfait sera temporairement rétrogradé en Free - il sera automatiquement restauré tant que vous réussirez à déduire de l'argent dans les 14 jours.
2. Les cartes chinoises peuvent être contrôlées par Stripe, veuillez utiliser Alipay/WeChat Pay.

Le Titre de la facture est erroné

Vous pouvez modifier les informations de facturation sur la page de facturation avant l'émission de la facture du mois suivant. Pour une facture déjà émise, envoyez un e-mail à billing@braidrun.com pour demander son annulation et sa réémission.

J'ai tout essayé mais ça ne marche toujours pas

1. « Aide » dans le coin inférieur droit → Soumettre un bon de travail. Attachez automatiquement le contexte du navigateur + l'ID d'exécution le plus récent.
2. Plan Entreprise → Contactez directement le CSM dédié.