Debug-Modus verwenden
Standardmäßig zeigt dir ein Live-Feed die Arbeit des Agenten – seine Nachrichten, Tool-Zeilen und Ergebnisse –, verbirgt aber die Orchestrierung darunter. Der Debug-Modus öffnet diese Haube für eine Sitzung: Er macht die internen Operationen im Live-Feed sichtbar, sodass du genau siehst, was der Agent und die Laufzeitumgebung tun.
Das Einschalten ist ein zweistufiger Ablauf, und genau diese Trennung ist das gesamte Sicherheitsmodell:
- Ein Workspace-Admin öffnet die
allow_debug-Obergrenze – einen Schalter pro Workspace, der Debug erlaubt. Sie ist standardmäßig aus. - Ein Benutzer aktiviert Debug dann nur für seine aktuelle Live-/Follow-Sitzung.
Debug ist flüchtig und pro Sitzung: Es wird nie persistiert, gilt nur für die eine Live-Sitzung, in der du es einschaltest, und wird serverseitig durchgesetzt – ein Benutzer kann interne Operationen also niemals sichtbar machen, solange die Admin-Obergrenze nicht offen ist.
Was der Debug-Modus sichtbar macht
Abschnitt betitelt „Was der Debug-Modus sichtbar macht“Mit eingeschaltetem Debug fügt der Live-Feed die Laufzeit-Details hinzu, die er normalerweise unterdrückt:
| Interne Operation | Was du siehst |
|---|---|
| MCP-Tool-Aufrufe | Jedes supacloud.*-Tool, das der Agent aufruft, mit seiner Stufe |
| Scope-Auflösung | Wie ein Secret-/Credential-Scope aufgelöst wird (Vorrang Benutzer / Workspace / Organisation) |
| Automatische Gate-Auflösungen | Wenn ein Freigabe-Gate automatisch durch seine Timeout-Richtlinie aufgelöst wird |
| Gefahr-Eskalationen | Wenn ein Gefahrensignal mitten im Lauf eine Hold-Freigabe erzwingt |
Dies sind dieselben Ereignisse, die die Laufzeitumgebung immer aussendet; der Debug-Modus steuert nur, ob sie in deinem Feed angezeigt werden.
Schritt 1 – die Workspace-Debug-Obergrenze öffnen (Admin)
Abschnitt betitelt „Schritt 1 – die Workspace-Debug-Obergrenze öffnen (Admin)“Ein Workspace-Admin entscheidet, ob Debug im Workspace überhaupt erlaubt ist.
-
Öffne Einstellungen → Arbeitsbereich.
-
Finde die Debug-Steuerung und schalte die Obergrenze Debug erlauben ein.
-
Speichern.
Schritt 2 – Debug für deine Live-Sitzung einschalten (Benutzer)
Abschnitt betitelt „Schritt 2 – Debug für deine Live-Sitzung einschalten (Benutzer)“Sobald die Obergrenze offen ist, kann jeder Benutzer Debug für die Live-/Follow- Sitzung aktivieren, in der er sich gerade befindet. Es gilt für genau diese eine Sitzung und nichts anderes.
Im Web-Terminal unter /cli, während du in einer Live-Sitzung bist (nach run,
follow oder logs --follow):
debug on # interne Operationen in dieser Live-Sitzung sichtbar machendebug off # sie wieder ausblendendebug on wirkt sofort für die als Nächstes eintreffenden Ereignisse – der Feed
beginnt, die oben beschriebenen MCP-Tool-Aufrufe, Scope-Auflösungen, automatischen
Gate-Auflösungen und Gefahr-Eskalationen einzubeziehen. debug off bringt den Feed
zurück zur normalen, operationsfreien Ansicht.
In einer /follow-Live-Sitzung schaltest du Debug um mit:
/debug on # interne Operationen in dieser Follow-Sitzung sichtbar machen/debug off # sie wieder ausblendenDie gestreamten Task-Nachrichten enthalten dann die internen Operationen, bis du es ausschaltest oder die Sitzung endet.
In einer /follow-Live-Sitzung auf Discord schaltest du Debug um mit:
/debug on # interne Operationen in dieser Follow-Sitzung sichtbar machen/debug off # sie wieder ausblendenDebug verhält sich genau wie auf Telegram und im Web-Terminal: Dieselbe
Workspace-Admin-Obergrenze allow_debug setzt es voraus, und der Schalter ist
pro Sitzung und flüchtig. Die gestreamten Task-Nachrichten enthalten die internen
Operationen, bis du es ausschaltest oder die Sitzung endet.
Wenn eine Sitzung wiederhergestellten Kontext fortsetzt
Abschnitt betitelt „Wenn eine Sitzung wiederhergestellten Kontext fortsetzt“Wenn eine Follow- oder Live-Sitzung Kontext aus früherer Arbeit wiederherstellt, öffnet sie mit einer einzeiligen Zusammenfassung oben im Feed, zum Beispiel:
Sitzung fortgesetzt – 2 Berechtigungen wiederhergestellt, 5 Erinnerungen synthetisiertSie sagt dir, noch vor der ersten neuen Zeile des Agenten, dass die Sitzung dort anknüpft, wo frühere Arbeit aufgehört hat. Die Zusammenfassung erscheint bei jeder Ausführlichkeit; sie ist unabhängig vom Debug-Modus. Unter Erinnerungen verwalten erfährst du, was diese Erinnerungen sind und wie du sie prüfst.