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

Веб-хуки

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