فیلڈز
{
"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 | کوئی نہیں | اس مرحلے کے لیے ماڈل id۔ |
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 جس میں ==، !=، >=، <=، > یا < ہو، دونوں طرف اعداد ہوں تو اعداد کے طور پر موازنہ؛ یا خالی پاتھ، درست جب اس کی قدر truthy ہو۔ |
exists | ایک پاتھ؛ درست جب اس کی قدر truthy ہو۔ |
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 | ایک شیل کمانڈ چلاتا ہے۔ اس کا 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 ترتیب وار سطحوں کی فہرست۔ | 0 (پہلی سطح) سے اوپر score، اور confidence۔ |
noul | کوئی نہیں۔ | noul، اس بات کا امکان کہ بیان درست ہے۔ |
کسی جواب پر condition کے ذریعے روٹ کریں، جیسے nodes.triage.urgency.score >= 1.5۔ جب کوئی فیصلہ نہ ہو سکے تو params.default ہر سوال کا محفوظ جواب دیتا ہے؛ طے شدہ جواب کا confidence 0 ہوتا ہے۔ جس سوال کی کوئی طے شدہ قدر نہ ہو اسے کوئی جواب نہیں ملتا، اس لیے اس پر لگی conditions اپنا False کنارہ لیتی ہیں۔
غلطیاں
on_error.retry طے کرتا ہے کہ ناکام سرگرمی کو کتنی بار دوبارہ آزمایا جائے؛ طے شدہ 1 ہے۔ آخری کوشش کے بعد رن ختم ہو جاتا ہے، اور notify_owner کے طے شدہ fallback کے ساتھ مالک کو اطلاع دی جاتی ہے۔ Nebo رن شروع ہونے پر ہر ٹائپ شدہ سرگرمی کے لازمی پیرامیٹرز جانچتا ہے، اور ایسی شاخ مسترد کر دیتا ہے جو کسی نامعلوم سرگرمی کی طرف اشارہ کرے۔