پہلا ورک فلو
agent.json میں ایک workflows میپ شامل کریں۔ ہر کی ایک ورک فلو کا نام ہے؛ ہر قدر میں ایک ٹرگر اور سرگرمیاں ہوتی ہیں۔
{
"workflows": {
"morning-summary": {
"trigger": { "type": "schedule", "cron": "0 8 * * 1-5" },
"description": "Summarize yesterday's open conversations every weekday morning.",
"activities": [
{ "id": "summarize", "intent": "Summarize yesterday's open customer conversations and what each one is waiting on." }
]
}
}
} یہ ورک فلو ہفتے کے کام کے دنوں میں 08:00 بجے چلتا ہے، بوٹ کے مقامی وقت کے مطابق۔ ملازم یہ سرگرمی اپنی شخصیت، مہارتوں اور کنکشنز کے ساتھ انجام دیتا ہے۔
ورک فلو فیلڈز
| فیلڈ | مطلب |
|---|---|
trigger | لازمی۔ ورک فلو کب چلتا ہے۔ Triggers دیکھیں۔ |
description | ورک فلو کس لیے ہے۔ |
activities | مراحل۔ Activities دیکھیں۔ |
connections | کنارے {from, to, label} جو سرگرمیوں کو گراف بناتے ہیں۔ __trigger__ آغاز ہے اور __emit__ اختتام۔ |
emit | ایونٹس جن کا یہ ورک فلو ختم ہونے پر اعلان کرتا ہے: ایک فہرست، یا کوما سے الگ کی گئی ایک اسٹرنگ۔ Events دیکھیں۔ |
inputs | ہر رن کو دی جانے والی قدریں۔ |
budget | {total_per_run, cost_estimate}۔ گراف رن میں total_per_run آؤٹ پٹ ٹوکنز کی حد طے کرتا ہے؛ ورنہ دونوں اندازے ہیں۔ |
case | ورک فلو کو ہر شخص یا چیز کے لیے ایک طویل چلنے والا کیس بنا دیتا ہے۔ Cases دیکھیں۔ |
ٹرگر والا ورک فلو جس میں کوئی سرگرمی نہ ہو، درست ہے۔ سرگرمیوں کے بغیر watch صرف اپنے ایونٹس دوسرے ورک فلوز تک پہنچاتا ہے۔
رن کیسے چلتا ہے
connections کے بغیر سرگرمیاں ترتیب سے چلتی ہیں اور ملازم ہر ایک انجام دیتا ہے۔ ہر سرگرمی کا نتیجہ اگلی کو دیا جاتا ہے۔ جس سرگرمی کا کوئی آؤٹ پٹ نہ ہو، وہ رن ختم کر دیتی ہے۔
connections کے ساتھ سرگرمیاں ایک گراف بناتی ہیں۔ شاخیں متوازی چلتی ہیں، اور چھ قسم کی سرگرمیاں ماڈل کے بغیر چلتی ہیں: condition، loop، wait، http، command اور decide۔ جب روٹنگ بالکل درست ہونی ضروری ہو تو گراف استعمال کریں۔
{
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"activities": [
{ "id": "classify", "type": "decide",
"params": {
"questions": {
"kind": {
"type": "choice",
"instructions": "What kind of message is this?",
"criteria": { "invoice": "A bill from a vendor", "other": "Anything else" }
}
},
"default": { "kind": "other" }
} },
{ "id": "is-invoice", "type": "condition", "params": { "expression": "nodes.classify.kind.choice == invoice" } },
{ "id": "record", "intent": "Record the invoice in _watch_payload as a bill and note the due date." }
],
"connections": [
{ "from": "__trigger__", "to": "classify" },
{ "from": "classify", "to": "is-invoice" },
{ "from": "is-invoice", "to": "record", "label": "True" },
{ "from": "record", "to": "__emit__" }
],
"emit": ["invoice.recorded"]
} ایک رن کو کیا ملتا ہے
ملازم کے پاس ہمیشہ اس کی شخصیت اور اس کے inputs سوالات پر مالک کے جوابات ہوتے ہیں۔ ٹرگر کے لحاظ سے رن کو یہ قدریں بھی ملتی ہیں۔
| ان پٹ | کب موجود ہوتا ہے |
|---|---|
_event_source, _event_payload, _event_origin | جب event ٹرگر چلا ہو۔ 8 KB یا اس سے بڑے پے لوڈز کو ان کی اسکیلر فیلڈز تک مختصر کر دیا جاتا ہے، جبکہ ای میل ہیڈرز اور اٹیچمنٹ کے حوالے برقرار رہتے ہیں۔ |
_watch_payload | جب watch یا folder ٹرگر چلا ہو۔ نگران کے آؤٹ پٹ کی ایک لائن، یا فولڈر کے لیے {files}۔ |
inputs | ہمیشہ۔ ورک فلو کی اپنی inputs قدریں۔ |
کیسز
کچھ کام کئی دنوں پر پھیلا ہوتا ہے: کوئی لیڈ جسے فالو اپ درکار ہو، کوئی درخواست جو دستاویزات کا انتظار کر رہی ہو۔ case شامل کریں اور ورک فلو ہر بار نئے سرے سے شروع کرنے کی بجائے ہر شخص یا چیز کے لیے ایک کھلا کیس رکھتا ہے۔
| فیلڈ | مطلب |
|---|---|
key | لازمی۔ ٹرگر ڈیٹا میں کوما سے الگ کیے گئے ڈاٹ والے پاتھس جو موضوع کی شناخت کرتے ہیں، جیسے contactEmail,email,phone۔ |
type | کیس کی قسم، جیسے lead۔ ایک ہی قسم والے ورک فلوز کیسز مشترک رکھتے ہیں۔ طے شدہ قدر ورک فلو کا نام ہے۔ |
default_wait | جب کسی باری میں انتظار کا وقت نہ بتایا جائے تو کتنا انتظار کرنا ہے: 3d، 12h، 45m۔ طے شدہ تین دن۔ |
کیس کی ہر باری ایک JSON آبجیکٹ پر ختم ہونی چاہیے اور اس کے بعد کچھ نہیں۔ result کاروباری حالت ہے؛ next انجن کو wait یا close کرنے کو کہتا ہے۔ ڈیڈ لائن RFC 3339 یا کوئی نسبتی مدت ہوتی ہے۔ اس کے علاوہ کچھ بھی ہو تو باری غلط ہے۔
{"result": {"status": "awaiting_documents", "summary": "Requested two bank statements"},
"next": {"action": "wait", "on": "signal", "deadline": "3d", "reason": "documents"}} حدود اور بحالی
- ہر سرگرمی زیادہ سے زیادہ 50 ماڈل باریاں لے سکتی ہے، جب تک
params.maxIterationsکچھ اور نہ کہے۔ - گراف میں ایک سرگرمی ایک رن میں زیادہ سے زیادہ 10,000 بار چل سکتی ہے۔
- ملازم کے لیے مالک کی خرچ کی حد پوری ہونے پر رن رک جاتا ہے۔ کسی سرگرمی کا
token_budgetایک اندازہ ہے۔ - ری اسٹارٹ سے رکا ہوا رن رکا ہوا قرار دیا جاتا ہے اور ایک بار دوبارہ شروع کیا جاتا ہے۔
- ملازم
exitٹول سے رن جلد ختم کر سکتا ہے۔
ورک فلوز چلائیں اور سنبھالیں
مالک کوئی بھی ورک فلو ہاتھ سے چلا سکتا ہے۔ ملازمین run_workflow، workflow_status، list_workflow_runs، set_workflow_enabled اور مددگار اور ٹیمیں پر درج دوسرے ورک فلو ٹولز سے ورک فلوز سنبھالتے ہیں۔