Dein erster Workflow

Hier kommst du von der Anmeldung zu deinem ersten erfolgreichen Lauf. Du beschreibst eine Aufgabe im Chat, speicherst den Workflow, gibst ihn frei, startest ihn und liest das Ergebnis. Das funktioniert in SubKit Cloud und auf einer selbst betriebenen Engine gleich.

Was du brauchst #

Ein SubKit-Konto in einem Arbeitsbereich. - Cloud: https://subkit-cloud.mikebild.info - Selbst betrieben: https://<deine-engine>/cockpit
Das Recht, Workflows anzulegen und zu starten. Fehlt ein Button, bitte eine Administratorin oder einen Administrator darum.
Einen KI-Anbieter. Die Cloud stellt ihn bereit. Eine selbst betriebene Engine nutzt den Anbieter, den du bei sk init gewählt hast.

Anmelden #

Öffne das Cockpit.
Wähle Mit Firmenkonto anmelden.

Du landest in deinem Arbeitsbereich auf Übersicht. Selbst betrieben ohne Anmeldeanbieter? Wähle stattdessen Mit API-Schlüssel anmelden und gib deinen Schlüssel ein.

Die Aufgabe beschreiben #

Öffne in der Navigation Chat.
Wähle Neue Unterhaltung.
Beschreibe die Aufgabe in einfachen Worten: was hineingeht, was passieren soll, was herauskommt. Beispiel: „Hol die offenen Issues meines GitHub-Repositorys und gib mir eine kurze Liste mit Titel und Link.“
Beantworte die Rückfragen von SubKit. Braucht die Aufgabe einen Dienst, bittet dich SubKit, ihn zu verbinden oder dich dort anzumelden.

Gut zu wissen: Eine kleine Aufgabe lässt sich leichter prüfen. Erweitern kannst du den Workflow später im selben Chat.

Den Workflow speichern #

Ist der Workflow fertig, zeigt SubKit eine Karte Workflow-Entwurf speichern.

Öffne Was sich ändert und lies, welche Schritte und Ziele enthalten sind.
Wähle Inaktive Version speichern.

Speichern startet nichts. Der Workflow erscheint jetzt unter Workflows.

Ohne Chat legst du einen Workflow unter Workflows mit Workflow erstellen an. Der Assistent führt dich durch Wie, Was, Wann und Prüfen.

Freigeben, was er berühren darf #

Eine neue Version berührt nichts außerhalb von SubKit, bis ein Mensch sie freigibt. Ohne Freigabe startet ein Lauf nur als Probelauf ohne Wirkung.

Öffne Workflows und klicke auf deinen Workflow. Seine Seite öffnet sich mit dem Tab Übersicht. Die Statuszeile zeigt Wartet auf Freigabe oder Nicht freigegeben.
Wähle in der Statuszeile Freigeben.
Prüfe Umgebung, Gültigkeit sowie Operationen und externe Ziele.
Bestätige mit Freigeben. Nur übernehmen übernimmt die Version, ohne Läufe freizugeben.

Freigabedialog für „Invoice export v1“ mit der Umgebung „Test“, der Gültigkeit „Bis auf Widerruf“, einem Lesezugriff auf die Sales reporting API, keinem Schreibzugriff und den Schaltflächen „Nur übernehmen“ und „Freigeben“ — Screenshot aus Build 10.6.0

Die Freigabe startet keinen Lauf. Eine Freigabe gilt für eine Umgebung und eine Dauer. Auch eine neue Version, deren Grenze nicht wächst, ist davon gedeckt. Im Tab Freigaben kannst du sie jederzeit widerrufen. Bietet dir der Chat eine Freigabe an, öffnet sie denselben Dialog.

Feld	Was es festlegt
Umgebung	Wo die Läufe erlaubt sind, zum Beispiel Produktion.
Operationen und externe Ziele	Welche Dienste und Adressen der Workflow erreicht. Jeder Dienst trägt das Logo seines Anbieters.
Gültigkeit	Wie lange die Freigabe gilt: 7 Tage, 30 Tage oder Bis auf Widerruf.

Den Workflow starten #

Wähle auf der Workflow-Seite Starten.
Fülle das Formular aus, wenn der Workflow Eingaben verlangt. JSON gibst du nur unter Als JSON eingeben ein.
Wähle Starten, um zu bestätigen. Der Dialog sagt Startet einen Lauf mit der freigegebenen Version. Ohne Freigabe heißt der Button Probelauf starten.

Du siehst Lauf gestartet. Ist der Button nicht verfügbar, nennt der Hinweis den Grund, zum Beispiel Schalte den Workflow vor dem Starten ein.

Das Ergebnis prüfen #

Öffne auf der Workflow-Seite den Tab Verlauf. Der neueste Lauf steht oben, mit seinem Status. Erfolgreich heißt, der Lauf ist durchgelaufen.
Klicke auf den Lauf. Du siehst jeden Schritt mit seiner Ausgabe. Ein fehlgeschlagener Schritt zeigt Fehler in Schritt „…“ mit der Ursache. (öffnet in einem neuen Tab)Screenshot aus Build 10.6.0
Optional: Wähle Im Audit-Trail, um zu sehen, wer den Lauf gestartet und freigegeben hat.

Dasselbe prüfst du mit der sk-CLI:

sk executions list --limit 5
sk executions steps <run-id>
sk executions result <run-id>

sk workflows run <workflow-slug> --follow startet einen weiteren Lauf und zeigt seine Schritte live.

Wenn etwas nicht klappt #

Was du siehst	Was du tust
Das Ergebnis des Laufs ist mit Ergebnis des Probelaufs – nicht geschrieben überschrieben	Die Version ist noch nicht freigegeben. Folge „Freigeben, was er berühren darf“.
„Nicht gestartet (…): Für diesen Lauf gibt es keine gültige Freigabe.“	Die Freigabe fehlt, ist abgelaufen oder aufgebraucht. Gib erneut frei oder verlängere sie.
„… muss neu verbunden werden“	Öffne den Konnektor unter Konnektoren und wähle Neu anmelden.
Du darfst diesen Workflow nicht starten.	Bitte eine Administratorin oder einen Administrator um eine Rolle, die Workflows starten darf.
Ein Schritt ist fehlgeschlagen	Öffne den Lauf, lies den Fehler und beschreibe ihn im selben Chat. SubKit schlägt eine Korrektur vor, die du erneut prüfst.