NeboAI
NeboAI
Začít

Události

Události umožňují, aby práce jednoho zaměstnance spustila práci jiného. Zaměstnanec ohlásí, že se něco stalo; spustí se každý pracovní postup, jehož spouštěč událostí odpovídá danému názvu. Producenti a příjemci o sobě nikdy nemusejí vědět.

Ohlášení události

Události, které pracovní postup ohlašuje, uveďte v jeho poli emit a činnost, která je ohlašuje, připojte k __emit__. Tato činnost dostane pokyn zavolat 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"]
}

Událost může ohlásit přímo i kterákoli jiná činnost. emit_event je k dispozici v každém kroku pracovního postupu.

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

Nebo přidá do datové části pole producer a jako původ události nastaví relaci, která ji vyslala.

Jak vznikají názvy událostí

Napište krátký název, například report.ready. Nebo před něj přidá slug zaměstnance, který událost vytvořil, takže z události od účetního se stane bookkeeper.report.ready. Název, který už slug obsahuje, zůstane beze změny a firemní události si ponechávají holé názvy.

Reakce na událost

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

Zdroje se shodují přesně, nebo s koncovým .*, například bookkeeper.*. Běh dostane _event_source, _event_payload a _event_origin. Datová část o velikosti 8 KB a více se zkrátí na skalární pole, přičemž hlavičky e-mailů a odkazy na přílohy zůstanou zachovány.

Vestavěné události

UdálostKdy
assignment.done, assignment.blocked, assignment.failedÚkol se dokončí, uvázne nebo selže.
facts_changed, layers_changedZmění se firemní údaje nebo firemní vrstva.
pack_installed, pack_updated, pack_removedZmění se balíček firemní vrstvy.
agent.installed, agent.updated, agent.uninstallingZaměstnanec je přijat, aktualizován nebo odebrán.
account.connected, account.disconnectedÚčet se připojí nebo odpojí.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Zprávy od NeboAI.

Události pluginů

Spouštěč watch s polem event vysílá každý řádek sledovače pluginu jako <plugin>.<event>, například notes-sync.note.created, takže se k odběru mohou přihlásit další pracovní postupy se spouštěčem událostí. Pluginy deklarují své události v plugin.json; viz referenční příručku k plugin.json.