Agenten-Aktionen freigeben oder ablehnen

Wenn ein autonomer Agent an einen Punkt gelangt, den er ohne einen Menschen nicht passieren sollte, pausiert er und fragt eine Freigabe an. SupaCloud zeigt diese eine ausstehende Entscheidung als interaktive Freigabe an, die du von jeder Steuerungsoberfläche aus beantworten kannst – dem Web-Terminal, Telegram oder Discord. Der Agent bleibt genau auf dieser Entscheidung blockiert, bis du antwortest (oder seine Timeout-Richtlinie sie für dich auflöst).

Es gibt drei Arten von Freigaben:

Art	Was es ist	Beispiel
Tool	Ein gefährlicher Tool-Aufruf, den der Agent ausführen möchte	Ein `Bash`-Befehl, ein Deploy, eine Migration
Frage	Eine offene Frage, die der Agent vor dem Fortfahren stellt	„Welche Umgebung soll ich ansteuern?“
Visuell	Eine Vorher/Nachher-Screenshot-Abnahme	Eine UI-Änderung, aufgenommen zur menschlichen Prüfung

Über das Web-Terminal freigeben

Im Web-Terminal unter /cli listest du jeden pausierten Agenten im aktiven Workspace auf und entscheidest einen anhand seiner kurzen ID.

Einzelbefehle
Live-Modus

# Die im Workspace wartenden interaktiven Freigaben auflisten
tool-approvals

# Eine anhand ihrer (kurzen) Freigabe-ID freigeben oder ablehnen; eine
# optionale Notiz wird dem Agenten als deine Begründung / Antwort übergeben
approve-tool <id> [note]
reject-tool <id> [note]

Die ID wird per Präfix aufgelöst – genauso wie Task-IDs: Ein eindeutiges Präfix entscheidet das Gate; ein mehrdeutiges oder unbekanntes Präfix wird gemeldet, statt geraten.

Du kannst auch interaktive und Workflow-Freigaben zusammen auflisten:

approvals                     # beide Quellen, jeweils unter eigener Überschrift
approvals --filter=tool       # nur die interaktiven Tool-/Frage-/Visuell-Gates
approvals --filter=workflow   # nur Workflow-Human-Gates

Nachdem du einem Task mit follow (oder run) folgst und er pausiert, stellt das Terminal das Gate inline dar – die Art, den Tool-Namen oder die Frage und etwaige Vorher/Nachher-Bild-URLs – und wartet dann auf deine nächste Eingabezeile:

approve, yes, y oder ok gibt frei. Alles nach dem Verb wird als deine Notiz gesendet.
reject, no, n oder deny lehnt ab, mit optionaler Begründung.
Bei einem Frage-Gate wird eine reine Freitext-Zeile (ohne Verb) als Antwort behandelt und gibt das Gate frei, wobei dein Text an den Agenten zurückgereicht wird.

Über Telegram oder Discord freigeben

Wenn ein dir gehörender Task pausiert, postet SupaCloud eine Freigabe-Karte in deinen verknüpften Chat – eine Nachricht mit der Art, dem maskierten Detail, etwaigen Vorher/Nachher-Bildvorschauen und Inline-Buttons Freigeben / Ablehnen. Tippe einen Button an, um zu entscheiden.

Telegram
Discord

Ein pausierter Task pusht die Karte automatisch in den mit dem Task-Eigentümer verknüpften Chat. Tippe Freigeben oder Ablehnen; der Bot antwortet mit einer Bestätigung.

Um jederzeit zu prüfen, was wartet:

/approvals          # sowohl Human-Gate- als auch interaktive Freigaben
/approvals tool     # nur die interaktiven Tool-/Frage-/Visuell-Gates
/approvals workflow # nur Workflow-Human-Gates

Dieselbe Karte wird an die verknüpfte Discord-Identität gepostet, mit Buttons Freigeben / Ablehnen. Visuell-Gates betten die Vorher/Nachher-Screenshots inline ein.
Ausstehende Freigaben auflisten mit:
```
/approvals
```

Die visuelle Vorher/Nachher-Karte

Eine visuelle Freigabe ist eine Abnahme einer UI-Änderung. Die Karte enthält:

Die Vorher/Nachher-Screenshots als signierte, zeitlich begrenzte Bild-Links (Telegram zeigt eine Vorschau, Discord bettet sie ein; im Web-Terminal werden sie als URLs ausgegeben).
Das Maschinen-Urteil, sofern eines lief – PASS, FAIL oder nicht ausgeführt – menschliche Prüfung – gefolgt von den Gründen, die der Prüfer angab, damit du siehst, warum die automatische Prüfung die Änderung als bestanden oder durchgefallen einschätzt, bevor du entscheidest.

Lassen sich die Screenshot-Links nicht erzeugen (das Capture-Serve-Geheimnis ist nicht gesetzt), reduziert sich die Karte auf reinen Text: Sie listet weiterhin auf, was aufgenommen wurde, sowie das Urteil, sodass du stets entscheiden kannst.

Was beim Timeout einer Freigabe passiert

Jede Freigabe trägt eine Timeout-Richtlinie, die festlegt, was geschieht, wenn kein Mensch antwortet:

Richtlinie	Verhalten	Verwendet für
Hold	Blockiert für immer, bis ein Mensch entscheidet – nie automatisch aufgelöst	Deploys, Migrationen und jede Aktion, die auf einen Menschen warten muss
Deny	Nach einer Frist automatisch abgelehnt, sodass der Agent ohne die Aktion fortfährt	Optionale Fragen und risikoärmere Gates

Die deny-Fristen sind je nach Art unterschiedlich: Ein Tool wartet 5 Minuten, eine Frage 30 Minuten und eine visuelle Abnahme 1 Stunde. Läuft ein deny-Gate ab, wird der Agent mit einer Ablehnung entsperrt und fährt fort; ein hold-Gate wartet einfach.