カスタム エージェントの作成

特定の開発タスクに合わせて調整された専門知識を持つ特殊なエージェントを作成できます。

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

Copilot コーディング エージェント は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。 エージェントは、マネージド ユーザー アカウント によって所有されて明示的に無効になっているリポジトリを除き、GitHub に格納されているすべてのリポジトリで使用できます。
Sign up for Copilot

この記事の内容

カスタム エージェント を使用すると、特定のタスクに特化した専門知識を持つ専門エージェントを作成できます。 カスタム エージェントの概念的な概要については、カスタム エージェントについてをご参照ください。

メモ

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

GitHub

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

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

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

    メモ

    組織とエンタープライズの所有者は、.github-private リポジトリに、組織レベルおよびエンタープライズレベルの カスタム エージェント を作成できます。これらはその組織またはエンタープライズ内のすべてのリポジトリで利用可能です。 詳細については、「企業でカスタム エージェントを使用する準備」および「組織でカスタム エージェントを使用する準備」を参照してください。

  3. 必要に応じて、エージェント プロファイル を作成するブランチを選択します。 既定値はメイン ブランチです。

  4. をクリックし、 をクリックしてエージェントを作成します。 これにより、ターゲット リポジトリのmy-agent.agent.md ディレクトリに.github/agentsという名前のテンプレート エージェント プロファイルが開きます。

  5. 組織または企業レベルのカスタム エージェントを作成する場合は、ファイルパスの.github/部分を削除して、テンプレートをルートagentsディレクトリに移動します。

  6. エージェントの目的を識別する一意のわかりやすい名前を選択して、ファイル名 ( .agent.md前のテキスト) を編集します。 ファイル名には、 .、 -、 _、 a-z、 A-Z、 0-9の文字のみが含まれていることに注意してください。

  7. エージェント プロファイル を構成し、名前、説明、ツール、プロンプトを設定します。 エージェント プロファイル に含めることができる内容の詳細については、エージェント プロファイル の構成を参照してください。

  8. ファイルをリポジトリにコミットし、既定のブランチにマージします。 [エージェント] タブに戻り、必要に応じてページを更新します。 カスタム エージェント は、プロンプトボックスの をクリックしたときに、ドロップダウンに表示されます。

Visual Studio Code

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

  1. Visual Studio Code で GitHub Copilot チャット を開きます。
  2. チャット ビューの下部にあるエージェントのドロップダウンから、[ カスタム エージェントの構成].. をクリックし、[ [Create new custom agent](新しいカスタム エージェントの作成) をクリックします。
  3. エージェント プロファイル を作成する場所を選んでください。 * ワークスペース: ワークスペースの .github/agents フォルダーに カスタム エージェント プロファイルを作成し、そのワークスペース内でのみ使用します。 * ユーザー プロファイル: カスタム エージェント プロファイルを現在のユーザー プロファイル フォルダーに作成すると、すべてのワークスペースで利用可能になります。
  4. カスタム エージェント のファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。
  5. 新しく作成した .agent.md ファイルの エージェント プロファイル を構成します (説明、ツール、プロンプトを含む)。 エージェント プロファイル に含めることができる内容の詳細については、エージェント プロファイル の構成を参照してください。
    • エディター内の [ツールの構成]... ボタンを使用すると、[ツールの構成] ダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 [OK] をクリックして、選択したツールを エージェント プロファイル に追加します。
    • エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリート ドロップダウンから任意のモデルを選択します。

エージェント プロファイル を更新するには、カスタムエージェントの設定をエージェントのドロップダウンメニューから選び、変更したいエージェントを一覧からクリックします。 VS Code の カスタム エージェント の詳細については、 VS Code の カスタム エージェント を参照してください。

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

  1. JetBrains IDEでGitHub Copilot チャットウィンドウを開きます。
  2. チャット ビューの下部にある [エージェント] ドロップダウンから[エージェントの 構成...] をクリックし、設定ウィンドウの [チャット エージェント] で [ ワークスペース] をクリックします。
  3. カスタム エージェント のファイル名を入力します。 これは、エージェントのドロップダウンに表示される既定の名前です。
  4. 新しく作成された.agent.md ディレクトリ内の.github/agents ファイルで、説明、ツール、プロンプト、エージェント プロファイル などを構成します。 エージェント プロファイル に含めることができる要素についての詳細は、エージェント プロファイル の設定を参照してください。
    • エディター内の [ツールの構成]... ボタンを使用してツール ダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 適用 をクリックして、選択したツールを エージェント プロファイル に追加します。
    • エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリート ドロップダウンから任意のモデルを選択します。

エージェント プロファイル を更新するには、ドロップダウンメニューから カスタムエージェントを構成 を選択し、変更したいエージェントの横にある をクリックします。

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

  1. Eclipse で GitHub Copilot チャット ウィンドウを開きます。
  2. チャット ビューの下部にある [エージェント] ドロップダウンで、[エージェントの 構成]、[ 追加]、[ ...] の順にクリックします。
  3. ファイル名をカスタム エージェントに入力してください。 これは、エージェントのドロップダウンに表示される既定の名前です。
  4. 新しく作成された.agent.md ファイルで、.github/agents ディレクトリ内のエージェント プロファイル を説明、ツール、プロンプトなどを含めて設定します。 エージェント プロファイル に含めることができる内容の詳細については、エージェント プロファイル の設定を参照してください。
    • エディター内の [ツールの構成]... ボタンを使用すると、[ツールの構成] ダイアログを開き、MCP サーバーの組み込みツールやツールなど、使用可能なツールを表示および選択できます。 [ 適用 ] をクリックして、選択したツールを エージェント プロファイル に追加します。
    • エージェントが使用する AI モデルを設定するには、 model: プロパティを追加し、オートコンプリート ドロップダウンから任意のモデルを選択します。

エージェント プロファイル を更新するには、エージェントのドロップダウンから [ エージェントの構成... ] を選択し、変更するエージェントを選択して [ 編集] をクリックします。

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

  1. Xcode で GitHub Copilot チャット ウィンドウを開きます。
  2. チャット ビューの下部にあるエージェントのドロップダウンから、 エージェントを作成します。
  3. カスタム エージェント のファイル名を入力してください。 これは、エージェントのドロップダウンに表示される既定の名前です。
  4. 新しく作成された.github/agents ディレクトリ内の.agent.md ファイルで、エージェント プロファイル を、説明、ツール、プロンプトを含めて設定します。 エージェント プロファイル に含めることができる内容の詳細については、エージェント プロファイル の構成設定を参照してください。
    • ファイル エディター内の [ エージェントのカスタマイズ ] ボタンを使用してダイアログを開き、そこでエージェントが使用する AI モデルを選択したり、使用可能なツール (組み込みツールや MCP サーバー ツールを含む) を選択したり、カスタム エージェント間を切り替えるために handoffs プロパティを構成したりできます。 [ 適用 ] をクリックして、選択したオプションを エージェント プロファイル に追加します。

エージェント プロファイル を更新するには、エージェントのドロップダウンメニューから、変更したいエージェントの横にある鉛筆アイコンをクリックします。

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

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

YAML プロパティ、ツール、MCP サーバーのセットアップ、ツール エイリアス、そして カスタム エージェント がどのように処理されるかに関する詳細な構成情報については、カスタム エージェントの構成 を参照してください。

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

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

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

次の例は、エージェント プロファイル が、テストの記述やプロジェクトの計画に関連する一般的なタスクにおいてどのように見えるかを示しています。 その他のヒントについては、カスタマイズ ライブラリの カスタム エージェント の例を参照してください。 さらに具体的な例については、 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.

実装プランナー

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

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.

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

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

  • GitHub.com でタスクを Copilot コーディング エージェント に提示する際には、エージェント パネルまたはエージェント タブのドロップダウン メニューから、既定のコーディング エージェントではなく カスタム エージェント を選択してください。
  • Copilot コーディング エージェント を問題に割り当てる際、ドロップダウンメニューからあなたの カスタム エージェント を選択し、特別な構成で問題を対処できます。
  • GitHub Copilot CLI（コマンドラインインターフェース） を使用する場合は、 /agent スラッシュ コマンドを使用するか、プロンプトでエージェントを参照するか、コマンド ライン引数を使用して、特定の カスタム エージェント を使用するかを選択できます。 詳しくは、「GitHub Copilot CLI の使用」をご覧ください。

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

Copilot コーディング エージェント の使用方法の詳細については、GitHub Copilot に pull request の作成を依頼する を参照してください。

カスタム エージェント を IDE で使用する方法

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

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

VS Code における カスタム エージェント の詳細については、VS Code ドキュメント内の カスタム エージェント を参照してください。

次のステップ