发布事件
在工作流的 emit 字段中列出它要发布的事件,并把负责发布的活动连接到 __emit__。该活动完成时会被告知调用 emit_event 工具。
"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"]
} 任何活动也都可以直接发布事件。emit_event 在每个工作流步骤中都可用。
emit_event(source: "report.ready", payload: { "period": "2026-W39", "total": 18250 }) Nebo 会在负载中添加一个 producer 字段,并把事件的来源设为发出它的会话。
事件名称如何构成
写短名称即可,例如 report.ready。Nebo 会在前面加上发出事件的员工的 slug,因此来自记账员的事件会变成 bookkeeper.report.ready。已经包含 slug 的名称保持不变,公司事件保留它们原本的名称。
对事件作出反应
"review-report": {
"trigger": { "type": "event", "sources": ["bookkeeper.report.ready"] },
"activities": [ { "id": "review", "intent": "Review the report in _event_payload and flag anything unusual." } ]
} 来源可以完全匹配,也可以带结尾的 .* 进行匹配,例如 bookkeeper.*。运行会收到 _event_source、_event_payload 和 _event_origin。8 KB 及以上的负载会被缩减为其标量字段,但保留邮件头和附件引用。
内置事件
| 事件 | 时机 |
|---|---|
assignment.done, assignment.blocked, assignment.failed | 某项任务分派完成、停滞或失败。 |
facts_changed, layers_changed | 公司信息或公司层发生变化。 |
pack_installed, pack_updated, pack_removed | 公司层的某个包发生变化。 |
agent.installed, agent.updated, agent.uninstalling | 某位员工被雇用、更新或移除。 |
account.connected, account.disconnected | 某个账户被连接或断开。 |
neboai.<topic>, neboai.channel, neboai.agent_space.<slug> | 来自 NeboAI 的消息。 |
插件事件
带有 event 的 watch 触发器,会把插件监听器的每一行作为 <plugin>.<event> 发出,例如 notes-sync.note.created,这样其他工作流就能用 event 触发器订阅。插件在 plugin.json 中声明它们的事件;参见 plugin.json 参考。