NeboAI
NeboAI
Começar

Eventos

Os eventos permitem que o trabalho de um funcionário dê início ao de outro. Um funcionário anuncia que algo aconteceu; qualquer fluxo de trabalho cujo acionador de evento corresponda ao nome é executado. Quem produz e quem consome nunca precisam de se conhecer.

Anunciar um evento

Indique os eventos que um fluxo de trabalho anuncia no campo emit e ligue a atividade que os anuncia a __emit__. Essa atividade recebe a indicação de chamar a ferramenta emit_event quando terminar.

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

Qualquer atividade também pode anunciar um evento diretamente. emit_event está disponível em todos os passos de um fluxo de trabalho.

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

O Nebo acrescenta um campo producer ao payload e define como origem do evento a sessão que o emitiu.

Como se formam os nomes dos eventos

Escreva o nome curto, como report.ready. O Nebo acrescenta-lhe como prefixo o slug do funcionário que o produz, pelo que um evento do contabilista passa a bookkeeper.report.ready. Um nome que já contém o slug fica como está, e os eventos da empresa mantêm os nomes simples.

Reagir a um evento

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

As fontes correspondem exatamente ou com um .* no fim, como bookkeeper.*. A execução recebe _event_source, _event_payload e _event_origin. Um payload de 8 KB ou mais é reduzido aos seus campos escalares, mantendo os cabeçalhos de email e as referências a anexos.

Eventos incorporados

EventoQuando
assignment.done, assignment.blocked, assignment.failedUma tarefa atribuída termina, fica parada ou falha.
facts_changed, layers_changedOs dados da empresa ou a camada da empresa mudam.
pack_installed, pack_updated, pack_removedUm pacote da camada da empresa muda.
agent.installed, agent.updated, agent.uninstallingUm funcionário é contratado, atualizado ou removido.
account.connected, account.disconnectedUma conta é ligada ou desligada.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Mensagens do NeboAI.

Eventos de plugins

Um acionador watch com um event emite cada linha do observador do plugin como <plugin>.<event>, como notes-sync.note.created, para que outros fluxos de trabalho a possam subscrever com um acionador de evento. Os plugins declaram os seus eventos no plugin.json; consulte a referência do plugin.json.