IDE で Copilot cloud agent 用のカスタム エージェントを作成する

Custom agents を使用すると、特定のタスクに合わせて Copilotの専門知識を調整できます。 custom agentsの概念の概要については、「AUTOTITLE」を参照してください。

agent profile の設定を行う

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

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

agent profileを構成するには:

1. オプションで、name用のcustom agentを記述します。 設定を解除すると、名前は既定でファイル名に設定されます ( .md または .agent.md サフィックスは付けなくなります)。
2. エージェントの機能と、その特定の機能またはドメインの専門知識を説明する簡単な description (必須) を記述します。
3. tools プロパティで、エージェントで使用できるツールを定義します。 これは、リポジトリ設定または agent profile ( tools: ["read", "edit", "search", "some-mcp-server/tool-1"] など) で構成された MCP サーバーのツールを含む、ツール名またはエイリアスの一覧です。 このプロパティを省略すると、エージェントは使用可能なすべてのツールにアクセスできます。 カスタム エージェントの構成 の「ツール」を参照してください。
4. 必要に応じて、 mcp-servers プロパティで、このエージェントのみが使用できる MCP サーバーを構成して、その機能を拡張できます。 カスタム エージェントの構成 の「MCP サーバー構成の詳細」を参照してください。
5. agent profile、JetBrains IDE、Eclipse、または Xcode でVS Codeを作成して使用する場合は、model プロパティを使用して、エージェントが使用する AI モデルを制御することもできます。
6. 必要に応じて、特定の環境でのみエージェントを使用する場合は、 target プロパティを vscode または github-copilot に設定します。 このプロパティを省略すると、エージェントは両方の環境で使用できます。
7. エージェントのプロンプトを書いてください。 YAML frontmatter の下にある Markdown コンテンツで、エージェントの動作、専門知識、および手順を定義します。 プロンプトの最大文字数は 30,000 文字です。

agent profiles の例

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

テストスペシャリスト

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

---
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.

実装プランナー

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

---
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.

custom agents の使用

custom agentを作成したら、Copilot cloud agentが使用可能な場所であればどこでも使用できます。

• Copilot cloud agentのタスクでGitHub.comを求めるメッセージが表示されたら、[エージェント] パネルまたは [エージェント] タブのドロップダウン メニューを使用して、既定のcustom agentではなくcloud agentを選択します。
• 問題に Copilot cloud agent を割り当てるときは、ドロップダウン メニューから custom agent を選択して、特殊な構成に関する問題を処理できます。
• GitHub Copilot CLIを使用する場合は、custom agentスラッシュ コマンドを使用するか、プロンプトでエージェントを参照するか、コマンド ライン引数を使用して、特定の/agentを使用するかを選択できます。 詳細については、「GitHub Copilot CLI の使用」を参照してください。

Copilotがプル要求を開くと、pull request の説明で作業を完了するために使用されたcustom agentが表示されます。

Copilot cloud agent の使用について詳しくは、「GitHub Copilot セッションの開始」をご覧ください。

IDE での custom agents の使用

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

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

custom agentsおよびVS Codeに関する詳細については、Custom agentsドキュメント内のVS Codeにあるを参照してください。

次のステップ

• 最初の custom agentを作成するための実践的なチュートリアルについては、 最初のカスタム エージェント を参照してください。
• 詳細な構成情報については、 AUTOTITLE を参照してください。
• custom agentsを含むクラウド エージェントを使用してCopilotセッションを開始する方法については、GitHub Copilot セッションの開始 を参照してください。