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はその前に発行した社員のスラッグを付けるので、経理担当からのイベントは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リファレンスをご覧ください。