الحقول
{
"id": "draft-reply",
"label": "Draft the reply",
"intent": "Draft a reply to the customer message in _watch_payload using the reply-drafting skill.",
"skills": ["reply-drafting"],
"requires_tools": ["mail_message_send"],
"on_error": { "retry": 1, "fallback": "notify_owner" }
} | الحقل | القيمة الافتراضية | المعنى |
|---|---|---|
id | مطلوب | فريد داخل سير العمل. يُستخدم في connections ومسارات البيانات. |
type | custom | خطوة موظف، أو واحد من condition، loop، wait، http، command، decide. |
intent | لا شيء | ما ينبغي للموظف إنجازه. تحتاج خطوة الموظف إلى intent أو steps. |
steps | [] | تعليمات مرتبة، عندما لا تكفي جملة واحدة. |
label | لا شيء | الاسم الذي يُعرض على المالك. |
skills | [] | المهارات التي تُستخدم. مهارات المتجر المدرجة هنا تُثبَّت مع الموظف. |
tools | [] | عند ضبطها، تكون الأدوات الوحيدة التي يجوز للخطوة استخدامها. |
requires_tools | [] | أدوات يجب أن تنجح لتُعدّ الخطوة منجزة. |
cmds | [] | أوامر الإضافات المسمّاة للخطوة. |
mcps | [] | خوادم MCP المسمّاة للخطوة. |
model | لا شيء | معرّف نموذج لهذه الخطوة. |
params | لا شيء | معاملات الأنشطة المحددة النوع، وmaxIterations لخطوات الموظف. |
min_iterations | لا شيء | الحد الأدنى لأدوار النموذج قبل أن يجوز للخطوة أن تنتهي. |
token_budget | لا شيء | {max}. تقدير. |
on_error | {retry: 1, fallback: notify_owner} | إعادة المحاولات، ثم البديل الاحتياطي. أي فشل بعد إعادة المحاولات ينهي التشغيل. |
خطوات الموظف
تعمل خطوة الموظف كدور من أدوار الموظف: تنطبق شخصيته وذاكرته واتصالاته، ويمكنها استخدام ما يصل إلى 50 دورًا للنموذج، أو params.maxIterations. تُمرَّر نتائج الخطوات السابقة على شكل كتل [Activity 'id' result]. والخطوة التي تنهي سير عمل له قائمة emit يُطلب منها استدعاء emit_event بتلك الأحداث. والأداة exit متاحة دائمًا لإنهاء التشغيل.
سياق البيانات
تقرأ الأنشطة المحددة النوع القيم بمسار نقطي من كائن واحد: يحتوي inputs على مدخلات التشغيل، ويحتوي nodes.<id> على مخرجات كل نشاط منتهٍ (محلَّلة كـ JSON عندما تكون JSON)، ويحتوي item على العنصر الحالي داخل الحلقة. المسار المجرد يبحث في inputs، ثم في nodes.
condition
{ "id": "large", "type": "condition", "params": { "expression": "inputs.amount >= 500" } } params.expression مطلوب. تُسمّى اتصالاته الصادرة True وFalse. ويختار params.mode كيف يُقرأ:
| الوضع | التعبير |
|---|---|
expression | الافتراضي. path op value مع == أو != أو >= أو <= أو > أو <، وتُقارن كأرقام عندما يكون الطرفان رقمين، أو مسار مجرد يكون صحيحًا عندما تكون قيمته صادقة. |
exists | مسار، ويكون صحيحًا عندما يُحلّ إلى قيمة صادقة. |
contains | path contains text، أو نص مجرد يُطابَق مع المخرجات السابقة. |
regex | نمط يُطابَق مع المخرجات السابقة. |
loop
{ "id": "each-invoice", "type": "loop", "params": { "source": "nodes.fetch.invoices", "concurrency": 4 } } params.source هو مسار قائمة. الاتصال المسمّى Each item يقود إلى المتن، الذي يعمل مرة لكل عنصر مع ضبط item، والاتصال المسمّى Done يعمل بعد كل العناصر. تبدأ التكرارات معًا ما لم تضبط concurrency. ويُقبل أيضًا maxIterations وbatchSize.
"connections": [
{ "from": "__trigger__", "to": "fetch" },
{ "from": "fetch", "to": "each-invoice" },
{ "from": "each-invoice", "to": "check", "label": "Each item" },
{ "from": "each-invoice", "to": "report", "label": "Done" }
] wait وhttp وcommand
{ "id": "pause", "type": "wait", "params": { "duration": "5m" } }
{ "id": "status", "type": "http", "params": { "url": "https://status.example.com/api", "method": "GET" } }
{ "id": "export", "type": "command", "params": { "command": "date -u" } } | النوع | مطلوب | السلوك |
|---|---|---|
wait | params.duration | يتوقف مؤقتًا لمدة بـ s أو m أو h. لا يوجد انتظار حتى وقت محدد، وللاستئناف عند حدث، شغّل سير عمل ثانيًا عليه. |
http | params.url | يُجري الطلب. method وheaders وbody اختيارية. |
command | params.command | يشغّل أمر shell. ويكون stdout الخاص به مخرجات النشاط. |
decide
يطرح نشاط decide أسئلة محددة النوع عن العمل حتى الآن ويسجّل إجابات منظمة يمكن لـ condition أن يوجّه بناءً عليها.
{
"id": "triage",
"type": "decide",
"params": {
"questions": {
"urgency": { "type": "score", "instructions": "How urgent is this request?", "criteria": ["low", "normal", "high"] },
"refund": { "type": "noul", "instructions": "The customer is asking for money back." }
},
"default": { "urgency": "normal", "refund": false }
}
} | نوع السؤال | criteria | الإجابة |
|---|---|---|
choice | كائن من الخيار إلى الوصف، من 2 إلى 255 خيارًا. | choice وconfidence وprobabilities. |
score | قائمة من 2 إلى 10 مستويات مرتبة. | score من 0 (المستوى الأول) فصاعدًا، وconfidence. |
noul | لا شيء. | noul، أي احتمال صحة العبارة. |
وجّه بناءً على إجابة باستخدام condition، مثل nodes.triage.urgency.score >= 1.5. يعطي params.default الإجابة الآمنة لكل سؤال عندما يتعذر اتخاذ قرار، والإجابة الافتراضية درجة ثقتها 0. والسؤال الذي لا قيمة افتراضية له لا يحصل على إجابة، فتسلك الشروط المبنية عليه حافة False.
الأخطاء
يحدّد on_error.retry عدد مرات إعادة محاولة النشاط الفاشل، والقيمة الافتراضية 1. بعد آخر إعادة محاولة ينتهي التشغيل، ومع fallback الافتراضي notify_owner يُبلَّغ المالك. يتحقق Nebo من المعاملات المطلوبة لكل نشاط محدد النوع عند بدء التشغيل، ويرفض الفرع الذي يشير إلى نشاط غير معروف.