Copilotコーディングエージェント 用のカスタム エージェントの作成

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

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

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

この記事で

カスタム・エージェント を使用すると、Copilot の専門知識を特定のタスクに合わせてカスタマイズできます。 カスタム エージェントの概念的な概要については、カスタム エージェントについてをご参照ください。

カスタムエージェントのIDEプレビュー

GitHub

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

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

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

    メモ

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

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

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

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

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

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

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

Visual Studio Code

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

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

エージェント プロファイル を更新するには、エージェントのドロップダウンメニューから [Configure Custom Agents (カスタムエージェントの構成)] を選択し、一覧から、変更しようとするエージェントをクリックします。 VS Code 内の カスタム エージェント の詳細については、「VS Code 内の カスタム・エージェント」を参照してください。

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

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

エージェント プロファイル を更新するには、エージェントのドロップダウンから [Configure Custom Agents (カスタムエージェントの構成)] を選択し、変更しようとするエージェントの横にある をクリックします。

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

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

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

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

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

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

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

エージェント プロファイル は、YAML frontmatter が付属している Markdown ファイルです。この frontmatter は、カスタム エージェント の名前、説明、使用可能なツール、MCP サーバー構成を指定します。 エージェント プロファイル の構成には、エージェントの ID、機能、ツール アクセス、および動作に関する指示を定義することが関係します。

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

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

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

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

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

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

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

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

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

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

また、Visual Studio Code、JetBrains IDE、Eclipse、Xcode など、サポートされている IDE の中で、カスタム エージェント プロファイル を直接使用することもできます。 チャット ウィンドウ内にあるエージェントのドロップダウンを使用し、複数の カスタム エージェント 間で切り替えを行うことができます。その結果、計画策定、コード編集、調査などのさまざまなタスクに適した特化型構成にアクセスできます。

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

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

次のステップ