Ein Event ankündigen
Führe die Events, die ein Workflow ankündigt, in seinem Feld emit auf und verbinde die Aktivität, die sie ankündigt, mit __emit__. Diese Aktivität wird angewiesen, nach Abschluss das Tool emit_event aufzurufen.
"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"]
} Jede Aktivität kann ein Event auch direkt ankündigen. emit_event ist in jedem Workflow-Schritt verfügbar.
emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 }) Nebo fügt der Payload ein Feld producer hinzu und setzt als Ursprung des Events die Sitzung, die es ausgegeben hat.
Wie Event-Namen gebildet werden
Schreib den Kurznamen, etwa report.ready. Nebo stellt ihm den Slug des erzeugenden Mitarbeiters voran, sodass aus einem Event der Buchhaltung bookkeeper.report.ready wird. Ein Name, der den Slug bereits enthält, bleibt unverändert, und Unternehmens-Events behalten ihre bloßen Namen.
Auf ein Event reagieren
"review-report": {
"trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
"activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
} Quellen passen exakt oder mit einem abschließenden .*, etwa bookkeeper.*. Der Lauf erhält _event_source, _event_payload und _event_origin. Eine Payload ab 8 KB wird auf ihre skalaren Felder gekürzt, wobei E-Mail-Header und Verweise auf Anhänge erhalten bleiben.
Integrierte Events
| Event | Wann |
|---|---|
assignment.done, assignment.blocked, assignment.failed | Eine Zuweisung wird abgeschlossen, stockt oder schlägt fehl. |
facts_changed, layers_changed | Unternehmensfakten oder die Unternehmensebene ändern sich. |
pack_installed, pack_updated, pack_removed | Ein Paket der Unternehmensebene ändert sich. |
agent.installed, agent.updated, agent.uninstalling | Ein Mitarbeiter wird eingestellt, aktualisiert oder entfernt. |
account.connected, account.disconnected | Ein Konto wird verbunden oder getrennt. |
neboai.<topic>, neboai.channel, neboai.agent_space.<slug> | Nachrichten von NeboAI. |
Plugin-Events
Ein Watch-Trigger mit einem event gibt jede Zeile des Plugin-Watchers als <plugin>.<event> aus, etwa notes-sync.note.created, sodass andere Workflows es mit einem Event-Trigger abonnieren können. Plugins deklarieren ihre Events in plugin.json; siehe die plugin.json-Referenz.