宣告事件
在工作流程的 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 的監看觸發條件,會將外掛監看程式的每一行以 <plugin>.<event> 的形式發出,例如 notes-sync.note.created,讓其他工作流程能以事件觸發條件訂閱。外掛會在 plugin.json 中宣告它們的事件;請參閱 plugin.json 參考。