Rufen Sie Ihre Agenten und Flows auf
Entwerfen Sie Agenten und Flows in der App. Rufen Sie sie über REST, das TypeScript-SDK, gehostetes MCP, Webhooks oder eine öffentliche Seite auf.
Entwickeln, verbinden und teilen Sie Ihre Arbeit
Mit Code bauen. Über MCP und Webhooks verbinden. Mit einer öffentlichen Seite teilen. Der Entwurf bleibt in der App.
Entwickeln
Verbinden
Welcher Weg passt
Sie entwerfen den Agenten oder Flow in der App. Diese Wege entdecken, führen aus oder chatten. Sie bearbeiten den Graphen nicht. Bewahren Sie API-Schlüssel in einem Backend oder in einer geheim verwalteten MCP-Konfiguration auf.
| Weg | Nutzen, wenn | Auth und Streaming |
|---|---|---|
| Backend-REST | Ihr Server startet einen gespeicherten Flow mit POST /api/runs. | Bearer-API-Schlüssel. 201 oder 202 nimmt den Lauf an. Fragen Sie Get Run nach dem Ergebnis. Es gibt keine Route /run je Flow. |
| TypeScript-Flow-SDK | Derselbe Laufstart aus TypeScript. | API-Schlüssel auf dem Server. Dieselbe Annahme mit 201 und 202. Der Lauf-Stream ist ein eigener REST- oder SDK-Aufruf. |
| Agent-Chat | Ihr Backend chattet mit einem aktiven Agenten. | POST /v1/chat/completions. OpenAI-kompatibler Client. stream true sendet SSE. Kein SDK-Einbettungs-Widget. |
| Gehostetes MCP | Ein MCP-Client listet Ihre Agenten und Flows und ruft sie auf. | API-Schlüssel in der MCP-Konfiguration. Gehostetes MCP streamt nicht. Nutzen Sie REST oder das SDK für Live-SSE. Das ist nicht der MCP-Katalog von Drittanbietern. |
| Eingehender Webhook | Ein anderes System sendet POST an eine Flow-URL, um einen Lauf zu starten. | Der Flow muss aktiv sein, sonst antwortet der Handler mit 409. Das ist kein Agent-Kanalauslöser. |
| Ausgehender Ereignis-Webhook | Ihre URL empfängt signiertes flow.run.started, flow.run.succeeded oder flow.run.failed. | Registrieren Sie ihn unter Organisation, Webhooks. Prüfen Sie X-ActionFlows-Signature. Das startet keinen Lauf. |
| Öffentliche Seite | Eine Person öffnet einen veröffentlichten Flow oder Agenten. Siehe Landings. | Auf dieser Seite gibt es keinen API-Schlüssel. Regeln zum Ausprobieren und Kopieren stehen auf Landings, nicht hier. |
Von einem API-Aufruf zum Ergebnis
- 01
POST /api/runs mit payload.organizationId, payload.actionFlowId und Eingaben aus Knoten-ID, Unterstrich und Eingabename, wie in node_abc_prompt.
- 02
201 bedeutet freigegeben. 202 bedeutet in der Warteschlange. Speichern Sie die Lauf-ID oder die Warteschlangen-ID. Keiner der beiden Status bedeutet, dass der Graph fertig ist.
- 03
Lesen Sie den Lauf im Verlauf oder mit Get Run. Fragen Sie bei einem Eintrag in der Warteschlange die Warteschlangen-ID ab, bis eine Trigger-Lauf-ID vorliegt.
Fragen zum programmatischen Zugriff
Ein Lauf verbraucht Credits der Organisation. Die Speicherdauer der Protokolle und andere Limits folgen Ihrem Plan. Preise ansehen
Starten Sie einen Lauf aus Ihrer App
Erstellen Sie einen API-Schlüssel, bewahren Sie ihn auf dem Server auf und senden Sie POST /api/runs. Lesen Sie dann den Lauf. Der Entwurf bleibt in der App.