| النوع | يعمل عندما |
|---|---|
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، أو الاسم المختصر لإضافة. سمِّ قدرة كلما كان ذلك مناسبًا. |
event | لا شيء | حدث من قائمة events الخاصة بالإضافة. يستخدم Nebo أمر ذلك الحدث ويُصدر أيضًا كل سطر بالشكل <plugin>.<event>. |
command | لا شيء | الوسائط التي تشغّل المراقِب. تُستخدم عند ضبطها، وإلا تؤخذ من event. |
restart_delay_secs | 5 | الانتظار قبل إعادة تشغيل مراقِب توقف. |
تُحلّ القدرة إلى الإضافة المثبّتة التي توفّرها، مع تفضيل إضافة لهذا الموظف حساب عليها. وإن لم توجد إضافة كهذه، يُعلَّم سير العمل بأنه متراجع ويُبلَّغ المالك بما يجب ربطه. والمراقِب الذي يستمر في التعطّل يُعاد تشغيله بتأخير يتضاعف حتى 300 ثانية، ويُعاد ضبطه بعد 30 ثانية من العمل المتواصل.
{ "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 الفارغة على كل خط يرد عليه الموظف ولا توجد له شجرة أكثر تحديدًا. ويجب أن تحتوي شجرة المكالمات على تحية واحدة بالضبط ونية مُسمّاة واحدة على الأقل.
Webhooks
يستطيع المالك أيضًا إنشاء webhook لموظف. الـ webhook المرتبط بسير عمل يشغّل ذلك السير، والذي لا يرتبط بسير عمل يسلّم حمولته إلى محادثة الموظف.