NeboAI
NeboAI
開始使用

事件

事件讓一位員工的工作可以啟動另一位員工的工作。員工宣告某件事發生了;任何事件觸發條件與該名稱相符的工作流程就會執行。產生者與使用者彼此完全不需要知道對方。

宣告事件

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