Zum Inhalt springen

Referenz & Datenmodell

Durchführung (workflow_execution)

Eine Durchführung ist ein einzelner Lauf eines Workflows oder Agenten: Status, Auslöser, Schritte, Kind-Läufe und Transkript.

Die Durchführung ist die bereinigte Projektion eines Engine-Laufs. Sie enthält nur Metadaten, Status und Zeiten; Eingaben, Ausgaben und Zugangsdaten bleiben serverseitig. Jeder Lauf, auch jeder Subagent und jeder von einer Regel gestartete Workflow, erhält eine eigene Zeile und wird über parent_run_id seinem Ursprungslauf zugeordnet. (Datenart: Laufzeitdaten)

Seite Ausführungen (/executions), erreichbar über einen Workflow-Lauf in der Polaris-Seitenleiste: links die Liste mit den Reitern „Workflows“ und „Chats“ (neueste zuerst, Live-Aktualisierung), rechts der gewählte Lauf mit Kopf, „Children (n)“ und Trace. „Export“ liefert „JSON“ oder „AI digest“. Subagenten und Workflows aus Polaris erscheinen zusätzlich in dessen Seitenleiste „Agenten“. Siehe Guides › Durchführungen.

Feld Technisch Typ Pflicht Bedeutung Besonderheit
Lauf-ID run_id Text ja Engine-Kennung; Anzeige gekürzt, Kopieren möglich System
Art kind Auswahl ja „Rules“ (cel, Regel-Workflow) / „Agent“ (agent) System; Chat-Läufe zeigen „Chat“ (surface = chat)
Status status Auswahl ja siehe Zustände System
Fehlerlabel failure_label Text nein execution failed oder ceiling reached System; nie die Fehlermeldung selbst
Auslöser trigger Auswahl ja „Manual“, „CDC“, „Chat“ (conversation) System
Gestartet von initiator_user_id Verweis nein Auslösende Person; leer = „system“ System
Gestartet started_at Datum ja Zeitpunkt (Anzeige z. B. „yesterday 16:04“, „14m“) System
Beendet / Dauer finished_at Datum nein Dauer = Ende − Start, bei laufenden Läufen fortlaufend System
Workflow definition_id Verweis (Text) nein Definition mit Link; leer bei Chat-Läufen System
Version revision Zahl nein Deployment-Version, z. B. „v3“ System
Schritte gesamt steps_total Zahl nein Anzahl der Regeln bei Rules-Läufen; leer bei Agenten System; Fortschritt wird aus dem Trace abgeleitet
Fehler-Regel error_node_id Text nein Regel, an der der Lauf brach; im Trace markiert („bei Regel …“) System
Ursprungslauf / Elternlauf / Tiefe root_run_id, parent_run_id, depth Verweis / Zahl – Baum der Kind-Läufe System
Herkunft spawn_source Auswahl ja external (Trigger), planner (Polaris/Agent), workflow (von einer Regel gestarteter Agent oder Workflow) System
Aktivität activity Auswahl nein active / waiting („Wartet“ in der Polaris-Seitenleiste) System; nur während running aussagekräftig

Der Trace besteht aus Schritten: Node (node_id), Typ (node_type, z. B. cel_eval, cel_call_db, cel_spawn, llm_step), Status (status), Zusammenfassung (summary, ein bereinigter Einzeiler), Tool-Name (tool_name, nie die Argumente), Start und Ende (started_at, finished_at), Reihenfolge (seq). Bei Rules-Läufen zeigt Aligia die Schritte je Regel („Regeln“: ausgeführt, fehlgeschlagen, Bedingung falsch, nicht erreicht). Kind-Läufe erscheinen unter „Children“. Für Agenten-Schritte zeigt Aligia zusätzlich die Ausgabe des Sprachmodells (Transkript). Roh-Eingaben und -Ausgaben eines Schritts sieht nur der Ersteller.

Zu Art Pflicht Beim Archivieren Beim Löschen
Workflow-Definition gehört zu (Text, kein harter Verweis) nein bleibt bleibt
Schritt hat viele (über run_id) nein – –
Durchführung (Elternlauf) gehört zu (über parent_run_id) nein – –

Durchführungen werden nicht gelöscht oder archiviert; sie sind ein Protokoll.

Wert Label (UI) Bedeutung
pending Pending Angelegt, noch nicht gestartet
running Running In Arbeit
completed Success Erfolgreich beendet
failed Failed Fehler; Fehlerlabel execution failed
ceiling Failed Schrittlimit erreicht; Fehlerlabel ceiling reached
cancelled Cancelled Abgebrochen

Schritte: pending Pending, running Running, done Success, failed Failed, cancelled Cancelled, skipped Skipped. Ein Hinweis „child failed“ erscheint, wenn ein Kind-Lauf fehlschlug, der Hauptlauf aber „Success“ zeigt.

  • Ohne eigene Auswahl öffnet die Seite den jüngsten fehlgeschlagenen Lauf.
  • Einen laufenden Chat-Lauf stoppen Sie in Polaris über „Stoppen“; die Durchführungs-Seite bietet keinen Abbruch-Knopf.

Keine. Läufe gehen in keine KPI ein.

Trigger · Unterhaltung · Private Daten