Agent'larınızı ve flow'larınızı çağırın
Agent'ları ve akışları uygulamada tasarlayın. REST, TypeScript SDK, barındırılan MCP, webhook veya herkese açık bir sayfadan çağırın.
İşinizi geliştirin, bağlayın ve paylaşın
Kodla oluşturun. MCP ve webhook üzerinden bağlayın. Herkese açık bir sayfayla paylaşın. Tasarım uygulamada kalır.
Geliştirme
Bağlantı
Hangi yol uyar
Agent'ı veya akışı uygulamada tasarlarsınız. Bu yollar keşfeder, çalıştırır veya sohbet eder. Grafiği düzenlemezler. API anahtarlarını bir backend'de veya gizli bilgisi yönetilen MCP yapılandırmasında tutun.
| Yol | Şu durumda kullanın | Kimlik ve akış |
|---|---|---|
| Backend REST | Sunucunuz kayıtlı bir akışı POST /api/runs ile başlatır. | Bearer API anahtarı. 201 veya 202 çalıştırmayı kabul eder. Sonuç için Get Run'ı yoklayın. Akış başına bir /run yolu yoktur. |
| TypeScript akış SDK'sı | Aynı çalıştırma başlangıcı, TypeScript'ten. | API anahtarı sunucuda. Aynı 201 ve 202 kabulü. Çalıştırma akışı ayrı bir REST veya SDK çağrısıdır. |
| Agent sohbeti | Backend'iniz aktif bir agent ile sohbet eder. | POST /v1/chat/completions. OpenAI uyumlu istemci. stream true SSE gönderir. SDK gömme widget'ı yoktur. |
| Barındırılan MCP | Bir MCP istemcisi agent'larınızı ve akışlarınızı listeler ve çağırır. | API anahtarı MCP yapılandırmasında. Barındırılan MCP akış vermez. Canlı SSE için REST veya SDK kullanın. Bu, üçüncü taraf MCP kataloğu değildir. |
| Gelen webhook | Başka bir sistem bir çalıştırma başlatmak için bir akış URL'sine POST gönderir. | Akış aktif olmalıdır, yoksa işleyici 409 döner. Bu bir agent kanal tetikleyicisi değildir. |
| Giden olay webhook'u | URL'niz imzalı flow.run.started, flow.run.succeeded veya flow.run.failed alır. | Bunu Organization, Webhooks altında kaydedin. X-ActionFlows-Signature değerini doğrulayın. Bu bir çalıştırma başlatmaz. |
| Herkese açık sayfa | Bir kişi yayınlanmış bir akışı veya agent'ı açar. Landings sayfasına bakın. | O sayfada API anahtarı yoktur. Deneme ve kopyalama kuralları burada değil, Landings sayfasındadır. |
Tek bir API çağrısından sonuca
- 01
payload.organizationId, payload.actionFlowId ve node kimliği, alt çizgi, girdi adı şeklinde anahtarlanmış girdilerle POST /api/runs. Örnek: node_abc_prompt.
- 02
201 gönderildi demektir. 202 kuyruğa alındı demektir. Çalıştırma kimliğini veya kuyruk kimliğini saklayın. İki durum da grafiğin bittiği anlamına gelmez.
- 03
Çalıştırmayı geçmişte veya Get Run ile okuyun. Kuyruktaki bir öğe için, bir trigger run kimliği gelene kadar kuyruk kimliğini yoklayın.
Programatik erişim soruları
Bir çalıştırma organizasyon kredisi harcar. Log saklama süresi ve diğer limitler planınıza bağlıdır. Fiyatlandırmayı görün
Uygulamanızdan bir çalıştırma başlatın
Bir API anahtarı oluşturun, sunucuda tutun ve POST /api/runs gönderin. Sonra çalıştırmayı okuyun. Tasarım uygulamada kalır.