CodeReviewPlan を出力し、誰かが承認するまで waiting_for_human で停止するスクリプトが 1 つできます。
ツールは固定のサンプルデータを返すため、このスクリプトは例示用です。実際にはコードホスティングサービスや CI への呼び出しに置き換えてください。パッケージ化した版は packages/sdk/agent-sdk-ts/examples/coding-review-agent.ts にあります。
作成する
1
インストールする
2
エージェントを書く
review-agent.ts
responseFormat によって Gateway はこのスキーマでリクエストし、outputSchema はパースした結果をプロセス内で再度確認します。strict モードのレスポンス修復は、すでに有効な JSON の包みを外すだけです。3
実行する
動作を確認する
- イベントログに、両方のツールの
tool.startedとtool.completedが表示され、ツールのステップの後にcheckpoint.savedが表示されます。 needsApproval: trueの計画では、最初の実行がwaiting_for_humanで終わり、計画はresult.run.pause.payloadに入ります。APPROVE=yesを付けるとcompletedまで続行します。- 設定 → 利用状況 → ログ では、各モデルターンにツール呼び出しが表示され、リクエストのプラグイン記録で修復が実行されたかどうかがわかります。
- スキーマに違反する計画は、不正なデータを返す代わりに
AgentSchemaValidationErrorで実行を失敗させます。
実際のリポジトリで安全に使う
レビュー用のツールは読み取り専用にしてください。コメント、プッシュ、マージを行うツールを追加する場合は、そのツールにrequireApproval: true を設定して実行前に一時停止させ、continueRun({ run, client, approvals: [toolCallId] }) で承認します。diff の内容は信頼できない入力として扱ってください。コードコメントにモデルを狙った指示が含まれている場合があります。レビューの待機中に再起動しても状態を保てるように、永続化可能なループのように state アクセサーで実行を保存してください。承認と却下については状態と承認で説明しています。