# カスタム エージェント

Copilotカスタマイズされた指示とツールを備えた、再利用可能な専門家ロールを作成します。

Custom agents は、特定のタスクとワークフローに合わせて調整した Copilot エージェントの特殊なバージョンです。 その専門知識が必要なたびに、指示とツールの要件を繰り返す代わりに、ロールを 1 回定義します。

たとえば、あなたの文章作成基準に従うドキュメント スペシャリストや、ファイルの読み取りと検索を行うことができるが編集ツールは必要ない校閲者を作成できます。

## エージェント プロファイルについて

エージェント プロファイルは、YAML frontmatter を含む Markdown ファイルです。 エージェントの目的を説明し、指示を提供し、使用可能なツールを制限することもあります。 サポートされている環境では、プロファイルでそのエージェント用の MCP サーバーを構成することもできます。

特定のアプローチとツールセットを備えた再利用可能なロールが必要なときは、カスタム エージェントを使用します。 タスク固有の命令とリソースのみが必要な場合は、スキルの方がよりシンプルな選択肢になる場合があります。 比較については、「[Copilotカスタマイズ機能の比較](/ja/copilot/concepts/customizations/comparing-customizations)」を参照してください。

プロファイルは、リポジトリ、組織、およびエンタープライズ レベルで共有できます。
Copilot CLI も個人プロファイルをサポートしています。 構成ファイルの場所、サポートされているプロパティ、および優先順位は、環境によって異なります。 「[カスタム エージェントの構成](/ja/copilot/reference/custom-agents-configuration)」を参照してください。

## カスタム エージェントを使用できる場所

カスタム エージェントは次で使用できます:

* **The GitHub Copilot app**。

* **GitHub Copilot CLI**.

* Copilot cloud agent

* Visual Studio Code（Visual Studio、JetBrains IDE製品群、\*\*\*\*、Eclipse、Xcode など）

JetBrains IDE製品群内のカスタム エージェントと Xcode は、パブリック プレビュー内にあります。 IDE固有のバージョン サポートとリリース状況については、[Copilot機能マトリックス](/ja/copilot/reference/copilot-feature-matrix)を参照してください。

IDE では、チャットでカスタム エージェントを直接使用することは、タスクを Copilot cloud agentに委任することとは異なります。 プロファイルのプロパティの動作が異なる場合や、環境間で無視される場合があります。
VS Code プロファイルの動作については、「[VS Code の「カスタム エージェント」](https://code.visualstudio.com/docs/copilot/customization/custom-agents)」を参照してください。

## 組み込みエージェント

すべてのスペシャリスト タスクに対してカスタム エージェントを定義する必要はありません。
Copilot CLI には、メイン エージェントが一般的な作業に使用できる組み込みのエージェントが含まれています。

* `explore` はコードベース探索用です
* `task` コマンド実行用
* `general-purpose` 別のエージェント コンテキストが必要な作業向け
* `code-review` 変更を確認する
* `research` 研究用
* `rubber-duck` セカンドオピニオン
* `security-review` セキュリティ重視のレビュー向け

これらは、あなた自身のプロファイルとして作成されるのではなく、Copilot CLIによって提供されます。 使用可能なツールと動作はエージェントによって異なります。 機能とモデルの既定値については、[組み込みエージェント](/ja/copilot/reference/copilot-cli-reference/cli-command-reference#built-in-agents)を参照してください。

## カスタム エージェントとサブエージェント

カスタム エージェントは**スペシャリストの定義**です。 サブエージェントは、別のコンテキスト ウィンドウで **委任された作業を行うエージェント** です。 メイン エージェントは、組み込みのエージェントに委任することも、カスタム エージェント プロファイルを使用して専門エージェントを実行することもできます。

個別のコンテキストを使用すると、サブエージェントは、メインの会話に中間の詳細をすべて追加することなく、割り当てられたタスクに集中できます。 独立したタスクを並列で実行することもできます。 これらは委任の利点であり、カスタム プロファイルを作成する必要があるプロパティではありません。

セッション用にカスタム エージェントを選択し、サブタスクをそのエージェントに委任することは、プロファイルを使用するさまざまな方法です。
Copilot CLIでは、セッション エージェントのリポジトリ命令は含まれますが、既定ではカスタム サブエージェントには含まれません。 オプトイン設定と呼び出しメソッドについては、 [GitHub Copilot CLI のカスタムエージェントの作成と使用](/ja/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli) を参照してください。

GitHub Copilot appおよびCopilot CLIの広範な委任モデルについては、[エージェントを使った作業の委任と並列化](/ja/copilot/concepts/agent-capabilities/choosing-and-delegating-agent-work/delegating-and-parallelizing-work-with-agents) を参照してください。

## 次のステップ

勤務先のセットアップ ガイドを選択します。

* [Copilot cloud agent用のカスタム エージェントの作成](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)
* [IDE でのカスタム エージェントの使用](/ja/copilot/how-tos/copilot-in-your-ide/use-copilot-agents/use-custom-agents)
* [GitHub Copilot アプリのカスタマイズ](/ja/copilot/how-tos/github-copilot-app/customize-github-copilot-app)