2025年8月31日日曜日

Copilot Agentモードでカスタムツールセットを作る方法

 

✅ カスタムツールセットとは?

カスタムツールセットとは、よく使うツールをグループ化してまとめて管理できる機能です。

例えば、以下のような用途に便利です:

  • テスト関連ツールだけをまとめたセット

  • 特定の開発フェーズ(デバッグ・リリースなど)で使うツールだけをまとめたい

  • 複数の拡張機能が追加するツールを整理したい


🛠 ツールセットの作り方(ステップバイステップ)

① Chatビューを開く

  1. VS Code を開く

  2. Ctrl + Alt + I で Chatビューを開く

  3. 右上の設定アイコン(⚙️)をクリック

  4. Configure Chat(チャットを設定)」を選択

  5. Tool Sets(ツールセット)」をクリック

  6. New tool sets file(新しいツールセットファイル)」を選択

もしくは、コマンドパレット(Ctrl + Shift + P)で Chat: Configure Tool Sets と入力してもOK!


② ツールセットファイルを作成

すると、以下のような .jsonc 形式のファイルが開きます:

{ "reader": { "tools": [ "changes", "codebase", "fetch", "findTestFiles", "githubRepo", "problems", "usages" ], "description": "description", "icon": "tag" } }

解説:

項目名説明
"reader"ツールセットの名前。プロンプト内で #reader と書けば呼び出せます。
"tools"このセットに含めたいツール名のリスト。
"description"ツールセットの簡単な説明。ツール選択画面で表示されます。
"icon"アイコン(任意)。VS CodeのProduct Icon Referenceで使える名前を選びます。

③ よく使うツールをセットにまとめる

例えば、「デバッグ用のツールセット」を作るとこんな感じ:

{ "debugTools": { "tools": [ "problems", "terminal", "logViewer", "findLogs" ], "description": "デバッグ作業に使うツールセット", "icon": "bug" } }

④ 作ったツールセットを使う

作成したツールセットは以下の方法で使用できます:

方法1:プロンプトで直接指定

#debugTools を使って問題を特定して修正して

方法2:Chatビューのツールピッカーで選択

  1. Chatビュー右上の🔧アイコン(Tools)をクリック

  2. 作成したツールセットにチェックを入れる


🎯 ツール名ってどこで確認できるの?

以下の3種類のツールがあります:

種類説明
Built-in toolsVS Codeに最初から入っているツール(例:problems, changes
MCPツールGitHubのMCPサーバー経由で提供される
拡張機能のツール拡張機能が追加する独自ツール

🔍 どんなツールが使えるかは、Chatビューの「Tools(ツール一覧)」で確認できます。


📝 補足:複数のツールセットを定義したい場合

以下のように、1つの .jsonc ファイルに複数のツールセットを定義できます:

{ "debugTools": { "tools": ["problems", "terminal"], "description": "デバッグ用", "icon": "bug" }, "testingTools": { "tools": ["findTestFiles", "runTests"], "description": "テスト関連", "icon": "beaker" } }

✅ ツールセットの活用ポイント

  • 目的別に分ける(デバッグ・テスト・開発・リリース)

  • プロンプトで呼び出しやすくする(短く覚えやすい名前)

  • プロジェクトごとにセットを切り替えると効率UP!


🚫 注意点

  • 1回のチャットで有効にできるツール数は 最大128個まで

  • 多すぎると「128個以上のツールが有効になっています」というエラーが出ます

  • その場合は、一部のツールを外すか、仮想ツールのしきい値を調整しましょう(設定名:github.copilot.chat.virtualTools.threshold


🔚 まとめ

項目内容
カスタムツールセットとは?ツールをまとめて管理する機能
作り方Chatビュー → Configure Chat → Tool Sets
書き方JSONCファイルで記述(名前・説明・ツール一覧・アイコン)
使い方プロンプトで #ツールセット名 と記述 or ツールピッカーから選択

0 件のコメント:

コメントを投稿