NeboAI
NeboAI
开始使用

事件

事件让一位员工的工作能够启动另一位员工的工作。一位员工宣布某件事发生了;任何 event 触发器与该名称匹配的工作流都会运行。生产者和消费者永远不需要知道彼此的存在。

发布事件

在工作流的 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 参考。