Für Entwickler
Nutzen Sie einen KI-Workflow wie eine API
Auslösen, Ergebnisse abfragen, Freigaben bearbeiten, Artefakte abholen — alles über REST, ohne dass Sie Modellaufrufe, Wiederholungen und Warteschlangen selbst pflegen müssen.
# Eine Ausführung auslösen POST /api/webhooks/{id}/trigger → {"executionId": "exec_51a2"} # Status abfragen: diesmal an der manuellen Freigabe angehalten GET /api/v1/executions/exec_51a2 → {"status": "AWAITING_APPROVAL"} # Nach der Freigabe weiterlaufen (Werte lassen sich vor der Freigabe ändern) POST /api/v1/approvals/{approvalId}/approve # Nach Abschluss Ergebnis und Artefakte abholen GET /api/v1/executions/exec_51a2/result GET /api/v1/executions/exec_51a2/artifacts
Anbindungsweg
15 Minuten, vom Erstellen des Webhooks bis zum ersten Ergebnis
Vier HTTP-Anfragen führen den gesamten Ablauf durch, ohne SDK; jede Sprache, die Anfragen senden kann, lässt sich anbinden.
01Webhook erstellen, URL und Key erhaltenFügen Sie dem Workflow in der Konsole einen Webhook-Trigger hinzu und erhalten Sie eine eigene URL; erstellen Sie dann einen API Key mit dem Scope WEBHOOK_TRIGGER.
02Eine Ausführung per POST auslösenDie JSON-Felder auf oberster Ebene werden automatisch auf namensgleiche Workflow-Variablen abgebildet; alternativ können Sie sie mit variableMapping explizit zuordnen; der Payload ist auf 1 MB begrenzt.
03Ausführungsstatus abfragen und Ergebnis abholenFragen Sie mit der zurückgegebenen executionId die Ausführungsdetails ab; nach Abschluss holen Sie die Ausgabe vom result-Endpunkt und laden Dateien vom artifacts-Endpunkt herunter.
04Aktionen, die eine menschliche Prüfung erfordern, laufen über die Freigabe-APIDie Ausführung hält am manual_approval-Schritt an; über den Freigabe-Endpunkt listen Sie die anstehenden Punkte auf und geben frei oder lehnen ab; bei Ablehnung oder Zeitüberschreitung wird nichts geändert.
# Schritt 2: einen POST aus Ihrem System senden curl -X POST https://your-host/api/webhooks/{id}/trigger \ -H "X-API-Key: <your-api-key>" \ -d '{"ticket_id": "T-1024", "lang": "zh"}' # Felder auf oberster Ebene werden automatisch auf namensgleiche Workflow-Variablen abgebildet → {"executionId": "exec_51a2"} # Schritt 3: Status abfragen, nach Abschluss Ergebnis abholen curl https://your-host/api/v1/executions/exec_51a2/result \ -H "X-API-Key: <your-api-key>"
Fähigkeitsliste
Sechs Dinge, die Entwicklerinnen und Entwickler interessieren
Sandbox-Code-Schritte in 7 SprachenPython, JavaScript, TypeScript, Bash, Ruby, Lua und CLI sind allesamt möglich; Variablen werden als Umgebungsvariablen WF_VAR_* injiziert, standardmäßig mit 30 Sekunden Timeout, und laufen in der Produktion in einer Docker-Sandbox mit kontrolliertem Ausgang ins Netz.
YAML-Definition, über Ihren Git-ProzessEin Workflow ist eine YAML-Datei: Commit, Diff und Rücksetzen erfolgen allesamt in dem Repository, das Sie kennen; Leinwand und YAML sind in beide Richtungen synchronisiert, Sie ändern also die Seite, die Ihnen passt.
MCP-Anbindung Ihrer eigenen WerkzeugeKapseln Sie interne Dienste als MCP Server und hängen Sie sie dem Agenten ein, dann kann der KI-Schritt Ihr System direkt aufrufen, ohne auf einen Konnektor der Plattform zu warten.
Breakpoint-Debugger9 Breakpoint-Typen halten beim Treffer an; nach dem Ändern der Variablen geht es weiter; nach einem Fehlschlag wird ab einem angegebenen Schritt neu ausgeführt, und bereits abgeschlossene LLM-Schritte werden nicht erneut abgerechnet.
v1 API mit 14 Endpunkten, minimale RechteAusführung auslösen, Ergebnisse abfragen, Freigaben bearbeiten und Artefakte herunterladen haben jeweils einen eigenen Berechtigungs-Scope; die 6 Scopes lassen sich nach Bedarf kombinieren, sodass Sie jedem angebundenen System einen eigenen Key ausstellen.
Verkettete Auslösung DELAYED_COMPLETIONNach Abschluss von A wird B nach N Sekunden automatisch ausgelöst; über maxRuns lässt sich eine Obergrenze setzen; ein langer Prozess wird in mehrere Abschnitte zerlegt, deren Logs und Kosten Sie jeweils einzeln einsehen.
Ehrliche Grenzen
Drei Dinge, vorab gesagt
So bemerken Sie es nicht erst mitten in der Anbindung.
Keine Hunderte SaaS-KonnektorenAufrufe externer Systeme werden in Code-Schritten geschrieben oder als MCP-Werkzeug gekapselt und dem Agenten eingehängt; für ein Team, das Code schreibt, sind das nur ein paar Zeilen HTTP-Anfragen.
Keine API zur Kostenschätzung vor der Ausführungtoken-Verbrauch und Kosten jeder Ausführung werden pro Durchlauf aufgezeichnet, sodass die nachträgliche Abrechnung detailliert ist; vor der Ausführung erhalten Sie jedoch keinen Kostenvoranschlag, die Budgetkontrolle erfolgt über die Freigabesteuerung und maxRuns.
Grenzen sind vorab offen ausgewiesenDer Webhook-Payload ist auf 1 MB begrenzt; Code-Schritte haben standardmäßig 30 Sekunden Timeout; HMAC-SHA256-Signaturen bleiben nur als Kompatibilitätsmodus erhalten, neue Anbindungen verwenden API Keys.
Einstieg in die Dokumentation
Drei lesenswerte Beiträge vor der Anbindung
v1-API-ReferenzRequest- und Response-Felder sowie Fehlercodes der 14 Endpunkte und die Konfiguration der 6 Berechtigungs-Scopes.Dokumentation öffnen →Webhook-triggerURL und Key erhalten, Regeln der Variablenzuordnung, HMAC-Kompatibilitätsmodus und das 1-MB-Limit.Dokumentation öffnen →Yaml-syntaxDie 8 Schrittarten sowie wie Modifikatoren wie condition, retry und manual_approval geschrieben werden.Dokumentation öffnen →
Binden Sie Ihren ersten Workflow in Ihr System ein
Im Free-Tarif können Sie Workflows bauen und manuell durchlaufen lassen; wenn Sie Webhook-Auslösung und zeitgesteuerte Planung benötigen, upgraden Sie auf Pro.