للأدوات ووكلاء الذكاء الاصطناعي: هذه الصفحة بصيغة Markdown · ملف OpenAPI العام
الوصف
تجري فحوص التفعيل نفسها التي يجريها التطبيق (الاتصالات ومعالجة الأخطاء والمشغّل والبنية) وتفعّل التدفق في بيئة الاختبار (staging). لا تمسّ الإنتاج أبداً: التدفق الذي بيئته الإنتاج يُرفض. والتدفق الموجود في بيئة التطوير يُنقل إلى بيئة الاختبار. وتُنشأ التدفقات الجديدة وبيئتها الإنتاج، لذلك ينقل شخص التدفق أولاً إلى بيئة الاختبار في التطبيق. وعلى تدفق نشط أصلاً في بيئة الاختبار لا تغيّر شيئاً.
وقبل أن تفعّل تدفقاً تفحصه أيضاً مع التدفقات التي يشغّلها كتدفقات فرعية (حتى ستة مستويات). وترفض التفعيل إذا كان أيٌّ منها يشغّل خطوة حكومية من نفاذ أو مقيم أو تم محجوبة عن عملاء الذكاء الاصطناعي، أو فيه خطوة تدفق فرعي بلا تدفق هدف ثابت (ومنها خطوة يملؤها وكيل ذكاء اصطناعي وقت التشغيل)، أو فيه خطوة تحمل نوعين متعارضين، أو إذا تجاوزت التدفقات الفرعية ستة مستويات. مثل هذا التدفق يفعّله شخص في التطبيق.
بعد التفعيل يُعرض التدفق أيضاً كأداة تدفق للمفاتيح التي تحمل execute، وتحمل تشغيلاته البيئة staging.
الصلاحية
تحتاج إلى مفتاح API أو اتصال OAuth يحمل صلاحية build.
المدخلات
| الاسم | النوع | مطلوب | الوصف |
|---|---|---|---|
flowId | string | نعم | معرّف تدفق تملكه مساحة العمل لتفعيله في بيئة الاختبار. |
environment | string: staging | لا | البيئة صراحةً (اختياري). لا تُقبل إلا staging. |
ما تعيده
activated: true وflowId وstatus: "active" وenvironment: "staging" وproductionPromoted: false وlintWarnings وrepairNotes. وعند فشل الفحوص: activated: false وgateFailures مع isError: true.
الأخطاء
تُعاد كنتيجة عادية مع isError: true:
`flowId` is required.MCP activation is staging-only. Production promotion must be performed by a human in Exomations.Flow "<flowId>" not found.This flow is currently in production. MCP cannot demote or alter a production flow; create or switch to a staging draft first.Flow "<name>" was NOT activated: it runs a Nafath, Muqeem or Tamm government step that is withheld from AI clients, directly or through a sub-flow. Activate it in the Exomations app.Flow "<name>" was NOT activated: a sub-flow step in it (or in a flow it runs) has no fixed target flow, so its target is chosen at run time and cannot be checked here. Activate it in the Exomations app.Flow "<name>" was NOT activated: a step in it (or in a flow it runs) carries two different step types, so it cannot be checked here. Activate it in the Exomations app.Flow "<name>" was NOT activated: it runs sub-flows nested deeper than can be checked here. Activate it in the Exomations app.Flow "<name>" was NOT activated: the workspace's flows could not be read to check it. Activate it in the Exomations app.Flow NOT activated — the shared activation quality gate found <n> blocking issue(s): <issues>Activation failed before the flow was saved.Flow "<name>" was not activated because its schedule could not be registered: <reason>
تُعاد كخطأ JSON-RPC:
| الرمز | HTTP | الرسالة |
|---|---|---|
| -32001 | 403 | API key lacks the 'build' permission required for flow authoring tools |
تظهر الرسائل كما يرسلها الخادم تماماً، بالإنجليزية. القيمة بين علامتي < > تُملأ وقت التشغيل.
أمثلة
مثال على الاستدعاء
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "exo_activate_flow",
"arguments": {
"flowId": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61"
}
}
}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_activate_flow","arguments":{"flowId":"7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61"}}}'مثال على النتيجة
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "Flow \"Overdue invoice reminders\" activated in STAGING. Production promotion was not changed.\n{ ... }"
}
],
"structuredContent": {
"activated": true,
"flowId": "7a17617d-3c4e-4f0a-9b1e-2d5c8e0f4a61",
"status": "active",
"environment": "staging",
"productionPromoted": false,
"lintWarnings": [],
"repairNotes": []
},
"isError": false
}
}قيم للتوضيح. في content يحمل النص بعد سطر الملخص البيانات نفسها التي في structuredContent.