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_payload می‌رسد. خطوط یکسان در طول ده دقیقه کنار گذاشته می‌شوند.

فیلدپیش‌فرضمعنی
pluginالزامییک قابلیت، مانند mail، یا slug یک افزونه. هر جا قابلیتی مناسب است، آن را نام ببرید.
eventهیچرویدادی از فهرست events افزونه. Nebo از فرمان آن رویداد استفاده می‌کند و هر خط را هم به شکل <plugin>.<event> منتشر می‌کند.
commandهیچآرگومان‌هایی که ناظر را اجرا می‌کنند. در صورت تنظیم استفاده می‌شوند؛ وگرنه از event گرفته می‌شوند.
restart_delay_secs5مدت انتظار پیش از راه‌اندازی دوباره ناظری که متوقف شده.

یک قابلیت به افزونه نصب‌شده‌ای که آن را ارائه می‌دهد ارجاع داده می‌شود، و افزونه‌ای که این کارمند در آن حساب دارد ترجیح داده می‌شود. اگر چنین افزونه‌ای نباشد، گردش‌کار ناقص علامت می‌خورد و به مالک گفته می‌شود چه چیزی را متصل کند. ناظری که مدام از کار بیفتد با تأخیری که تا ۳۰۰ ثانیه دو برابر می‌شود دوباره راه‌اندازی می‌شود و پس از ۳۰ ثانیه کار بی‌وقفه به حالت اول برمی‌گردد.

{ "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همه فایل‌هاپسوندهای فایل برای تطبیق، بدون نقطه.
recursivetrueشامل زیرپوشه‌ها.
debounce_secs2تغییرات درون این بازه یک اجرا می‌شوند.

اجرا مسیرهای تغییریافته را در _watch_payload.files دریافت می‌کند.

manual

{ "type": "manual" }

یک گردش‌کار دستی فقط وقتی اجرا می‌شود که مالک آن را اجرا کند یا یک کارمند run_workflow را فراخوانی کند. هر گردش‌کاری، با هر تریگری، به این شکل هم قابل اجراست.

call

{"type": "call", "line": "..."} فقط در گردش‌کاری از نوع "type": "call_tree" معتبر است که نحوهٔ پاسخ‌گویی کارمند به یک خط تلفن را تنظیم می‌کند. line خالی روی همهٔ خط‌هایی اعمال می‌شود که کارمند پاسخ می‌دهد و درخت مشخص‌تری ندارند. درخت تماس باید دقیقاً یک خوشامدگویی و دست‌کم یک قصد نام‌دار داشته باشد.

وب‌هوک‌ها

مالک می‌تواند برای یک کارمند وب‌هوک هم بسازد. وب‌هوکی که به یک گردش‌کار وصل است آن گردش‌کار را اجرا می‌کند؛ وب‌هوکی بدون گردش‌کار محموله‌اش را به گفتگوی کارمند می‌رساند.