| Тип | Запускається, коли |
|---|---|
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 | Очікування перед перезапуском спостерігача, що завершився. |
Можливість зводиться до встановленого плагіна, який її надає, з перевагою для того, у якому цей співробітник має акаунт. Якщо такого плагіна немає, робочий процес позначається як обмежений, а власнику повідомляють, що підключити. Спостерігач, який постійно падає, перезапускається із затримкою, що подвоюється до 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 застосовується до кожної лінії, на яку відповідає співробітник і для якої немає конкретнішого дерева. Дерево дзвінків повинно мати рівно одне привітання й щонайменше один іменований намір.
Вебхуки
Власник також може створити вебхук для співробітника. Вебхук, прив'язаний до робочого процесу, запускає цей процес; вебхук без робочого процесу доставляє своє корисне навантаження в чат співробітника.