> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# KI-Orchestrierung und Workflow-Ausführung

> Verstehen Sie die Workflow-Ausführung, MAIP-Tracking-Datensätze, aufgezeichnete Ergebnisse und aktuelle Integrationsgrenzen.

Truthlocks verfügt über zwei unterschiedliche Workflow-Schnittstellen. Wählen Sie die Schnittstelle vor dem Aufbau einer Integration; ihre Bezeichner, Nutzlasten und Ausführungsverhalten unterscheiden sich.

| Schnittstelle | Was sie tut | Wo sie verwendet wird |
| - | - | - |
| Console Workflow-Engine | Startet einen gespeicherten Graphen über einen Temporal Worker und zeichnet dessen Schritte und Endergebnisse auf. | Console Workflow-Designer und Ausführungsverlauf. |
| MAIP-Orchestrierungs- und Workflow-APIs | Speichern Sie Definitionen, Ausführungsverfolgungsdatensätze und zugehörige Agentenbeweise. Diese Routen starten den Console Temporal Worker nicht. | Öffentliche `/v1/orchestrate/...` Referenzen. |

## Console-Workflow-Läufe

Speichern Sie den Graphen im Workflow-Designer, überprüfen Sie seine Verbindungen und starten Sie ihn mit den vorgesehenen Triggerdaten. Eine erfolgreiche Startantwort bedeutet, dass Temporal die Anfrage akzeptiert hat; es bedeutet nicht, dass die Arbeit abgeschlossen ist.

Öffnen Sie **Ausführungsverlauf** und aktualisieren Sie den Datensatz, um Folgendes zu überprüfen:

* `pending`: Die Anfrage ist gespeichert, aber der Worker-Start wurde noch nicht erfasst.
* `running`: Der Worker hat seinen Start aufgezeichnet.
* `completed`: Die ausgewählten Schritte wurden abgeschlossen und das Endergebnis wurde gespeichert.
* `failed`: Ein Schritt oder eine Workflow-Operation ist fehlgeschlagen. Überprüfen Sie die aufgezeichneten Schritte, bevor Sie Nebenwirkungen erneut versuchen.
* `cancelled`: Die Stornierung wurde beobachtet und der Worker hat das Endergebnis gespeichert.

Wählen Sie **Einstellungen → Umgebungen**, bevor Sie einen Workflow erstellen oder starten. Das Wechseln von Umgebungen kopiert keine Definitionen oder Ausführungen. Ein Workflow aus einer anderen Umgebung kann nicht über die aktuelle Umgebung gelesen, veröffentlicht, pausiert oder gestartet werden. Die Produktionsauswahl erfordert weiterhin die Genehmigung des Arbeitsbereichs.

Diese Datensatzgrenze simuliert keine externen Anbieter: ein unterstützter KI- oder E-Mail-Schritt kann eine echte Anbieteranfrage stellen. Verwenden Sie synthetische Eingaben und explizit autorisierte Empfänger während des Tests.

Neue Ausführungen erfassen den gespeicherten Graphen beim Start. Spätere Bearbeitungen ändern diese Ausführung nicht. Das Ergebnis enthält die Definitionsversion und den SHA-256-Digest, temporale Ausführungsbezeichner, Zeitstempel, von Schritten gemeldete Kosten und die JSON-Schrittausgabe. Ältere Ausführungen verfügen möglicherweise nicht über diese Informationen; sie werden nicht rekonstruiert oder gefälscht.

Der Runner lehnt Zyklen und ungültige Verbindungen ab. Bereite Schritte werden in der Definitionsreihenfolge ausgeführt. Ein gemeinsamer nächster Schritt wartet auf seine Vorgänger und wird einmal ausgeführt, wenn mindestens ein eingehender Pfad ausgewählt ist. Eine Verzweigung wählt eine genaue Bedingung, bevor sie ihre Standardverbindung berücksichtigt.

Ein Laufergebnis ist ein operativer Nachweis, nicht automatisch ein kryptografisches Proof Bundle. `proof_status: "not_generated"` bedeutet explizit, dass kein Bundle generiert wurde. Ein aufgezeichneter Kostenwert von Null bedeutet nicht, dass ein externer Anbieter nichts berechnet hat.

### E-Mail-Benachrichtigungsschritt

Verwenden Sie einen Empfänger pro Schritt und geben Sie expliziten Text an:

```json theme={null}
{
  "id": "notify-reviewer",
  "name": "Notify reviewer",
  "type": "notify",
  "config": {
    "channel": "email",
    "recipients": ["reviewer@your-company.example"],
    "subject": "Your review is ready",
    "text_body": "Open your workspace to review the recorded result."
  }
}
```

Das Ergebnis meldet `provider_accepted` und eine Nachrichten-ID, nachdem der konfigurierte SMTP-Anbieter die Nachricht akzeptiert hat. Es garantiert keine Zustellung im Posteingang. Benannte Vorlagen, mehrere Empfänger in einem Schritt und Nicht-E-Mail-Kanäle werden von dieser Aktivität nicht unterstützt. Automatische Wiederholungen sind deaktiviert, da SMTP keine genau einmalige Zustellung garantieren kann. Untersuchen Sie einen unbestätigten Versuch, bevor Sie erneut senden.

### Zu berücksichtigende Ausführungsgrenzen

* Ein Start-Timeout kann einen `pending`-Datensatz hinterlassen, selbst wenn Temporal die Anfrage akzeptiert hat. Überprüfen Sie diesen Lauf, bevor Sie einen weiteren starten; die automatisierte Versandabstimmung bleibt unvollständig.
* Console Schritte zur menschlichen Überprüfung behalten zugewiesene Genehmigungsanfragen bei. Autorisierte Genehmigungs-/Ablehnungsentscheidungen und ihre zeitlichen Ergebnisse haben die scoped Live-Akzeptanz bestanden. Eine separate MAIP Agenten-Genehmigungsaufzeichnung signalisiert keinen Console Workflow.
* KI-Schritte verwenden das konfigurierte Gemini-Gateway; ein synthetischer Temporal-zu-Gemini-Lauf hat die Live-Akzeptanz bestanden. Validieren Sie Ihre eigene Eingabeaufforderung, Ausgabebedingungen und Kosten.
* Externe `tool_call`-Schritte sind in der bereitgestellten Connector-Laufzeit nicht verfügbar. Behalten Sie diese Graphen als Entwürfe; sie können nicht für die Produktionsautomatisierung von Tools verwendet werden. Ein externes Integrationspaket aktiviert keinen Workflow-Connector.
* Ein Hintergrund-Worker gleicht bekannte Temporal-Ausführungsbezeichner ab, einschließlich terminaler Fehler und "continued-as-new"-Übergänge. Er leitet keine erfolgreichen Effekte aus fehlender Historie ab und kann eine unbekannte Versandidentität nicht wiederherstellen.
* Workflow-Definitionen, -Ausführungen, -Schritte und -Genehmigungen, die nach der Umgebungstrennung erstellt wurden, sind auf die ausgewählte Arbeitsbereichsumgebung beschränkt. Historische Aufzeichnungen ohne verifizierte Umgebungszuordnung bleiben der Plattformaufsicht zugänglich; sie werden nicht stillschweigend der Produktion zugewiesen. Eine breitere anbieterseitige Isolation und alle externen Nebenwirkungswiederherstellungen werden durch diese Speichergrenze nicht hergestellt.
* Workflow-Audit-Ereignisse werden mit Statusänderungen gespeichert. Dies begründet keinen abgeschlossenen Export an jedes externe Audit-Ziel oder eine unabhängig zertifizierte Aufbewahrungsrichtlinie.

## MAIP-Ausführungsverfolgung

Die öffentliche [Orchestrierungs-Ausführungsreferenz](https://docs.truthlocks.com/de/api-reference/machine-identity/orchestrations/execute.md) dokumentiert `pattern`, `orchestrator_id` und `agent_ids`. Verwenden Sie die generierten Felder und Dropdowns für den vollständigen Anforderungsvertrag.

Eine HTTP-`201`-Antwort erstellt einen Tracking-Datensatz. Ihr anfänglicher `running`-Status ist kein Beweis dafür, dass Agenten oder Tools ausgeführt wurden. Führen Sie diese Aktionen in Ihrer Anwendung aus und überwachen Sie sie, bis ein unterstützter Executor verbunden ist.

Die [MAIP Workflow-Ausführungsreferenz](https://docs.truthlocks.com/de/api-reference/machine-identity/workflows/execute.md) ist eine separate Route zur Datensatzerstellung, die `trigger_agent_id` erfordert. Ersetzen Sie keine Console Graph-IDs und gehen Sie nicht davon aus, dass ein bereitgestellter Zeitplan einen Temporal-Zeitplan registriert.

Neue automatisch generierte MAIP-Belege verwenden den konfigurierten verwalteten Signierer. Verifizieren Sie einen Beleg über die Belegverifizierungs-API. Seine Signatur authentifiziert die aufgezeichnete Aussage; sie beweist nicht, dass eine nicht ausgeführte Geschäftsaktion stattgefunden hat. Einige erhaltene historische Aufzeichnungen haben nicht verifizierbare Platzhalter-Signaturen.

Für unabhängige menschliche Entscheidungen über eine vorgeschlagene Agentenaktion verwenden Sie [Agentenfreigaben](https://docs.truthlocks.com/de/guides/agent-approvals.md). Genehmigungsdatensätze führen einen Workflow nicht automatisch aus oder setzen ihn fort.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.