Deinen ersten Workflow erstellen

Am Ende dieses Tutorials hast du einen funktionierenden Multi-Node-Workflow: einen Agent-Node, der eine Aufgabe erledigt, einen Gate-Node, der das Ergebnis verzweigt, einen Human-Node, der auf deine Freigabe wartet, und einen eingerichteten manuellen Trigger, der alles startet. Anschließend wirst du ihn ausführen und sein YAML exportieren. Plane etwa zwanzig Minuten ein.

Was du benötigst

• Einen SupaCloud-Workspace mit mindestens einem Projekt.
• Die Workspace-Rolle admin oder member (Viewer können keine Workflows erstellen).

1. Den Workflow-Builder öffnen

1. Öffne Build → Workflows.

2. Klicke auf Neuer Workflow. Der Builder öffnet sich in einem neuen Vollbild-Canvas – die Kopfzeile zeigt das Namensfeld des Workflows, einen Canvas / YAML-Umschalter und den Run-Button.

3. Klicke auf das Namensfeld und gib einen Namen ein, zum Beispiel review-and-approve.

Das Canvas öffnet sich mit einem leeren Flow. Das linke Panel ist die Node-Palette – sechs aufklappbare Gruppen (Flow Control, Agent & AI, Code, Data, Notify, Mail) sowie Trigger-Abschnitte. Verwende Strg+K, um die Palette-Suchleiste jederzeit zu fokussieren.

2. Einen Trigger hinzufügen

Ein Workflow startet erst, wenn mindestens ein Trigger konfiguriert ist. In diesem Tutorial verwendest du die einfachste Option: Manuell.

1. Öffne in der Palette die Trigger-Gruppe Manual & Time.

2. Klicke auf die Kachel Manual (gestrichelter Rahmen). Ein Trigger-Node mit der Bezeichnung manual erscheint in der Trigger-Lane oben im Canvas, und die Symbolleiste zeigt ein Trigger-Badge.

Tipp

Trigger sind eine Konfiguration auf Workflow-Ebene – keine Canvas-Nodes, die du mit anderen Schritten verbindest. Die Trigger-Lane befindet sich oberhalb des Hauptflow-Bereichs und ist visuell abgetrennt.

3. Einen Agent-Node hinzufügen

1. Öffne in der Palette die Gruppe Agent & AI und klicke auf Agent. Ein Agent-Node wird auf dem Canvas abgelegt.

2. Klicke auf den Node, um ihn auszuwählen. Das Properties-Panel öffnet sich auf der rechten Seite.

3. Vergib einen Node-Key – einen kurzen Bezeichner für das Templating, zum Beispiel review. Node-Keys müssen innerhalb des Workflows eindeutig sein.

4. Wähle einen Agent-Typ aus dem Dropdown (zum Beispiel claude).

5. Schreibe ein Prompt im Feld Prompt, zum Beispiel:

   Review the latest commit in ${{ trigger.repository }} and summarise findings.

   Der Namespace ${{ trigger.* }} ermöglicht den Zugriff auf den Trigger-Payload; ${{ steps.<key>.<field> }} referenziert das Ergebnis eines vorgelagerten Nodes (die Felder branch, summary, pr_url oder cost des Agent-Schritts).

6. Klicke in der Symbolleiste auf Speichern (oder drücke den entsprechenden Button), um die Änderung zu sichern.

4. Einen Gate-Node hinzufügen

Ein Gate wertet eine boolesche Bedingung über die vorgelagerte Ausgabe aus und verzweigt den Run auf einen true- oder false-Pfad – kein LLM-Aufruf, kein Task, direkt durch die Engine ausgewertet.

1. Öffne in der Palette die Gruppe Flow Control und klicke auf Gate. Ein rautenförmiger Gate-Node erscheint.

2. Wähle ihn aus, um sein Properties-Panel zu öffnen.

3. Setze seinen Node-Key auf check.

4. Erstelle die Bedingung mit dem Condition Builder – zum Beispiel:

   • Links: nodes.review.task_status
   • Operator: eq
   • Rechts: completed

   Damit wird der true-Handle ausgelöst, wenn der Agent-Node erfolgreich abgeschlossen wurde.

5. Verbinde die Nodes: Fahre mit der Maus über den out-Handle am unteren Rand des review-Agent-Nodes, bis er aufleuchtet, und ziehe ihn dann zum oberen (Eingangs-)Handle des check-Gate-Nodes. Lasse los, um die Verbindung herzustellen.

Die Gate-Karte zeigt ein TRUE-Label am unteren linken Handle und ein FALSE-Label am unteren rechten Handle. In der Run-Ansicht wird der ausgelöste Zweig hervorgehoben.

5. Einen Human-Node hinzufügen

Der Human-Node pausiert den Run und wartet darauf, dass eine Person ihn freigibt oder ablehnt, bevor einer der Zweige fortgesetzt wird. Er ist über die Web-UI und über Telegram erreichbar.

1. Öffne in der Palette die Gruppe Flow Control und klicke auf Human. Ein Human-Node erscheint.

2. Wähle ihn aus und setze seinen Node-Key auf approve.

3. Fülle das Feld Freigabetitel aus: Bereit zum Mergen?

4. Fülle optional das Feld Instructions mit Kontext für die genehmigende Person.

5. Verbinde den true-Handle des check-Gate-Nodes mit dem Eingangs-Handle des approve-Human-Nodes.

6. Füge für den false-Pfad einen End-Node aus der Palette hinzu, setze seinen Key auf skip, und verbinde den false-Handle von check damit. Dies beendet den Run sauber, wenn die Bedingung nicht erfüllt ist.

Approved- und Rejected-Handles

Der Human-Node stellt zwei Ausgangs-Handles bereit: approved (unten links) und rejected (unten rechts). Verbinde jeden mit dem passenden nächsten Schritt. Ein Run verbleibt im Zustand waiting, bis du (oder ein Teammate) eine Entscheidung auf der Run-Detailseite oder über den Telegram-Bot absendest.

6. Die verbleibenden Pfade verbinden und das Canvas aufräumen

1. Füge einen weiteren End-Node (Key: done) hinzu und verbinde den approved-Handle von approve damit.

2. Füge einen letzten End-Node (Key: rejected) hinzu und verbinde den rejected-Handle von approve damit.

3. Klicke in der Symbolleiste auf Tidy, um den Graphen automatisch in einem sauberen Top-to-Bottom-Flow anzuordnen.

4. Klicke auf Speichern.

Dein Canvas enthält jetzt: [Manueller Trigger] → review → check → (true) approve → approved/rejected ends; (false) skip end.

7. Den Workflow ausführen

1. Klicke in der Symbolleiste oben rechts auf den Run-Button (Play-Symbol). Der Run startet sofort mit dem manuellen Trigger.

2. Du gelangst auf die Run-Detailseite – jeder Node zeigt seinen aktuellen Zustand (pending, running, completed, skipped, waiting).

3. Wenn der Run den approve-Human-Node erreicht, tritt er in den Zustand waiting und der Node pulsiert auf dem Canvas. Öffne die Run-Detailseite und verwende den Button Approve oder Reject, um ihn aufzulösen.

Tipp

Du kannst einen Human-Node auch über den Telegram-Bot auflösen: Der Bot sendet eine Nachricht mit Inline-Buttons für Approve / Reject, sobald der Run in waiting übergeht.

8. Das YAML exportieren

Der vollständige typisierte Node-Graph des Workflows wird über ein serverautoritatives YAML-Format übertragen – nützlich für Versionskontrolle, Weitergabe oder den Import in einen anderen Workspace.

1. Klicke in der Symbolleiste auf den YAML-Umschalter (neben Canvas).

2. Klicke auf Exportieren, um den aktuell gespeicherten Graphen in das Editor-Panel zu laden.

3. Klicke auf Kopieren, um ihn in die Zwischenablage zu kopieren, oder bearbeite ihn direkt und klicke auf Als neu importieren, um einen neuen Workflow aus dem geänderten YAML zu erstellen.

Das YAML kodiert jeden Node (kind, key, config) und jede Verbindung (source_handle) und bewahrt dabei die Verzweigungslogik exakt.

Was du gelernt hast

• Die Node-Palette gliedert alle Node-Typen in einklappbare Gruppen; Strg+K fokussiert die Suche.
• Trigger befinden sich auf einer eigenen Trigger-Lane – füge sie über die Trigger-Abschnitte der Palette hinzu.
• Agent-Nodes führen eine Aufgabe aus; Gate-Nodes verzweigen anhand einer Bedingung (true- / false-Handles); Human-Nodes pausieren für eine Entscheidung (approved- / rejected-Handles); End-Nodes beenden einen Zweig.
• Verbinde Nodes, indem du von einem Quell-Handle zu einem Ziel-Handle ziehst.
• Tidy ordnet das Canvas automatisch an; Speichern sichert; Run startet einen manuellen Run.
• Das YAML-Panel exportiert den vollständigen typisierten Node-Graphen für Versionskontrolle oder Import.

Nächste Schritte

• Referenz der Web-Terminal-Befehle – starte einen Workflow über die CLI mit workflow trigger <id>.
• Dein erster Agent-Run – verstehe, wie Agent-Tasks innerhalb eines Workflows funktionieren.
• Workspaces und Organisationen