NeboAI
NeboAI
شروع کریں

ٹرگرز

ٹرگر طے کرتا ہے کہ ورک فلو کب چلے۔ Nebo میں سات قسم کے ٹرگرز ہیں۔ ہر ایک ایک آبجیکٹ ہے جس میں type فیلڈ اور اس قسم کی فیلڈز ہوتی ہیں۔

قسمکب چلتا ہے
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_secs5بند ہو جانے والے نگران کو دوبارہ شروع کرنے سے پہلے انتظار۔

صلاحیت اس انسٹال شدہ پلگ ان سے حل ہوتی ہے جو اسے فراہم کرتا ہو، اور ترجیح اس پلگ ان کو ملتی ہے جس پر اس ملازم کا اکاؤنٹ ہو۔ ایسا کوئی پلگ ان نہ ہو تو ورک فلو کمزور کے نشان کے ساتھ دکھایا جاتا ہے اور مالک کو بتایا جاتا ہے کہ کیا کنیکٹ کرنا ہے۔ بار بار کریش ہونے والا نگران ایک تاخیر کے بعد دوبارہ شروع ہوتا ہے جو 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تمام فائلیںمیل کھانے والی فائل ایکسٹینشنز، نقطے کے بغیر۔
recursivetrueذیلی فولڈرز شامل کریں۔
debounce_secs2اس وقفے کے اندر ہونے والی تبدیلیاں ایک رن بن جاتی ہیں۔

رن کو بدلے ہوئے پاتھس _watch_payload.files میں ملتے ہیں۔

manual

{ "type": "manual" }

manual ورک فلو صرف تب چلتا ہے جب مالک اسے چلائے یا کوئی ملازم run_workflow کال کرے۔ ہر ورک فلو، چاہے اس کا ٹرگر کچھ بھی ہو، اس طرح بھی چلایا جا سکتا ہے۔

call

{"type": "call", "line": "..."} صرف "type": "call_tree" والے ورک فلو میں درست ہے، جو یہ ترتیب دیتا ہے کہ ملازم فون لائن پر کیسے جواب دیتا ہے۔ خالی line ہر اس لائن پر لاگو ہوتی ہے جس کا ملازم جواب دیتا ہے اور جس کا کوئی زیادہ مخصوص ٹری نہیں۔ کال ٹری میں ٹھیک ایک خوش آمدید اور کم از کم ایک نام والا ارادہ ہونا ضروری ہے۔

ویب ہکس

مالک کسی ملازم کے لیے ویب ہک بھی بنا سکتا ہے۔ کسی ورک فلو سے جڑا ویب ہک وہ ورک فلو چلاتا ہے؛ ورک فلو کے بغیر ویب ہک اپنا پے لوڈ ملازم کی چیٹ میں پہنچا دیتا ہے۔