| قسم | کب چلتا ہے |
|---|---|
schedule | ایک cron ایکسپریشن میل کھاتی ہے۔ |
heartbeat | ایک وقفہ گزرتا ہے، اختیاری طور پر روزانہ کی ایک کھڑکی کے اندر۔ |
event | میل کھاتے ذریعے والا ایونٹ بھیجا جاتا ہے۔ |
watch | پلگ ان کا نگران آؤٹ پٹ کی ایک لائن لکھتا ہے۔ |
folder | کسی فولڈر میں فائلیں تبدیل ہوتی ہیں۔ |
manual | مالک یا کوئی ملازم اسے چلاتا ہے۔ |
call | کوئی فون لائن بجتی ہے۔ صرف فون کال ٹریز میں۔ |
schedule
{ "type": "schedule", "cron": "0 8 * * 1-5", "schedule": "Weekdays at 8:00" } cron پانچ فیلڈز والی cron ایکسپریشن ہے: منٹ، گھنٹہ، مہینے کا دن، مہینہ، ہفتے کا دن۔ schedule لوگوں کے لیے ایک اختیاری تفصیل ہے۔ شیڈولز بوٹ کے مقامی ٹائم زون میں چلتے ہیں۔ Nebo ہر پانچ سیکنڈ بعد شیڈولز جانچتا ہے۔ بوٹ بند ہونے کے دوران رہ جانے والا رن ایک بار پورا کر لیا جاتا ہے اگر وہ ایک گھنٹے سے کم دیر سے ہو۔ پچھلا رن جاری ہو تو نیا رن چھوڑ دیا جاتا ہے۔
heartbeat
{ "type": "heartbeat", "interval": "30m", "window": "08:00-18:00" } interval ایک مدت ہے جیسے 30m، 1h یا 2h30m۔ window، یعنی HH:MM-HH:MM، رنز کو کام کے اوقات کے اندر رکھتی ہے۔ اگلا رن پچھلا رن جمع وقفہ ہوتا ہے، جسے کھڑکی کے اندر منتقل کیا جاتا ہے؛ پہلا رن ورک فلو لوڈ ہونے کے ایک وقفے بعد ہوتا ہے۔ ٹائمرز ری اسٹارٹ کے بعد بھی برقرار رہتے ہیں۔ پچھلا رن جاری ہو تو نیا رن چھوڑ دیا جاتا ہے، اور غلط وقفہ کبھی نہیں چلتا۔
event
{ "type": "event", "sources": ["support-coordinator.summary.ready", "assignment.*"] } sources ایونٹس کے وہ نام درج کرتا ہے جن سے بالکل، یا آخر میں .* وائلڈ کارڈ کے ساتھ، میل ہونا ہو۔ خالی فہرست ایک غلطی ہے جو پوری agent.json کو مسترد کر دیتی ہے۔ رن کو _event_source، _event_payload اور _event_origin ملتے ہیں۔ نام کیسے بنتے ہیں، اس کے لیے ایونٹس دیکھیں۔
watch
{ "type": "watch", "plugin": "mail", "event": "email.new" } watch پلگ ان کا ایک پروسیس چلتا رکھتا ہے اور اس کی لکھی ہوئی ہر لائن کے لیے ایک رن شروع کرتا ہے۔ ہر لائن _watch_payload کے طور پر پہنچتی ہے۔ دس منٹ کے اندر یکساں لائنیں چھوڑ دی جاتی ہیں۔
| فیلڈ | طے شدہ | مطلب |
|---|---|---|
plugin | لازمی | ایک صلاحیت، جیسے mail، یا پلگ ان کا slug۔ جب بھی کوئی صلاحیت موزوں ہو تو اسی کا نام لیں۔ |
event | کوئی نہیں | پلگ ان کی events فہرست سے ایک ایونٹ۔ Nebo اس ایونٹ کی کمانڈ استعمال کرتا ہے اور ہر لائن کو <plugin>.<event> کے طور پر بھی بھیجتا ہے۔ |
command | کوئی نہیں | آرگیومنٹس جو نگران کو شروع کرتے ہیں۔ سیٹ ہوں تو استعمال ہوتے ہیں؛ ورنہ event سے لیے جاتے ہیں۔ |
restart_delay_secs | 5 | بند ہو جانے والے نگران کو دوبارہ شروع کرنے سے پہلے انتظار۔ |
صلاحیت اس انسٹال شدہ پلگ ان سے حل ہوتی ہے جو اسے فراہم کرتا ہو، اور ترجیح اس پلگ ان کو ملتی ہے جس پر اس ملازم کا اکاؤنٹ ہو۔ ایسا کوئی پلگ ان نہ ہو تو ورک فلو کمزور کے نشان کے ساتھ دکھایا جاتا ہے اور مالک کو بتایا جاتا ہے کہ کیا کنیکٹ کرنا ہے۔ بار بار کریش ہونے والا نگران ایک تاخیر کے بعد دوبارہ شروع ہوتا ہے جو 300 سیکنڈ تک دوگنی ہوتی جاتی ہے اور 30 سیکنڈ تک چلتے رہنے کے بعد دوبارہ شروع سے گنی جاتی ہے۔
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } command میں {{key}} ملازم کے ان پٹس پر مالک کے جوابات سے بھرا جاتا ہے۔ اگر کسی پلیس ہولڈر کا جواب نہ ہو تو واچ شروع نہیں ہوتی۔
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | فیلڈ | طے شدہ | مطلب |
|---|---|---|
path | لازمی | فولڈر کا مکمل پاتھ۔ {{key}} ان پٹس سے بھرا جاتا ہے۔ |
extensions | تمام فائلیں | میل کھانے والی فائل ایکسٹینشنز، نقطے کے بغیر۔ |
recursive | true | ذیلی فولڈرز شامل کریں۔ |
debounce_secs | 2 | اس وقفے کے اندر ہونے والی تبدیلیاں ایک رن بن جاتی ہیں۔ |
رن کو بدلے ہوئے پاتھس _watch_payload.files میں ملتے ہیں۔
manual
{ "type": "manual" } manual ورک فلو صرف تب چلتا ہے جب مالک اسے چلائے یا کوئی ملازم run_workflow کال کرے۔ ہر ورک فلو، چاہے اس کا ٹرگر کچھ بھی ہو، اس طرح بھی چلایا جا سکتا ہے۔
call
{"type": "call", "line": "..."} صرف "type": "call_tree" والے ورک فلو میں درست ہے، جو یہ ترتیب دیتا ہے کہ ملازم فون لائن پر کیسے جواب دیتا ہے۔ خالی line ہر اس لائن پر لاگو ہوتی ہے جس کا ملازم جواب دیتا ہے اور جس کا کوئی زیادہ مخصوص ٹری نہیں۔ کال ٹری میں ٹھیک ایک خوش آمدید اور کم از کم ایک نام والا ارادہ ہونا ضروری ہے۔
ویب ہکس
مالک کسی ملازم کے لیے ویب ہک بھی بنا سکتا ہے۔ کسی ورک فلو سے جڑا ویب ہک وہ ورک فلو چلاتا ہے؛ ورک فلو کے بغیر ویب ہک اپنا پے لوڈ ملازم کی چیٹ میں پہنچا دیتا ہے۔