---
featureId: custom-agents
title: 独自のカスタム エージェントを構築する
area: GitHub Copilot
thumbnailImage: ../media/custom-agents-thumbnail.png
devComUrl: https://developercommunity.visualstudio.com/t/Custom-modes-for-Copilot-Chat/10950930?q=custom+agents
description: リポジトリまたはユーザー プロファイルの .agent.md ファイルを使用して、チームのワークフローに合わせて調整されたカスタム エージェントを定義します。

---


カスタム エージェントは、チームのワークフローに特化した Copilot エージェントを構築するのに役立ちます。 これらのエージェントは、ワークスペースの認識、コードの理解機能、ツール、選択したモデル、また内部ドキュメント、設計システム、API、データベースなどの外部ナレッジ ソースへの MCP 接続を使用することができます。

カスタム エージェントは、リポジトリまたはユーザー プロファイルの `.agent.md` ファイルとして定義されます。
ワークスペースまたはプロジェクト固有のエージェントは、リポジトリの `.github/agents/` 下に格納されます。 次に例を示します。

```text
your-repo/
└── .github/
    └── agents/
        └── code-reviewer.agent.md
```

ユーザー レベルのエージェントは、既定で `%USERPROFILE%/.github/agents/` に格納されます。 この場所は、**[ツール] > [オプション] > [Copilot Chat] > [カスタム エージェント ユーザー ディレクトリ]** で変更できます。

カスタム エージェントを作成するには、上記のいずれかの場所に `.agent.md` ファイルを直接作成するか、エージェント ピッカーの [**+**] ボタンをクリックして、プロンプトに従います。

![CSharp エキスパート カスタム エージェントを示すエージェント ピッカー](../media/custom-agents.png)

カスタム エージェントを作成すると、エージェント ピッカーに表示され、そこからいつでも利用できます。

注意すべき点:

- ユーザーがモデルを指定しない場合、エージェントはモデル ピッカーで現在選択されているモデルを使用します。
- ツール名は GitHub Copilot プラットフォームによって異なります。Visual Studio で使用できるツールを確認して、エージェントが確実に想定どおり動作するようにしてください。
- [awesome-copilot](https://github.com/github/awesome-copilot) リポジトリには、コミュニティによって提供されているエージェント構成があり、ユーザーがとりかかるために使用できるようになっています。 使用する前に、Visual Studio でツール名を確認してください。