NeboAI
NeboAI
Zacznij

Zdarzenia

Zdarzenia pozwalają, by praca jednego pracownika uruchamiała pracę innego. Pracownik ogłasza, że coś się wydarzyło; uruchamia się każdy przepływ pracy, którego wyzwalacz zdarzenia pasuje do nazwy. Nadawcy i odbiorcy nigdy nie muszą o sobie wiedzieć.

Ogłoś zdarzenie

Wymień zdarzenia ogłaszane przez przepływ pracy w jego polu emit i połącz czynność, która je ogłasza, z __emit__. Ta czynność dostaje polecenie wywołania narzędzia emit_event po zakończeniu.

"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"]
}

Każda czynność może też ogłosić zdarzenie bezpośrednio. emit_event jest dostępne w każdym kroku przepływu pracy.

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

Nebo dodaje do danych pole producer i ustawia pochodzenie zdarzenia na sesję, która je wyemitowała.

Jak tworzone są nazwy zdarzeń

Napisz krótką nazwę, np. report.ready. Nebo dodaje do niej przedrostek ze slugiem pracownika, który je tworzy, więc zdarzenie od księgowego staje się bookkeeper.report.ready. Nazwa, która już zawiera slug, pozostaje bez zmian, a zdarzenia firmy zachowują swoje proste nazwy.

Reaguj na zdarzenie

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

Źródła pasują dokładnie albo z końcówką .*, np. bookkeeper.*. Uruchomienie otrzymuje _event_source, _event_payload i _event_origin. Dane o rozmiarze 8 KB lub większym są skracane do pól skalarnych, z zachowaniem nagłówków e-maili i odwołań do załączników.

Wbudowane zdarzenia

ZdarzenieKiedy
assignment.done, assignment.blocked, assignment.failedZadanie zostaje ukończone, utyka lub kończy się niepowodzeniem.
facts_changed, layers_changedZmieniają się fakty o firmie lub warstwa firmy.
pack_installed, pack_updated, pack_removedZmienia się pakiet warstwy firmy.
agent.installed, agent.updated, agent.uninstallingPracownik zostaje zatrudniony, zaktualizowany lub usunięty.
account.connected, account.disconnectedKonto zostaje połączone lub rozłączone.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Wiadomości od NeboAI.

Zdarzenia wtyczek

Wyzwalacz obserwacji z polem event emituje każdy wiersz obserwatora wtyczki jako <plugin>.<event>, np. notes-sync.note.created, dzięki czemu inne przepływy pracy mogą je subskrybować wyzwalaczem zdarzenia. Wtyczki deklarują swoje zdarzenia w plugin.json; zobacz dokumentację plugin.json.