Fehlerbehebung
Ein Lauf ist fehlgeschlagen
Wie du einen fehlgeschlagenen Lauf im Verlauf findest, seinen Fehler liest und die üblichen Ursachen behebst.
Ein Lauf schlägt fehl, wenn ein Schritt nicht abgeschlossen werden kann: Ein Tool meldet einen Fehler, eine App ist nicht verbunden, dem Workspace fehlen die Credits oder der Plan lässt einen Schritt nicht zu. Jeder Lauf wird gespeichert, sodass du im Nachhinein nachlesen kannst, was passiert ist.
Symptome#
- Der Agent stoppt mittendrin oder gibt eine leere oder allgemeine Antwort.
- Ein Workflow endet vorzeitig, oder eine Batch-Zeile zeigt Fehlgeschlagen.
- Ein geplanter Lauf hat nichts bewirkt.
- Nach dem Klick auf Veröffentlichen siehst du ein Fehlerbanner wie “Validierung fehlgeschlagen. Bitte korrigiere die auf den Komponenten markierten Fehler.”
Den Lauf im Verlauf finden#
- Klicke in der Seitenleiste auf Verlauf.
- Aktiviere den Filter Fehlermeldungen, um nur Sitzungen aufzulisten, die einen Fehler enthielten. Du kannst auch nach Agent oder Workflow und nach Chatbot filtern.
- Öffne eine Sitzung. Mit Einfach oder Ausführlich änderst du, wie viele Details du siehst.
- Lies die Ereignisse von oben nach unten. Sie sind mit Benutzernachricht, Chatbot-Ausgabe, Systemnachricht, Chat-Hook, Tool-Aufruf und Agent-Abfrage beschriftet. Sieh dir die Tool-Aufruf-Ereignisse an und suche dasjenige, das den Fehler meldet.
Das Metriken-Panel über der Tabelle (Metriken anzeigen) stellt Fehler insgesamt im Zeitverlauf dar. Dein Plan begrenzt, wie weit der Verlauf zurückreicht. Siehe Pläne und Limits. Bei Batch-Läufen enthält die Tabelle die Spalten Status und Fehler, und über Fehlgeschlagene erneut ausführen oder Zeile wiederholen führst du die fehlgeschlagenen Zeilen erneut aus.
Häufige Fehler und Lösungen#
| Was du siehst | Ursache | Lösung |
|---|---|---|
| “Unzureichende Credits für diese Aktion. Bitte lade deine Credits auf.” | Das Guthaben ist leer | Keine Credits mehr |
| “Workspace-Credit-Limit erreicht” | Ein Ausgabenlimit für den Workspace | Erhöhe es unter Einstellungen → Credits |
| “NAME ist nicht konfiguriert. Bitte richte zuerst die Integration ein.” | Der Schritt benötigt eine App, die nicht verbunden ist | Verbinde sie unter Integrationen |
| “…ist verbunden, es fehlen jedoch die erforderlichen Berechtigungen. Bitte verbinde die Integration erneut und erteile die zusätzlichen Berechtigungen.” | Der Verbindung fehlt eine Berechtigung | Erneut verbinden und jede Berechtigung akzeptieren |
| “…erfordert eine erneute Autorisierung. Das Refresh-Token ist abgelaufen oder wurde widerrufen. Bitte verbinde die Integration erneut.” | Die Anmeldung ist abgelaufen oder wurde widerrufen | Verbinde das Konto erneut |
| “Komponente NAME kann nur mit dem Plan … verwendet werden” | Der Schritt ist nicht in deinem Plan enthalten | Ersetze den Schritt oder führe ein Upgrade durch |
| “Erlaubtes Limit von … erreicht. Bitte führe ein Upgrade deines Plans durch.” | Du hast beim Erstellen etwas eine Obergrenze des Plans erreicht | Entferne eines oder führe ein Upgrade durch |
| “Validierung fehlgeschlagen. Bitte korrigiere die auf den Komponenten markierten Fehler.” | Bei einem Schritt fehlen erforderliche Einstellungen | Korrigiere die markierten Schritte und veröffentliche erneut |
Geplante Läufe#
Wenn dem Workspace die Credits ausgehen, schaltet das System den Zeitplan ab, statt endlos erneut zu versuchen. Öffne ihn und aktiviere ihn wieder, sobald du Credits hast. Siehe Zeitpläne.
Behebung#
- Finde die fehlgeschlagene Sitzung und kopiere den genauen Fehler.
- Ordne ihn der Tabelle zu, wende die Lösung an und führe dieselbe Eingabe erneut aus.
- Wenn der Fehler von einem externen Dienst stammt und du nicht erkennen kannst, woran es liegt, teste den Schritt einzeln von der Canvas aus. Siehe Testen und Ausführungsprotokolle.
Sieh nach, was ein Lauf gekostet hat
Prüfe Transaktionen, wenn du unsicher bist, was ein Lauf verbraucht hat. Jede Belastung ist mit Typ und Kontext aufgeführt. Siehe Credits.