Annoncer un événement
Listez les événements qu'annonce un workflow dans son champ emit, et reliez l'activité qui les annonce à __emit__. Cette activité reçoit la consigne d'appeler l'outil emit_event quand elle se termine.
"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"]
} Toute activité peut aussi annoncer un événement directement. emit_event est disponible à chaque étape de workflow.
emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 }) Nebo ajoute un champ producer à la charge utile et définit comme origine de l'événement la session qui l'a émis.
Comment sont formés les noms d’événements
Écrivez le nom court, par exemple report.ready. Nebo le préfixe avec le slug de l'employé qui le produit : un événement du comptable devient bookkeeper.report.ready. Un nom qui contient déjà le slug est laissé tel quel, et les événements de l'entreprise gardent leur nom nu.
Réagir à un événement
"review-report": {
"trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
"activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
} Les sources correspondent exactement ou avec un .* final, par exemple bookkeeper.*. L'exécution reçoit _event_source, _event_payload et _event_origin. Une charge utile de 8 KB ou plus est réduite à ses champs scalaires, en conservant les en-têtes des e-mails et les références aux pièces jointes.
Événements intégrés
| Événement | Quand |
|---|---|
assignment.done, assignment.blocked, assignment.failed | Une mission se termine, se bloque ou échoue. |
facts_changed, layers_changed | Les informations sur l’entreprise ou la couche entreprise changent. |
pack_installed, pack_updated, pack_removed | Un pack de la couche entreprise change. |
agent.installed, agent.updated, agent.uninstalling | Un employé est recruté, mis à jour ou retiré. |
account.connected, account.disconnected | Un compte est connecté ou déconnecté. |
neboai.<topic>, neboai.channel, neboai.agent_space.<slug> | Messages de NeboAI. |
Événements des plugins
Un déclencheur watch doté d'un event émet chaque ligne de l'observateur du plugin sous la forme <plugin>.<event>, par exemple notes-sync.note.created, pour que d'autres workflows puissent s'y abonner avec un déclencheur d'événement. Les plugins déclarent leurs événements dans plugin.json ; voir la référence de plugin.json.