| Тип | Запускается, когда |
|---|---|
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 применяется к каждой линии, на которой отвечает сотрудник и для которой нет более конкретного дерева. В дереве звонка должно быть ровно одно приветствие и хотя бы одно именованное намерение.
Веб-хуки
Владелец также может создать веб-хук для сотрудника. Веб-хук, привязанный к рабочему процессу, запускает этот процесс; веб-хук без рабочего процесса доставляет полезные данные в чат сотрудника.