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Очікування перед перезапуском спостерігача, що завершився.

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

Запуск отримує змінені шляхи в _watch_payload.files.

manual

{ "type": "manual" }

Ручний робочий процес запускається лише тоді, коли його запускає власник або співробітник викликає run_workflow. Так само можна запустити будь-який робочий процес, хоч би який у нього тригер.

call

{"type": "call", "line": "..."} дійсний лише в робочому процесі "type": "call_tree", який визначає, як співробітник відповідає на телефонній лінії. Порожній line застосовується до кожної лінії, на яку відповідає співробітник і для якої немає конкретнішого дерева. Дерево дзвінків повинно мати рівно одне привітання й щонайменше один іменований намір.

Вебхуки

Власник також може створити вебхук для співробітника. Вебхук, прив'язаний до робочого процесу, запускає цей процес; вебхук без робочого процесу доставляє своє корисне навантаження в чат співробітника.