Zum Inhalt springen
SupaCloud Docs
Farbschema wählenSprache wählen

Discord-Befehle

Der SupaCloud Discord-Steuerungs-Bot akzeptiert mit Schrägstrich eingeleitete Nachrichtentexte in jedem Kanal oder DM, in dem der Bot vorhanden ist. Der Bot startet nur, wenn DISCORD_BOT_TOKEN gesetzt ist, und ist vollständig vom workspace-spezifischen Discord-Notify/Trigger-Ressource getrennt.

Befehle

Abschnitt betitelt „Befehle“
Befehl Beschreibung
/help Zeigt die Liste der verfügbaren Befehle an.
/status Aktive Tasks.
/task <id> Task-Details.
/run <project> <agent> <prompt> Startet einen Task.
/tasks Öffnet einen schaltflächengesteuerten Picker für aktuelle Tasks (Task antippen für Details, dann Aktion wählen).
/issues [project] Öffnet den Wizard Projekt → Issue → Agent → Starten (schaltflächengesteuert).
/intervene <id> <msg> Sendet eine Nachricht an einen laufenden Task.
/approvals [tool|workflow] Listet ausstehende menschliche Entscheidungs-Gates auf; der reine Befehl listet die Workflow-Gates (Standard), tool die interaktiven Tool-/Frage-/Visual-Gates. Workflow-Gates enthalten Inline-Schaltflächen zum Genehmigen/Ablehnen (ADR 0045).
/skills [approve|reject <id>] Listet die offenen abgeleiteten Skill-Vorschläge auf oder genehmigt/lehnt einen anhand seiner ID ab. Das Entscheiden ist nur für Workspace-Admins möglich (ADR 0045).
/usage Subscription-Auslastungsfenster pro Anbieter für den aktiven Workspace (nur Admin/Owner) (ADR 0045).
/budget Der $-Budgetstatus (Obergrenze, Ausgaben, Restbetrag) — lesbar für jedes Mitglied (ADR 0045).
/autonomy [0-100] Zeigt die aufgelöste effektive Autonomie an (Level, benannter Stopp, Policy-Vorschau). Das Setzen per Chat ist noch nicht verfügbar — nutze die Web-Einstellungen oder die Management-API (ADR 0045).
/approval_mode <project> [none|pr_draft|human_gate] Zeigt den PR-Review-Freigabemodus eines Projekts an oder setzt ihn. Das Setzen ist nur für Workspace-Admins möglich (ADR 0045).
/schedule list|add|pause|resume|delete Verwaltet Zeitpläne.
/link <code> Verknüpft deine Discord-Identität mit deinem SupaCloud-Konto.

Kontoverknüpfung

Abschnitt betitelt „Kontoverknüpfung“

Führe /link <code> in einer DM mit dem Bot aus. Der Verknüpfungscode ist ein kurzlebiges Bearer-Secret; das Senden in einem Serverkanal würde ihn im gemeinsamen Verlauf offenlegen. Der Bot lehnt /link-Aufrufe außerhalb einer DM ab und fordert dich auf, es in einer DM zu wiederholen.

Um einen Verknüpfungscode zu erhalten, öffne Einstellungen in der SupaCloud-Web-Oberfläche, wechsle zum Bereich Telegram und klicke auf Link-Token generieren. Derselbe Einmal-Link-Token funktioniert sowohl für den Telegram- als auch für den Discord-Bot (POST /api/settings/telegram-link-token); eine separate Discord-Token-Seite gibt es nicht.

Nach der Verknüpfung wird deine Discord-Identität in chat_platform_accounts (Migration 130) gespeichert. Derselbe Kontodatensatz wird sowohl für den Discord- als auch für den Telegram-Steuerungs-Bot verwendet — du musst die Verknüpfung pro Plattform nur einmal vornehmen.

Schaltflächengesteuerte Abläufe

Abschnitt betitelt „Schaltflächengesteuerte Abläufe“

Zwei Befehle öffnen interaktive Schaltflächenabläufe, anstatt einfachen Text zurückzugeben:

  • /tasks — zeigt die fünf zuletzt aktiven Tasks als Schaltflächen an. Tippe auf einen Task, um seine Details anzuzeigen, und wähle dann eine Aktion.
  • /issues [project] — führt durch einen Wizard: Projekt → Issue → Agent → Starten. Lasse project weg, um zuerst danach gefragt zu werden. Schaltflächen-Interaktionen werden als Discord-INTERACTION_CREATE-Events behandelt und bearbeiten die ursprüngliche Nachricht direkt.

Live-Modus

Abschnitt betitelt „Live-Modus“

Wenn du einen Task aus Discord startest — ein direktes /run, der /run-Wizard oder der /issues-Wizard — wechselt der Bot im startenden Kanal automatisch in den Live-Modus. Jeder Task-Schritt aktualisiert eine einzelne Nachricht an Ort und Stelle: die Antwort des Agenten, eine laufende Liste der ausgeführten Tools und sein aktueller Denkprozess, alles zusammengeführt (mit Deduplizierung von Tool-Zeilen), damit der Kanal lesbar bleibt. Eine Unfollow-Schaltfläche unter der Bestätigung beendet das Streaming mit einem Tastendruck, und jeder einfache Text (kein Befehl), den du im Live-Modus sendest, wird als Intervention an den Task weitergeleitet. Die Nachricht wird abgeschlossen und der Live-Modus stoppt automatisch, wenn der Task fertig ist. Das Folgen ist oberflächenspezifisch: Ein aus Discord gestarteter Task streamt nur in Discord.

Task-TL;DR-Benachrichtigungen

Abschnitt betitelt „Task-TL;DR-Benachrichtigungen“

Wenn ein Task fertig ist, wird eine kurze TL;DR — ein Status-Glyph und die Ergebnis-Zusammenfassung — an das verknüpfte Discord-Konto des Task-Eigentümers gesendet. Ein Opt-out-Schalter pro Konto in den Chat-Konto-Einstellungen schaltet sie ab. Ohne verknüpftes Discord-Konto gibt es nichts zu senden.

Siehe auch

Abschnitt betitelt „Siehe auch“