読み込み中

効果的なサブエージェントの設計

レッスン 310 分
読み込み中

効果的なサブエージェントの設計

要約文字起こし

サブエージェントの作成方法がわかったところで、次はそれらを実際に効果的にするパターンを見ていきましょう。設定が不十分なサブエージェントは、迷走したり、実行時間が長すぎたり、メインエージェントが使えない出力を生成したりします。その対策は4つに集約されます。良い説明文を書くこと、出力フォーマットを定義すること、障害を報告すること、そしてツールアクセスを制限することです。

サブエージェント設定データがどのように使われるか

メインのコンテキストウィンドウエージェントにメッセージを送ると、利用可能なすべてのサブエージェントの名前と説明がシステムプロンプトに含まれます。これにより、メインエージェントはどのサブエージェントをいつ起動するかを判断します。サブエージェントが自動的にトリガーされるタイミングをより細かく制御したい場合、調整すべきなのは名前と説明です。

説明にはもう一つの役割もあります。メインエージェントがサブエージェントを起動する際、タスクを開始するための入力プロンプトを書きます。その際、説明をプロンプト作成のガイダンスとして使用します。つまり、説明は単にサブエージェントがいつ実行されるかを制御するだけでなく、サブエージェントに何をするよう指示するかも形作るのです。

サブエージェント設定ファイルの名前と説明フィールド、それらがメインエージェントのプロンプト入力に流れ込む様子を示す矢印

入力プロンプトを形作る説明文の書き方

コードレビュー用のサブエージェントを考えてみましょう。一般的な説明文だと、メインエージェントは「git diffを使って現在の変更を見つけてください」のような入力プロンプトを書くかもしれません。これは曖昧です。サブエージェントはどのファイルが重要かを自分で判断しなければなりません。

説明文を「レビューしてほしいファイルを正確にエージェントに伝える必要があります」のような内容に更新すると、メインエージェントはレビュー対象の実際のファイルを列挙した、はるかに具体的な入力プロンプトを書くようになります。

この手法は異なるタイプのサブエージェントにも同様に機能します。例えば、ウェブ検索サブエージェントの説明に「引用可能な情報源を返す」を追加すると、メインエージェントはタスクを委任する際にその指示を含めるようになります。

code-quality-reviewerサブエージェントに、変更されたファイルとレビューの焦点領域を列挙した具体的な入力プロンプトで委任するメインエージェント

出力フォーマットの定義

サブエージェントに対して行える最も重要な改善は、システムプロンプト内で出力フォーマットを定義することです。これには2つの効果があります。

  • 自然な停止ポイントが生まれます。サブエージェントはフォーマットの各セクションを埋め終えたときに、自分の作業が完了したことがわかります。
  • サブエージェントが長く実行されすぎるのを防ぎます。出力が定義されていないと、サブエージェントは十分な調査が行われたかどうかを判断するのに苦労し、必要以上に長く実行される傾向があります。

以下は、コードレビュー用サブエージェントの構造化された出力フォーマットの例です。

レビューを構造化された形式で提供してください:

  1. 概要:レビューした内容と全体的な評価の簡潔な概要
  2. 重大な問題:直ちに修正が必要なセキュリティ脆弱性、データ整合性リスク、またはロジックエラー
  3. 主要な問題:品質の問題、アーキテクチャの不整合、または重大なパフォーマンス上の懸念
  4. 軽微な問題:スタイルの不一致、ドキュメントの不足、または小さな最適化
  5. 推奨事項:改善のための提案、リファクタリングの機会、または適用すべきベストプラクティス
  6. 承認ステータス:コードがマージ/デプロイ可能かどうか、または変更が必要かどうかの明確な記述

このフォーマットは、サブエージェントに取り組むべき明確なチェックリストを与えます。すべてのセクションが埋まれば、サブエージェントは作業を停止できることがわかります。

障害の報告

サブエージェントが作業中に回避策を発見した場合 -- 依存関係の問題を解決したり、特定のコマンドに特定のフラグが必要だとわかったりした場合 -- その詳細は返されるサマリーに記載される必要があります。そうしないと、メインスレッドは同じ解決策を自分で再発見しなければならず、時間とトークンが無駄になります。

表面化させたい情報の種類には以下が含まれます。

  • セットアップの問題や環境特有の癖
  • タスク中に発見された回避策
  • 特別なフラグや設定が必要だったコマンド
  • 問題を引き起こした依存関係やインポート

この情報を得る方法は、出力フォーマットの中で明示的に要求することです。出力テンプレートに「遭遇した障害」セクションを追加すると、この情報を確実に表面化できます。

  1. 遭遇した障害:レビュー作業中に遭遇した障害を報告してください。これには、セットアップの問題、発見された回避策、環境特有の癖が含まれます。特別なフラグや設定が必要だったコマンドを報告してください。問題を引き起こした依存関係やインポートを報告してください。

エディタで開かれたcode-quality-reviewerのシステムプロンプト。出力フォーマットの「遭遇した障害」セクションがハイライトされている

ツールアクセスの制限

すべてのサブエージェントがすべてのツールにアクセスする必要があるわけではありません。サブエージェントが実際に何をする必要があるかを考え、その仕事に必要なツールだけを与えましょう。これには2つの効果があります。意図しない副作用を防ぐこと、そして複数のサブエージェントがある場合に各サブエージェントの役割をより明確にすることです。

一般的なサブエージェントのタイプについて、ツールアクセスをどう考えるべきかを以下に示します。

  • リサーチ / 読み取り専用サブエージェント -- Glob、Grep、Readだけが必要です。誤ってファイルを変更することはできません。
  • コードレビュアー -- git diffを実行して変更内容を確認するためにBashアクセスが必要ですが、それでもEditやWriteは必要ありません。
  • スタイリング / コード変更エージェント -- ここでEditとWriteのアクセスを与えます。なぜなら、このサブエージェントの仕事は実際にコードを変更することだからです。

すべてをまとめる

効果的なサブエージェントには4つの特徴があります。

  1. 具体的な説明 -- 説明は、サブエージェントがいつ起動されるか、そしてどのような指示を受け取るかを制御します。両方を誘導するように書きましょう。
  2. 構造化された出力 -- システムプロンプトで出力フォーマットを定義し、サブエージェントが作業完了のタイミングを把握し、メインスレッドが使える情報を返せるようにしましょう。
  3. 障害の報告 -- 回避策、癖、問題のためのセクションを出力フォーマットに含め、メインスレッドがそれらを再発見しなくて済むようにしましょう。
  4. 限定されたツールアクセス -- サブエージェントには実際に必要なツールだけを与えましょう。リサーチには読み取り専用、レビュアーにはbash、コードを変更すべきエージェントにのみedit/writeを与えます。

これらのパターンはそれぞれ単体では単純ですが、組み合わせることで、サブエージェントは漠然と手伝おうとするだけの存在から、時間通りに作業を終え、明確に報告する、焦点の定まった予測可能な作業者へと変わります。