イベントを告知する
ワークフローが告知するイベントを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はその前に発行した社員のスラッグを付けるので、経理担当からのイベントはbookkeeper.report.readyになります。すでにスラッグを含む名前はそのままで、会社のイベントは接頭辞のない名前のままです。
イベントに反応する
"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を持つウォッチトリガーは、プラグインの監視役の各行をnotes-sync.note.createdのような<plugin>.<event>として発行するので、他のワークフローはイベントトリガーで購読できます。プラグインはplugin.jsonでイベントを宣言します。plugin.jsonリファレンスをご覧ください。