بدء تشغيل سير عمل

ابدأ مسار عمل باستخدام مدخلاتك واحصل على معرّف تشغيل في المقابل.

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معرّف التشغيل. استعلم عنه دوريًا، واحتفظ به في سجلك الخاص
statusqueued عند القبول
chat_idجلسة Studio التي يتم فيها التشغيل. افتحها لمشاهدة التشغيل أو الإجابة عن سؤال يطرحه
ingestedمدخل واحد لكل ملف تم جلبه، بالترتيب الذي أُرسل به. مفيد للتأكد من أنك أرسلت ما كنت تقصده
poll_after_secondsمدة الانتظار قبل أول استعلام
expires_atعندما يُتخلّى عن تشغيل غير مكتمل باعتباره expired

يتم جلب كل رابط والتحقق منه قبل رمز 202. التشغيل الذي يعود مقبولًا تكون ملفاته قد وصلت، لذا فإن الرابط السيئ يؤدي فورًا إلى 400 بدلًا من فشل بعد عشر دقائق.

في هذه الصفحة