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)
Wo in der App
Abschnitt betitelt „Wo in der App“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 |
Schritt (workflow_execution_step)
Abschnitt betitelt „Schritt (workflow_execution_step)“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.
Beziehungen
Abschnitt betitelt „Beziehungen“| 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.
Zustände
Abschnitt betitelt „Zustände“| 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.
Regeln & Automatik
Abschnitt betitelt „Regeln & Automatik“- 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.
Kennzahlen
Abschnitt betitelt „Kennzahlen“Keine. Läufe gehen in keine KPI ein.