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

Вбудовані події

ПодіяКоли
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.