| نوع | اجرا میشود وقتی |
|---|---|
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_payload میرسد. خطوط یکسان در طول ده دقیقه کنار گذاشته میشوند.
| فیلد | پیشفرض | معنی |
|---|---|---|
plugin | الزامی | یک قابلیت، مانند mail، یا slug یک افزونه. هر جا قابلیتی مناسب است، آن را نام ببرید. |
event | هیچ | رویدادی از فهرست events افزونه. Nebo از فرمان آن رویداد استفاده میکند و هر خط را هم به شکل <plugin>.<event> منتشر میکند. |
command | هیچ | آرگومانهایی که ناظر را اجرا میکنند. در صورت تنظیم استفاده میشوند؛ وگرنه از event گرفته میشوند. |
restart_delay_secs | 5 | مدت انتظار پیش از راهاندازی دوباره ناظری که متوقف شده. |
یک قابلیت به افزونه نصبشدهای که آن را ارائه میدهد ارجاع داده میشود، و افزونهای که این کارمند در آن حساب دارد ترجیح داده میشود. اگر چنین افزونهای نباشد، گردشکار ناقص علامت میخورد و به مالک گفته میشود چه چیزی را متصل کند. ناظری که مدام از کار بیفتد با تأخیری که تا ۳۰۰ ثانیه دو برابر میشود دوباره راهاندازی میشود و پس از ۳۰ ثانیه کار بیوقفه به حالت اول برمیگردد.
{ "type": "watch", "plugin": "notes-sync", "command": "watch --notebook {{notebook}} --format ndjson" } {{key}} در command از پاسخهای مالک به ورودیهای کارمند پر میشود. اگر جاینگهداری پاسخی نداشته باشد، پایش شروع نمیشود.
folder
{ "type": "folder", "path": "{{inbox_folder}}", "extensions": ["pdf"], "recursive": false } | فیلد | پیشفرض | معنی |
|---|---|---|
path | الزامی | مسیر مطلق پوشه. {{key}} از ورودیها پر میشود. |
extensions | همه فایلها | پسوندهای فایل برای تطبیق، بدون نقطه. |
recursive | true | شامل زیرپوشهها. |
debounce_secs | 2 | تغییرات درون این بازه یک اجرا میشوند. |
اجرا مسیرهای تغییریافته را در _watch_payload.files دریافت میکند.
manual
{ "type": "manual" } یک گردشکار دستی فقط وقتی اجرا میشود که مالک آن را اجرا کند یا یک کارمند run_workflow را فراخوانی کند. هر گردشکاری، با هر تریگری، به این شکل هم قابل اجراست.
call
{"type": "call", "line": "..."} فقط در گردشکاری از نوع "type": "call_tree" معتبر است که نحوهٔ پاسخگویی کارمند به یک خط تلفن را تنظیم میکند. line خالی روی همهٔ خطهایی اعمال میشود که کارمند پاسخ میدهد و درخت مشخصتری ندارند. درخت تماس باید دقیقاً یک خوشامدگویی و دستکم یک قصد نامدار داشته باشد.
وبهوکها
مالک میتواند برای یک کارمند وبهوک هم بسازد. وبهوکی که به یک گردشکار وصل است آن گردشکار را اجرا میکند؛ وبهوکی بدون گردشکار محمولهاش را به گفتگوی کارمند میرساند.