NeboAI
NeboAI
Začať

Udalosti

Udalosti umožňujú, aby práca jedného zamestnanca spustila prácu iného. Zamestnanec oznámi, že sa niečo stalo; spustí sa každý pracovný postup, ktorého spúšťač udalosti sa zhoduje s názvom. Producenti a odberatelia o sebe nikdy nemusia vedieť.

Oznámenie udalosti

Udalosti, ktoré pracovný postup oznamuje, uveďte v jeho poli emit a aktivitu, ktorá ich oznamuje, pripojte k __emit__. Táto aktivita dostane pokyn zavolať po dokončení nástroj 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"]
}

Udalosť môže oznámiť aj ktorákoľvek aktivita priamo. emit_event je k dispozícii v každom kroku pracovného postupu.

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

Nebo do obsahu pridá pole producer a ako pôvod udalosti nastaví reláciu, ktorá ju vyslala.

Ako vznikajú názvy udalostí

Napíšte krátky názov, napríklad report.ready. Nebo pred neho pridá slug zamestnanca, ktorý udalosť vytvoril, takže udalosť od účtovníka sa zmení na bookkeeper.report.ready. Názov, ktorý už slug obsahuje, zostane nezmenený a firemné udalosti si ponechajú holé názvy.

Reakcia na udalosť

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

Zdroje sa zhodujú presne alebo so zástupným .* na konci, napríklad bookkeeper.*. Beh dostane _event_source, _event_payload a _event_origin. Obsah s veľkosťou 8 KB a viac sa skráti na skalárne polia, pričom sa zachovajú hlavičky e-mailov a odkazy na prílohy.

Vstavané udalosti

UdalosťKedy
assignment.done, assignment.blocked, assignment.failedÚloha sa dokončí, zasekne alebo zlyhá.
facts_changed, layers_changedZmenia sa firemné údaje alebo firemná vrstva.
pack_installed, pack_updated, pack_removedZmení sa balík firemnej vrstvy.
agent.installed, agent.updated, agent.uninstallingZamestnanec je prijatý, aktualizovaný alebo odobratý.
account.connected, account.disconnectedÚčet sa pripojí alebo odpojí.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Správy od NeboAI.

Udalosti doplnkov

Spúšťač watch s event vysiela každý riadok sledovača doplnku ako <plugin>.<event>, napríklad notes-sync.note.created, takže iné pracovné postupy sa naň môžu prihlásiť spúšťačom udalosti. Doplnky deklarujú svoje udalosti v plugin.json; pozrite referenciu k plugin.json.