بدء تشغيل سير عمل
ابدأ مسار عمل باستخدام مدخلاتك واحصل على معرّف تشغيل في المقابل.
POST {base_url}/workflow-runsيتطلب runs:write.
الطلب
POST {base_url}/workflow-runs
Authorization: Bearer mor_live_…
Content-Type: application/json
{
"org_id": "0192f3c1-7a44-7d10-9b22-1e5c8f0a3b61",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"idempotency_key": "story-48213-v2",
"name": "Story 48213",
"inputs": {
"story_document": "https://cdn.example.com/stories/48213.pdf",
"character_sheets": [
"https://cdn.example.com/chars/48213-a.png",
"https://cdn.example.com/chars/48213-b.png"
],
"episode_count": 8,
"tone": "thriller"
}
}| حقل الجسم | مطلوب | المعنى |
|---|---|---|
org_id | نعم | مؤسستك؛ يجب أن يطابق مفتاحها |
project_id | نعم | اللوحة التي يصل إليها التشغيل وأصوله — المعرّف في عنوان Studio URL الخاص بها، …/editor/<project_id>/canvas |
workflow_id | نعم | سير العمل المراد تشغيله |
inputs | نعم | كائن مُفهرس بقيمة key لكل مدخل |
idempotency_key | موصى به | يجعل إعادة المحاولة آمنة — راجع الاتفاقيات |
workflow_version_id | لا | يثبّت الإصدار الذي تُقرأ منه المدخلات |
webhook_id | لا | يرسل أحداث هذا التشغيل إلى نقطة نهاية مسجّلة واحدة — راجع خطافات الويب |
name | لا | عنوان جلسة Studio الخاصة بالتشغيل، ويظهر بالشكل API: <name>. سطر واحد، بحد أقصى 250 حرفًا. عند حذفه يُستخدم اسم سير العمل |
كيفية إرسال كل مدخل
accepts | إرسال | مع allow_multiple |
|---|---|---|
value | السلسلة النصية أو الرقم أو القيمة المنطقية نفسها | مصفوفة منها |
url | رابط HTTPS عام واحد، كسلسلة نصية | مصفوفة من الروابط |
option | واحد options[].id، تمامًا كما هي مُعطاة | مصفوفة من المعرّفات |
الاستجابة
202 Accepted
{
"run": {
"id": "0192f3d0-6c31-7a52-b4e8-3f9d1a7c5e20",
"status": "queued",
"workflow_id": "0192f3c3-9d21-7c44-b8e1-5a7f2c9d4e10",
"workflow_version_id": "0192f3c4-1a02-7bb3-9f40-2c6e8d1a5b77",
"project_id": "0192f3c2-4b18-7e93-8c07-9d2a6f4e1c58",
"chat_id": "0192f3c6-2e75-7b14-9a63-7c4e2d8f1b09",
"ingested": [
{ "input": "story_document", "bytes": 184320, "mime_type": "application/pdf" },
{ "input": "character_sheets", "bytes": 962144, "mime_type": "image/png" },
{ "input": "character_sheets", "bytes": 883021, "mime_type": "image/png" }
],
"poll_after_seconds": 60,
"expires_at": "2026-09-23T04:10:00Z"
}
}| حقل الاستجابة | المعنى |
|---|---|
id | معرّف التشغيل. استعلم عنه دوريًا، واحتفظ به في سجلك الخاص |
status | queued عند القبول |
chat_id | جلسة Studio التي يتم فيها التشغيل. افتحها لمشاهدة التشغيل أو الإجابة عن سؤال يطرحه |
ingested | مدخل واحد لكل ملف تم جلبه، بالترتيب الذي أُرسل به. مفيد للتأكد من أنك أرسلت ما كنت تقصده |
poll_after_seconds | مدة الانتظار قبل أول استعلام |
expires_at | عندما يُتخلّى عن تشغيل غير مكتمل باعتباره expired |
يتم جلب كل رابط والتحقق منه قبل رمز 202. التشغيل الذي يعود مقبولًا تكون ملفاته قد وصلت، لذا فإن الرابط السيئ يؤدي فورًا إلى 400 بدلًا من فشل بعد عشر دقائق.