NeboAI
NeboAI
Commencer

Événements

Les événements permettent au travail d'un employé d'en lancer un autre. Un employé annonce qu'il s'est passé quelque chose ; tout workflow dont le déclencheur d'événement correspond au nom s'exécute. Producteurs et consommateurs n'ont jamais besoin de se connaître.

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énementQuand
assignment.done, assignment.blocked, assignment.failedUne mission se termine, se bloque ou échoue.
facts_changed, layers_changedLes informations sur l’entreprise ou la couche entreprise changent.
pack_installed, pack_updated, pack_removedUn pack de la couche entreprise change.
agent.installed, agent.updated, agent.uninstallingUn employé est recruté, mis à jour ou retiré.
account.connected, account.disconnectedUn 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.