Copilot クラウドエージェント用のカスタムエージェントの作成

          カスタム・エージェント を使用すると、特定のタスクに合わせて Copilotの専門知識を調整できます。 
          カスタム エージェントの概念の概要については、「[AUTOTITLE」](/copilot/concepts/agents/coding-agent/about-custom-agents)を参照してください。

メモ

カスタム・エージェントは、JetBrains IDE、Eclipse、Xcode 用パブリックプレビューにあり、変更される可能性があります。

リポジトリにカスタムエージェントプロファイルを作成する GitHub

       [
       https://github.com/copilot/agents
       ](https://github.com/copilot/agents?ref_product=copilot&ref_type=engagement&ref_style=text) の [エージェント] タブに移動します。

プロンプトボックスのドロップダウンメニューを使用して、カスタムエージェントプロファイルを作成するリポジトリを選択します。

メモ

組織と企業の所有者は、組織内または企業内のすべてのリポジトリで使用できるカスタムエージェントリポジトリに、組織レベルとエンタープライズレベルの.github-privateを作成できます。詳細については、「企業でカスタムエージェントを使用する準備」および「組織でカスタムエージェントを使用する準備」を参照してください。
必要に応じて、エージェントプロファイルを作成するブランチを選択します。既定値はメインブランチです。
[] をクリックし、[エージェントの作成] クリックします。これにより、ターゲットリポジトリの my-agent.agent.md ディレクトリに .github/agents という名前のテンプレートエージェントプロファイルが開きます。
組織レベルまたはエンタープライズレベルのカスタムエージェントを作成する場合は、ファイルパスの .github/ 部分を削除して、テンプレートをルート agents ディレクトリに移動します。
エージェントの目的を識別する一意のわかりやすい名前を選択して、ファイル名 ( .agent.md前のテキスト) を編集します。ファイル名には、 .、 -、 _、 a-z、 A-Z、 0-9の文字のみが含まれていることに注意してください。
名前、説明、ツール、プロンプトなど、エージェントプロファイルを構成します。エージェントプロファイルに含めることができる内容の詳細については、「エージェントプロファイルの構成」を参照してください。
ファイルをリポジトリにコミットし、既定のブランチにマージします。 [エージェント] タブにGo backし、必要に応じてページを更新します。プロンプトボックスでをクリックすると、ドロップダウンにあなたのカスタムエージェントが表示されます。

          Visual Studio Code

でカスタムエージェントプロファイルを作成する

       GitHub Copilot チャットでVisual Studio Codeを開きます。

チャットビューの下部にある [エージェント] ドロップダウンで、[カスタムエージェントの構成...] をクリックし、[新しいカスタムエージェント作成] をクリックします。
```
       エージェント プロファイルを作成する場所を選択します。
```
* ワークスペース: ワークスペースのカスタムエージェントフォルダーに.github/agents プロファイルを作成し、そのワークスペース内でのみ使用します。 * ユーザープロファイル: 現在のユーザープロファイルフォルダーにカスタムエージェントプロファイルを作成して、すべてのワークスペースで使用します。

       カスタム エージェントのファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。

新しく作成したエージェントプロファイルファイルの.agent.md (説明、ツール、プロンプトなど) を構成します。エージェントプロファイルに含めることができる内容の詳細については、「エージェントプロファイルの構成」を参照してください。
- エディター内の [ツールの構成]... ボタンを使用すると、[ツールの構成] ダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 [ OK] を クリックして、選択したツールをエージェントプロファイルに追加します。
- エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリートドロップダウンから任意のモデルを選択します。
```
     エージェント プロファイルを更新するには、[エージェント] ドロップダウンから [**カスタム エージェントの構成**] を選択し、一覧からエージェントをクリックして変更します。 
     カスタム エージェントのVS Codeの詳細については、カスタム・エージェント[のVS Codeを](https://code.visualstudio.com/docs/copilot/customization/custom-agents)参照してください。
```

JetBrains IDE でのカスタムエージェントプロファイルの作成

JetBrains IDE で GitHub Copilot チャットウィンドウを開きます。
チャットビューの下部にある [エージェント] ドロップダウンから[エージェントの 構成...] をクリックし、設定ウィンドウの [チャットエージェント] で [ ワークスペース] をクリックします。

       カスタム エージェントのファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。

新しく作成した.agent.mdファイル内の.github/agentsディレクトリでエージェントプロファイルを構成し、説明、ツール、プロンプトを含めます。エージェントプロファイルに含めることができる内容の詳細については、「エージェントプロファイルの構成」を参照してください。
- エディター内の [ツールの構成]... ボタンを使用してツールダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 [ 適用 ] をクリックして、選択したツールをエージェントプロファイルに追加します。
- エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリートドロップダウンから任意のモデルを選択します。
```
     エージェント プロファイルを更新するには、[エージェント] ドロップダウンから [**カスタム エージェントの構成**] を選択し、変更するエージェントの横にある [<svg version="1.1" width="16" height="16" viewBox="0 0 16 16" class="octicon octicon-pencil" aria-label="The pencil icon" role="img"><path d="M11.013 1.427a1.75 1.75 0 0 1 2.474 0l1.086 1.086a1.75 1.75 0 0 1 0 2.474l-8.61 8.61c-.21.21-.47.364-.756.445l-3.251.93a.75.75 0 0 1-.927-.928l.929-3.25c.081-.286.235-.547.445-.758l8.61-8.61Zm.176 4.823L9.75 4.81l-6.286 6.287a.253.253 0 0 0-.064.108l-.558 1.953 1.953-.558a.253.253 0 0 0 .108-.064Zm1.238-3.763a.25.25 0 0 0-.354 0L10.811 3.75l1.439 1.44 1.263-1.263a.25.25 0 0 0 0-.354Z"></path></svg>] をクリックします。
```

Eclipse でのカスタムエージェントプロファイルの作成

Eclipse で GitHub Copilot チャットウィンドウを開きます。
チャットビューの下部にある [エージェント] ドロップダウンで、[エージェントの 構成]、[ 追加]、[ ...] の順にクリックします。

       カスタム エージェントのファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。

指定された.github/agentsディレクトリの新しく作成した.agent.mdファイルにあるエージェントプロファイルを構成し、説明やツール、プロンプトを含めます。エージェントプロファイルに含めることができる内容の詳細については、「エージェントプロファイルの構成」を参照してください。
- エディター内の [ツールの構成]... ボタンを使用すると、[ツールの構成] ダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 [ 適用 ] をクリックして、選択したツールをエージェントプロファイルに追加します。
- エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリートドロップダウンから任意のモデルを選択します。
```
     エージェント プロファイルを更新するには、エージェントのドロップダウンから [**エージェントの構成...**] を選択し、変更するエージェントを選択して [**編集**] をクリックします。
```

Xcode でのカスタムエージェントプロファイルの作成

Xcode で GitHub Copilot チャットウィンドウを開きます。
チャットビューの下部にある [エージェント] ドロップダウンから、[エージェントの作成] クリックします。

       カスタム エージェントのファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。

新しく作成した.agent.md ファイルに、説明、ツール、プロンプトを含むエージェントプロファイルを.github/agentsディレクトリで構成します。エージェントプロファイルに含めることができる内容の詳細については、「エージェントプロファイルの構成」を参照してください。
- ファイルエディター内の [エージェントのカスタマイズ] ボタンを使用してダイアログを開き、エージェントで使用する AI モデルを選択したり、使用可能なツール (組み込みツールや MCP サーバーツールを含む) を選択したり、handoffs間を切り替えるためにカスタムエージェントプロパティを構成したりできます。選択したオプションを**** に追加するには、[エージェントプロファイル] をクリックします。
```
     エージェント プロファイルを更新するには、エージェントのドロップダウンから、変更するエージェントの横にある鉛筆アイコンをクリックします。
```

          エージェント プロファイル の設定を行う

          エージェント プロファイルは、カスタム エージェントの名前、説明、使用可能なツール、MCP サーバー構成を指定する YAML frontmatter を含む Markdown ファイルです。 
          エージェント プロファイルの構成には、エージェントの ID、機能、ツール アクセス、および動作命令を定義する必要があります。

YAML プロパティ、ツール、MCP サーバーのセットアップ、ツールエイリアス、およびカスタムエージェントの処理方法の詳細については、カスタムエージェントの構成を参照してください。

          エージェント プロファイルを構成するには:

オプションで、name用のカスタムエージェントを記述します。設定を解除すると、名前は既定でファイル名に設定されます ( .md または .agent.md サフィックスは付けなくなります)。
エージェントの機能と、その特定の機能またはドメインの専門知識を説明する簡単な description (必須) を記述します。

       `tools` プロパティで、エージェントで使用できるツールを定義します。 これは、リポジトリ設定または エージェント プロファイル ( `tools: ["read", "edit", "search", "some-mcp-server/tool-1"]` など) で構成された MCP サーバーのツールを含む、ツール名またはエイリアスの一覧です。 このプロパティを省略すると、エージェントは使用可能なすべてのツールにaccessされます。 
       [AUTOTITLE](/copilot/reference/custom-agents-configuration#tools) の「ツール」を参照してください。

必要に応じて、 mcp-servers プロパティで、このエージェントのみが使用できる MCP サーバーを構成して、その機能を拡張できます。カスタムエージェントの構成の「MCP サーバー構成の詳細」を参照してください。

       エージェント プロファイル、JetBrains IDE、Eclipse、または Xcode でVS Codeを作成して使用する場合は、`model` プロパティを使用して、エージェントが使用する AI モデルを制御することもできます。

必要に応じて、特定の環境でのみエージェントを使用する場合は、target プロパティを vscode または github-copilot に設定します。このプロパティを省略すると、エージェントは両方の環境で使用できます。
エージェントのプロンプトを書いてください。 YAML frontmatter の下にある Markdown コンテンツで、エージェントの動作、専門知識、および手順を定義します。プロンプトの最大文字数は 30,000 文字です。

          エージェント プロファイル の例

次の例は、エージェントプロファイルが、テストの記述やプロジェクトの計画に関連する一般的なタスクにおいてどのように見えるかを示しています。その他のヒントについては、カスタマイズライブラリのカスタム・エージェントの例を参照してください。さらに具体的な例については、 awesome-copilot コミュニティコレクションを参照してください。

テストスペシャリスト

この例では、 tools プロパティを省略して、すべてのツールを有効にします。

Text

---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

---
name: test-specialist
description: Focuses on test coverage, quality, and testing best practices without modifying production code
---

You are a testing specialist focused on improving code quality through comprehensive testing. Your responsibilities:

- Analyze existing tests and identify coverage gaps
- Write unit tests, integration tests, and end-to-end tests following best practices
- Review test quality and suggest improvements for maintainability
- Ensure tests are isolated, deterministic, and well-documented
- Focus only on test files and avoid modifying production code unless specifically requested

Always include clear test descriptions and use appropriate testing patterns for the language and framework.

実装プランナー

この例では、ツールのサブセットのみを有効にします。

Text

---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.

---
name: implementation-planner
description: Creates detailed implementation plans and technical specifications in markdown format
tools: ["read", "search", "edit"]
---

You are a technical planning specialist focused on creating comprehensive implementation plans. Your responsibilities:

- Analyze requirements and break them down into actionable tasks
- Create detailed technical specifications and architecture documentation
- Generate implementation plans with clear steps, dependencies, and timelines
- Document API designs, data models, and system interactions
- Create markdown files with structured plans that development teams can follow

Always structure your plans with clear headings, task breakdowns, and acceptance criteria. Include considerations for testing, deployment, and potential risks. Focus on creating thorough documentation rather than implementing code.

          カスタム エージェント の使用

          カスタム エージェントを作成したら、Copilot クラウド エージェントが使用可能な場所であればどこでも使用できます。

* Copilot クラウドエージェントのタスクでGitHub.comを求めるメッセージが表示されたら、[エージェント] パネルまたは [エージェント] タブのドロップダウンメニューを使用して、既定のカスタムエージェントではなくクラウドエージェントを選択します。

問題に Copilot クラウドエージェントを割り当てるときは、ドロップダウンメニューからカスタムエージェントを選択して、特殊な構成に関する問題を処理できます。

        GitHub Copilot CLI（コマンドラインインターフェース）を使用する場合は、カスタム エージェントスラッシュ コマンドを使用するか、プロンプトでエージェントを参照するか、コマンド ライン引数を使用して、特定の`/agent`を使用するかを選択できます。 詳しくは、「[AUTOTITLE](/copilot/how-tos/use-copilot-agents/use-copilot-cli#use-custom-agents)」をご覧ください。

        Copilotがプル要求を開くと、pull request の説明で作業を完了するために使用されたカスタム エージェントが表示されます。

        Copilot クラウド エージェント の使用について詳しくは、「[AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr)」をご覧ください。

IDE でのカスタムエージェントの使用

          エージェント プロファイル、JetBrains IDE、Eclipse、Xcode など、サポートされている IDE でカスタム Visual Studio Codeを直接使用することもできます。 チャット ウィンドウのエージェント ドロップダウンを使用して カスタム エージェント を切り替えることができます。これにより、計画、コード編集、調査などのさまざまなタスクの特殊な構成にアクセスできます。

一部のプロパティは、 GitHub.com 環境と IDE 環境で機能が異なる場合や無視される場合があることに注意してください。サポートされるプロパティの詳細については、 AUTOTITLE を参照してください。

          カスタム エージェントおよびVS Codeに関する詳細については、VS Codeドキュメント内のVS Codeにある[カスタム・エージェント](https://code.visualstudio.com/docs/copilot/customization/custom-agents)を参照してください。

次のステップ

最初のカスタムエージェントを作成するための実践的なチュートリアルについては、最初のカスタムエージェントを参照してください。
詳細な構成情報については、 AUTOTITLE を参照してください。

        カスタム エージェントを含むクラウド エージェントを使用してプル要求を作成する方法については、[AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-a-pr) を参照してください。

Copilot クラウドエージェント用のカスタムエージェントの作成

この機能を使用できるユーザーについて

この記事で

リポジトリにカスタムエージェントプロファイルを作成する GitHub

JetBrains IDE でのカスタムエージェントプロファイルの作成

Eclipse でのカスタムエージェントプロファイルの作成

Xcode でのカスタムエージェントプロファイルの作成

テストスペシャリスト

実装プランナー

IDE でのカスタムエージェントの使用

次のステップ

Copilot クラウド エージェント用のカスタム エージェントの作成

この機能を使用できるユーザーについて

この記事で

Copilot クラウドエージェント用のカスタムエージェントの作成