NeboAI
NeboAI
Начать

События

События позволяют работе одного сотрудника запускать работу другого. Сотрудник объявляет, что что-то произошло; запускается любой рабочий процесс, чей триггер события совпадает с именем. Источникам и получателям не нужно знать друг о друге.

Объявите событие

Перечислите события, которые объявляет рабочий процесс, в его поле emit и соедините действие, которое их объявляет, с __emit__. Этому действию предписывается вызвать инструмент emit_event по завершении.

"weekly-report": {
  "trigger": { "type": "schedule", "cron": "0 16 * * 5" },
  "activities": [ { "id": "write", "intent": "Write the weekly revenue report." } ],
  "connections": [
    { "from": "__trigger__", "to": "write" },
    { "from": "write", "to": "__emit__" }
  ],
  "emit": ["report.ready"]
}

Любое действие также может объявить событие напрямую. emit_event доступен на каждом шаге рабочего процесса.

emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 })

Nebo добавляет в полезные данные поле producer и задаёт источником события сессию, которая его отправила.

Как формируются имена событий

Пишите короткое имя, например report.ready. Nebo добавляет к нему префикс slug сотрудника-источника, поэтому событие от бухгалтера становится bookkeeper.report.ready. Имя, которое уже содержит slug, не меняется, а события компании сохраняют свои имена без префикса.

Реагируйте на событие

"review-report": {
  "trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
  "activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
}

Источники совпадают точно или с .* в конце, например bookkeeper.*. Запуск получает _event_source, _event_payload и _event_origin. Полезные данные размером 8 КБ и больше сокращаются до скалярных полей с сохранением заголовков писем и ссылок на вложения.

Встроенные события

СобытиеКогда
assignment.done, assignment.blocked, assignment.failedПоручение завершено, застопорилось или не выполнено.
facts_changed, layers_changedИзменились сведения о компании или уровень компании.
pack_installed, pack_updated, pack_removedИзменился пакет уровня компании.
agent.installed, agent.updated, agent.uninstallingСотрудник нанят, обновлён или удалён.
account.connected, account.disconnectedАккаунт подключён или отключён.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Сообщения от NeboAI.

События плагинов

Триггер наблюдения с event выдаёт каждую строку наблюдателя плагина как <plugin>.<event>, например notes-sync.note.created, чтобы другие рабочие процессы могли подписаться на неё триггером события. Плагины объявляют свои события в plugin.json; см. справочник по plugin.json.