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 gatilho de evento corresponda ao nome é executado. Produtores e consumidores nunca precisam saber um do outro.

Anunciar um evento

Liste os eventos que um fluxo de trabalho anuncia no campo emit dele e conecte a atividade que os anuncia a __emit__. Essa atividade recebe a instruçã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 todas as etapas do fluxo de trabalho.

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

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

Como os nomes de eventos são formados

Escreva o nome curto, como report.ready. O Nebo acrescenta como prefixo o slug do funcionário que produziu o evento, então um evento do contador vira bookkeeper.report.ready. Um nome que já contém o slug não é alterado, 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 final, como bookkeeper.*. A execução recebe _event_source, _event_payload e _event_origin. Um payload de 8 KB ou mais é encurtado para os campos escalares, mantendo os cabeçalhos de e-mail e as referências a anexos.

Eventos integrados

EventoQuando
assignment.done, assignment.blocked, assignment.failedUma atribuição termina, trava 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 é conectada ou desconectada.
neboai.<topic>, neboai.channel, neboai.agent_space.<slug>Mensagens do NeboAI.

Eventos de plugin

Um gatilho 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 possam assiná-lo com um gatilho de evento. Os plugins declaram os eventos deles no plugin.json; veja a referência do plugin.json.