NeboAI
NeboAI
Empezar

Eventos

Los eventos permiten que el trabajo de un empleado inicie el de otro. Un empleado anuncia que ha pasado algo; se ejecuta cualquier flujo de trabajo cuyo disparador de evento coincida con el nombre. Los productores y los consumidores nunca necesitan conocerse entre sí.

Anunciar un evento

Indica los eventos que anuncia un flujo de trabajo en su campo emit y conecta la actividad que los anuncia a __emit__. A esa actividad se le indica que llame a la herramienta emit_event cuando 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"]
}

Cualquier actividad puede también anunciar un evento directamente. emit_event está disponible en todos los pasos de un flujo de trabajo.

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

Nebo añade un campo producer a la carga útil y fija como origen del evento la sesión que lo emitió.

Cómo se forman los nombres de los eventos

Escribe el nombre corto, como report.ready. Nebo le antepone el slug del empleado que lo produce, así que un evento del contable pasa a ser bookkeeper.report.ready. Un nombre que ya contiene el slug se deja tal cual, y los eventos de la empresa conservan su nombre sin prefijo.

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

Las fuentes coinciden exactamente o con un .* final, como bookkeeper.*. La ejecución recibe _event_source, _event_payload y _event_origin. Una carga útil de 8 KB o más se reduce a sus campos escalares, conservando las cabeceras de correo y las referencias a adjuntos.

Eventos integrados

EventoCuándo
assignment.done, assignment.blocked, assignment.failedUna tarea asignada termina, se atasca o falla.
facts_changed, layers_changedCambian los datos de la empresa o la capa de empresa.
pack_installed, pack_updated, pack_removedCambia un paquete de la capa de empresa.
agent.installed, agent.updated, agent.uninstallingSe contrata, actualiza o quita a un empleado.
account.connected, account.disconnectedSe conecta o desconecta una cuenta.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Mensajes de NeboAI.

Eventos de plugins

Un disparador watch con un event emite cada línea del observador del plugin como <plugin>.<event>, como notes-sync.note.created, para que otros flujos de trabajo puedan suscribirse con un disparador de evento. Los plugins declaran sus eventos en plugin.json; consulta la referencia de plugin.json.