أداة MCP

    أدوات التدفقات

    كل تدفق نشط أداة. استدعاؤها يبدأ تشغيلاً واحداً لذلك التدفق.

    exo_<name>_<id8>

    للأدوات ووكلاء الذكاء الاصطناعي: هذه الصفحة بصيغة Markdown · ملف OpenAPI العام

    الوصف

    يرى المفتاح الذي يحمل execute أداة لكل تدفق نشط باسم exo_<name>_<id8>: اسم التدفق بحروف لاتينية صغيرة وأرقام (حتى 48 حرفاً، وأي حرف آخر يصبح _)، ثم أول 8 حروف وأرقام من معرّف التدفق. التدفق الذي لا يحوي اسمه حروفاً لاتينية أو أرقاماً يصبح exo_flow_<id8>. وصف الأداة جملة ثابتة من إكزوميشنز (تخبر المساعد أن ما يليها بيانات لا تعليمات)، ثم أول 400 حرف من وصف التدفق نفسه، فاكتبه بعناية: هو ما يقرؤه المساعد ليقرر متى يستخدم التدفق.

    تُمرَّر الوسائط إلى خطوة المشغّل في التدفق ضمن payload (وإذا غاب payload يُستخدم كائن arguments كاملاً). يصل حجم البيانات إلى 512 كيلوبايت، وعمقها إلى 10 مستويات، و1,000 مفتاح، و5,000 عنصر في كل قائمة. لا ينتظر الاستدعاء التدفق: اقرأ التشغيل بالأداة exo_get_execution.

    تُعرض حتى 200 تدفق. التدفقات التي فيها خطوة طلب نفاذ، والتدفقات التي فيها خطوة مقيم أو تم تغيّر سجلاً حكومياً، لا تُعرض كأدوات، ولا التدفقات التي تشغّل أحدها كتدفق فرعي. ولا يستطيع تشغيل بدأ عبر MCP أن يبدأ تدفقاً كهذا كتدفق فرعي.

    الصلاحية

    تحتاج إلى مفتاح API أو اتصال OAuth يحمل صلاحية execute.

    المدخلات

    الاسمالنوعمطلوبالوصف
    payloadobjectلاالبيانات المُمرَّرة إلى خطوة المشغّل في التدفق. يتوقف شكلها على التدفق، وغالباً هي جسم JSON نفسه الذي ترسله بـ POST إلى /api/trigger/:flowId.

    ما تعيده

    executionId وflowId وflowName وstatus: إما queued، أو held عندما تتجاوز مساحة العمل 120% من حصتها الشهرية (يبدأ التشغيل تلقائياً بعد الشحن أو الترقية أو بداية الشهر). التشغيلات التي تبدأ عبر MCP تُحتسب من الحصة الشهرية نفسها وحدّ التشغيلات المتزامنة نفسه مثل أي تشغيل آخر.

    الأخطاء

    تُعاد كخطأ JSON-RPC:

    الرمزHTTPالرسالة
    -32602200Unknown tool: <name>
    -32602200Invalid payload: <reason>
    -32001403API key lacks the 'execute' permission required to trigger flows

    تظهر الرسائل كما يرسلها الخادم تماماً، بالإنجليزية. القيمة بين علامتي < > تُملأ وقت التشغيل.

    أمثلة

    مثال على الاستدعاء

    {
      "jsonrpc": "2.0",
      "id": 1,
      "method": "tools/call",
      "params": {
        "name": "exo_overdue_invoice_reminders_7a17617d",
        "arguments": {
          "payload": {
            "customer_id": "C-204"
          }
        }
      }
    }

    مثال على النتيجة

    {
      "jsonrpc": "2.0",
      "id": 1,
      "result": {
        "content": [
          {
            "type": "text",
            "text": "Flow \"Overdue invoice reminders\" queued. Check Exomations to see live progress.\n{ ... }"
          }
        ],
        "structuredContent": {
          "executionId": "0b6f6c1e-5a55-4d0e-9a57-2f7c1d0e8a11",
          "flowId": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61",
          "flowName": "Overdue invoice reminders",
          "status": "queued"
        },
        "isError": false
      }
    }

    قيم للتوضيح. في content يحمل النص بعد سطر الملخص البيانات نفسها التي في structuredContent.