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.
المدخلات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
payload | object | لا | البيانات المُمرَّرة إلى خطوة المشغّل في التدفق. يتوقف شكلها على التدفق، وغالباً هي جسم JSON نفسه الذي ترسله بـ POST إلى /api/trigger/:flowId. |
ما تعيده
executionId وflowId وflowName وstatus: إما queued، أو held عندما تتجاوز مساحة العمل 120% من حصتها الشهرية (يبدأ التشغيل تلقائياً بعد الشحن أو الترقية أو بداية الشهر). التشغيلات التي تبدأ عبر MCP تُحتسب من الحصة الشهرية نفسها وحدّ التشغيلات المتزامنة نفسه مثل أي تشغيل آخر.
الأخطاء
تُعاد كخطأ JSON-RPC:
| الرمز | HTTP | الرسالة |
|---|---|---|
| -32602 | 200 | Unknown tool: <name> |
| -32602 | 200 | Invalid payload: <reason> |
| -32001 | 403 | API 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"
}
}
}
}curl -X POST https://exomations.com/api/mcp \
-H "X-Api-Key: exo_your_key" \
-H "Content-Type: application/json" \
-d '{"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.