NeboAI
NeboAI
Inizia

Eventi

Gli eventi permettono al lavoro di un dipendente di avviare quello di un altro. Un dipendente annuncia che è successo qualcosa; ogni flusso di lavoro il cui trigger di evento corrisponde al nome viene eseguito. Chi produce e chi consuma non ha mai bisogno di conoscersi.

Annuncia un evento

Elenca gli eventi che un flusso di lavoro annuncia nel suo campo emit, e collega a __emit__ l'attività che li annuncia. A quell'attività viene detto di chiamare lo strumento emit_event quando termina.

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

Qualsiasi attività può anche annunciare un evento direttamente. emit_event è disponibile in ogni passaggio di un flusso di lavoro.

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

Nebo aggiunge un campo producer al payload e imposta come origine dell'evento la sessione che lo ha emesso.

Come si formano i nomi degli eventi

Scrivi il nome breve, come report.ready. Nebo aggiunge come prefisso lo slug del dipendente che lo produce, quindi un evento del contabile diventa bookkeeper.report.ready. Un nome che contiene già lo slug resta invariato, e gli eventi aziendali mantengono i loro nomi semplici.

Reagisci a un evento

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

Le fonti corrispondono esattamente oppure con un .* finale, come bookkeeper.*. L'esecuzione riceve _event_source, _event_payload e _event_origin. Un payload di 8 KB o più viene ridotto ai suoi campi scalari, mantenendo le intestazioni delle email e i riferimenti agli allegati.

Eventi integrati

EventoQuando
assignment.done, assignment.blocked, assignment.failedUn incarico termina, si blocca o non riesce.
facts_changed, layers_changedCambiano i dati dell'azienda o il livello aziendale.
pack_installed, pack_updated, pack_removedCambia un pacchetto del livello aziendale.
agent.installed, agent.updated, agent.uninstallingUn dipendente viene assunto, aggiornato o rimosso.
account.connected, account.disconnectedUn account viene collegato o scollegato.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Messaggi da NeboAI.

Eventi dei plugin

Un trigger watch con un event emette ogni riga dell'osservatore del plugin come <plugin>.<event>, come notes-sync.note.created, così altri flussi di lavoro possono iscriversi con un trigger di evento. I plugin dichiarano i loro eventi in plugin.json; vedi il riferimento di plugin.json.