ライフサイクルフック

onEventを使うと、プロダクト画面の更新、監査記録の作成、既存のテレメトリーへのエージェント活動の接続ができます。

実行を監視する

const result = await agent.run({
  input,
  client,
  onEvent(event) {
    console.log(event.type, event.runId);
  },
});

イベントハンドラーは小さく保ちます。実行を遅らせてはならない低速なネットワーク処理やストレージ処理は、アプリケーションのキューに移します。

種類	イベント
実行	`run.started`, `run.resumed`, `run.waiting_for_human`, `run.cancelled`, `run.completed`, `run.failed`
ステップ	`step.started`, `step.completed`, `step.failed`, `step.cancelled`
モデル	`model.requested`, `model.completed`, `model.failed`
ツール	`tool.started`, `tool.preliminary_result`, `tool.completed`, `tool.failed`
状態	`checkpoint.saved`

完了したステップのチェックポイント保存後にstep.completedが発行されます。永続化やテレメトリーのコンシューマーは、これを安定した境界として扱えます。