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

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

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",
  "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": "إثارة"
  }
}
حقل الجسممطلوبالمعنى
org_idنعممؤسستك؛ يجب أن يطابق مفتاحها
project_idنعماللوحة التي يصل إليها التشغيل وأصوله — المعرّف في عنوان Studio URL الخاص بها، …/editor/<project_id>/canvas
workflow_idنعمسير العمل المراد تشغيله
المدخلاتنعمكائن مُفهرس بمفتاح كل مدخل المفتاح
idempotency_keyموصى بهيجعل إعادة المحاولة آمنة — راجع الاتفاقيات
workflow_version_idلايثبّت الإصدار الذي تُقرأ منه المدخلات
معرّف webhookلايرسل أحداث هذا التشغيل إلى نقطة نهاية مسجّلة واحدة — راجع خطافات الويب

كيفية إرسال كل مدخل

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

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

في هذه الصفحة