Fehlerbehebung

Organisiert von „Symptoms You See“. Suchen Sie schnell das nächstgelegene und befolgen Sie die Anweisungen unter „Reparaturanleitung“. Wenn das Problem nicht behoben werden kann, gehen Sie zu „FAQ“ oder senden Sie einen Arbeitsauftrag.

Ausführungsbezogen

Die Ausführung bleibt AUSSTEHEND und LÄUFT weiterhin.

Überprüfen Sie zunächst:

1. Prüfen Sie, ob oben im „Ausführungsverlauf“ ein Hinweis „Parallelitätslimit erreicht“ erscheint. Free 1 / Pro 5 / Team 15 parallel — hat Ihre Anzahl gleichzeitig laufender Ausführungen das Limit erreicht?
2. Überprüfen Sie, ob der Schritt „manual_approval“ dieses Workflows vorne hängen bleibt.
3. Lassen Sie es weitere 30 Sekunden warten – gelegentlich einen Moment lang. Der Arbeitsauftrag ist nach mehr als 2 Minuten AUSSTEHEND.

Ausführung fehlgeschlagen: credential_not_found

So beheben Sie Folgendes:

1. Sehen Sie sich den Anmeldeinformationsnamen an, der in error_message angezeigt wird.
2. Open Credential Center – Gibt es wirklich einen Ausweis mit diesem Namen? Großschreibung, Unterstriche/Bindestriche müssen konsistent sein.
3. Haben Sie Anmeldeinformationen im „Team-Namespace“ erstellt, befinden sich aber derzeit in der Rolle „Betrachter“? Der Betrachter kann keine Anmeldeinformationen referenzieren.
4. Es gibt etwas in der Liste, aber es wurde nicht analysiert. Melden Sie sich ab und erneut an, um die Berechtigungen zu aktualisieren.

Ausführung fehlgeschlagen: rate_limit_exceeded

Grund:Das aktuelle Limit Ihres oder des LLM-Anbieters der Plattform wird ausgelöst.

So beheben Sie Folgendes:

1. Fügen Sie dem fehlgeschlagenen Schritt eine Wiederholungsstrategie hinzu:

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

2. Wenn Sie oft rate_limit verwenden, ist die BYOK-Upgrade der Provider-Kontostufe die grundlegende Lösung.
3. Wenn Sie viele Aufgaben im Batch ausführen, verwenden Sie sub_workflow + max_parallel, um die Parallelität zu steuern.

Ausführung fehlgeschlagen: Zeitüberschreitung

Grund:Ein einzelner Schritt überschreitet seinen Timeout-Wert oder die gesamte Ausführung überschreitet den Timeout-Wert auf Workflow-Ebene.

So beheben Sie Folgendes:

• Code-Step: Fügen Sie am Step explizit ein timeout-Feld hinzu (in Sekunden, Standard 30).
• LLM-Schritt: Möglicherweise ist die Modellgenerierung zu lang; Reduzieren Sie max_tokens oder verwenden Sie ein schnelleres Modell.
• Der gesamte Workflow ist langsam: Fügen Sie oben ein Timeout-Feld hinzu (in Sekunden, Standard 3600).

Die Agentenausgabe ist leer/unzumutbar

Überprüfen Sie zunächst:

1. Ausführungsdetails → Klicken Sie auf diesen Schritt → Sehen Sie sich den „Anrufverlauf des Agententools“ an, um zu sehen, ob Sie zum falschen Tool weitergeleitet wurden.
2. Überprüfen Sie, ob die Eingabevariable leer ist. Wird der vorgelagerte Schritt durch die Bedingung übersprungen?
3. Passen Sie die Temperatur an: 0–0,3 für Argumentations-/Klassifizierungsaufgaben; 0,6–0,9 für Kreativität.
4. Aufgabenbeschreibung sowie spezifischere Beispiele für wenige Schüsse.
5. Versuchen Sie, auf ein stärkeres Modell umzusteigen (claude-opus-4-7 / gpt-5).

Der Codeschritt meldet eine verweigerte Berechtigung oder einen Netzwerkfehler

Der Codeschritt wird in einer isolierten Sandbox ausgeführt, mit Einschränkungen:

• Das Dateisystem ist schreibgeschützt – nur /tmp ist beschreibbar;
• Das Netzwerk kann nur ausgehen, aber nicht rein (der Port kann nicht überwacht werden);
• CPU/Speicher/Laufzeit sind begrenzt.

So beheben Sie Folgendes:Die verweigerte Berechtigung bedeutet normalerweise, dass Sie versuchen, stattdessen in einen anderen Pfad als /tmp - /tmp/something zu schreiben. Die meisten Netzwerkfehler werden dadurch verursacht, dass die Sandbox Ihren Zielhost blockiert (die Plattform verfügt über eine Egress-Whitelist). Sie können einen Arbeitsauftrag erteilen, um die Whitelist hinzuzufügen.

Speichern und Bearbeiten im Zusammenhang

Beim Speichern wird die Meldung „YAML stimmt nicht mit DAG überein“ angezeigt

Dies bedeutet, dass die Roundtrip-Regel nicht erfüllt ist, nachdem Sie die YAML manuell geändert haben. Häufige Gründe:

• Verwendeter Feldname „camelCase“ (sollte „snake_case“ sein)
• Verweist auf eine gelöschte Voreinstellung oder einen gelöschten Agenten
• depend_on zeigt auf eine Schritt-ID, die nicht existiert

Wenn Sie auf die Schaltfläche „Überprüfen“ klicken, erhalten Sie die genaue Zeilennummer – beheben Sie sie entsprechend der Fehlerstelle.

Der Editor lässt sich nicht öffnen / dreht sich ständig im Kreis

1. Aktualisieren Sie es. Normalerweise vorübergehend.
2. Sehen Sie sich die Statusleiste mit der Meldung „xxx wird bearbeitet“ an – jemand anderes hält die Bearbeitungssperre. Es wird automatisch freigegeben, wenn 5 Minuten lang keine Bedienung erfolgt oder der andere Teilnehmer kontaktiert wird.
3. Der Administrator kann in den Teameinstellungen das „Entsperren“ erzwingen.
4. Browser-Cache leeren/Browser zum Testen ändern.

Der vom KI-Assistenten angegebene Unterschied konnte nach der Anwendung nicht überprüft werden.

Mit Ctrl / Cmd + Z zurücksetzen — der Editor unterstützt mehrstufiges Rückgängigmachen. Fügen Sie dann die Fehlermeldung und das ursprüngliche YAML wieder beim Assistenten ein, er behebt es.

Planung/Webhook bezogen

cron Es Wurde zu diesem Zeitpunkt nicht ausgelöst

1. Entspricht die „nächste Auslösezeit“ auf der Seite mit den Zeitplandetails den Erwartungen? Die häufigste Ursache ist die Nichtübereinstimmung der Zeitzonen.
2. Gibt es eine Aufzeichnung des „Verlaufs der letzten 10 Auslöser“? Wenn nicht, wurde der Workflow möglicherweise archiviert oder gelöscht.
3. Sehen Sie sich den Status des Workflows an – ist er pausiert? Der Pausenplan zählt weiterhin, wird jedoch nicht tatsächlich ausgelöst.
4. Die manuelle Überprüfung des Workflows selbst mit der Schaltfläche „Jetzt einmal auslösen“ ist in Ordnung.

Webhook Der Trigger gibt 401/403 zurück

1. Über API Key: Stimmt der im Header Authorization: Bearer oder X-API-Key mitgeführte Key? Ist der Key abgelaufen, verfügt er über den Scope WEBHOOK_TRIGGER?
2. HMAC 兼容方式：你是否用 HMAC-SHA256 对 raw body 算了签名，放 X-Webhook-Signature 头？格式是 sha256=<hex>。注意：绑定了 API Key 的 webhook 不再接受 HMAC 签名。
3. Ist die Webhook-ID im URL-Path korrekt geschrieben? Wurde der zugehörige Workflow gelöscht?

Webhook Trigger 200, aber die Ausführung startet nicht

200 bedeutet nur „Anfrage angenommen“, die Ausführung kann abgelehnt werden:

• Ob der Workflow angehalten ist;
• Ob dieses Paket das Parallelitäts-/Planungskontingent erreicht;
• Die Überprüfung ist fehlgeschlagen, als der Textkörper Variablen zugeordnet wurde (erforderliche Felder fehlen/Typ ist falsch).

Webhook-Trigger-Protokoll – Auf der Registerkarte „Verlauf“ der Seite mit den Planungsdetails können Sie die Details der Analyse der Plattform nach Erhalt der Anfrage sehen.

Genehmigungsbezogen

Manual_approval sendet niemals Push-Benachrichtigungen

1. Ist die Seite „Benachrichtigungskonfiguration“ an einen Kanal von Slack/Feishu/E-Mail gebunden?
2. Audit-Protokoll → Filter genehmigt_notify_failed – Sehen Sie, warum die Benachrichtigung nicht gesendet werden kann (Webhook-URL ungültig? E-Mail-Bounce?).
3. Wenn die Liste der Genehmiger leer ist, werden standardmäßig „alle Administratoren und höher“ benachrichtigt – gehört Ihr Konto dazu?

Ich habe zugestimmt, aber der Workflow wurde nicht fortgesetzt

Der Workflow nach der Genehmigung sollte innerhalb von 10 Sekunden fortgesetzt werden. Nicht länger als 1 Minute fortgesetzt:

1. Aktualisieren Sie die Seite mit den Ausführungsdetails. Läuft es bereits?
2. Das System ist ausgelastet und steht möglicherweise 30 Sekunden lang in der Warteschlange usw.
3. Erteilen Sie nach mehr als 5 Minuten einen Arbeitsauftrag.

Bezogen auf Team/Berechtigung

Nach dem Teamwechsel kann der Workflow nicht angezeigt werden

Workflows sind nach Team isoliert – sie werden nicht teamübergreifend angezeigt. Stellen Sie sicher, dass Sie das richtige Team ausgewählt haben (in der oberen rechten Ecke nach unten ziehen). Wenn Sie von „Einzelperson“ zu „Team“ wechseln, müssen Sie den Arbeitsablauf im Team neu erstellen oder von „Einzelperson“ wechseln.

Kollegen sagen, dass sie keine Berechtigung haben, einen bestimmten Arbeitsablauf zu ändern

Ist er ein Zuschauer in diesem Team? Der Viewer ist schreibgeschützt. Rüsten Sie ihn einfach vom Admin zum Editor auf.

Ich bin nicht der Eigentümer, möchte aber den von mir erstellten Workflow übertragen

„Ins Team verschieben“ erfordert, dass Sie Redakteur oder höher im Zielteam sind. Treten Sie einfach selbst dem Zielteam bei.

Bezahlen/Rechnung

Die Kreditkartenbelastung ist fehlgeschlagen

1. Abrechnungsseite → „Abbuchung erneut versuchen“. Nach drei Fehlschlägen wird das Paket vorübergehend auf „Kostenlos“ herabgestuft – es wird automatisch wiederhergestellt, sofern Sie innerhalb von 14 Tagen erfolgreich Geld abbuchen.
2. Chinesische Karten unterliegen möglicherweise der Risikokontrolle durch Stripe. Bitte verwenden Sie Alipay/WeChat Pay.

Der Rechnungstitel ist falsch

Vor der Rechnungsstellung des Folgemonats können Sie die Rechnungsanschrift auf der Abrechnungsseite ändern. Für bereits ausgestellte Rechnungen beantragen Sie per E-Mail an billing@braidrun.com die Stornierung und Neuausstellung.

Habe alles versucht, aber es funktioniert immer noch nicht

1. „Hilfe“ in der unteren rechten Ecke → Arbeitsauftrag erteilen. Hängen Sie automatisch den Browserkontext und die aktuellste Ausführungs-ID an.
2. Enterprise-Plan → Wenden Sie sich direkt an den zuständigen CSM.