# カスタム エージェントについて

カスタム・エージェント お客様のニーズに合わせた支援で Copilot を強化します。

## カスタム エージェント の概要

カスタム・エージェント は、独自のワークフロー、コーディング規則、ユース ケースに合わせて調整できる、 Copilot エージェントの特殊なバージョンです。 彼らは、あなたの標準に従い、適切なツールを使用し、チーム固有のプラクティスを実装する調整されたチームメイトのように動作します。 これらのエージェントは、同じ命令とコンテキストを繰り返し提供するのではなく、1 回定義します。

カスタム エージェントと呼ばれる Markdown ファイルを使用して、エージェント プロファイルを定義します。 これらのファイルは、プロンプト、ツール、および MCP サーバーを指定します。 これにより、規則、フレームワーク、および必要な結果を Copilotに直接エンコードできます。

エージェント プロファイルは、カスタム エージェントの動作を定義します。 タスクまたは問題にエージェントを割り当てると、 カスタム エージェントがインスタンス化されます。

自分で定義する カスタム エージェント に加えて、 Copilot には事前構築済みの カスタム エージェントのセットが含まれています。
[組み込みエージェントを](#built-in-agents)参照してください。

## エージェント プロファイル 形式

エージェント プロファイル は、YAML frontmatter を含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。

* **名前** (省略可能): カスタム エージェントの表示名。 省略すると、エージェントのファイル名が識別子と既定の表示名として使用されます。
* **説明**: エージェントの目的と機能について説明します。
* **プロンプト**: エージェントの動作と専門知識を定義するカスタム命令。
* **ツール** (省略可能): エージェントがアクセスできる特定のツール。 既定では、エージェントは、組み込みのツールや MCP サーバー ツールなど、使用可能なすべてのツールにアクセスできます。

エージェント プロファイル では、 `mcp-servers` プロパティを使用して MCP サーバー構成を含めることもできます。

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

この例は、名前、説明、プロンプトが構成された基本的な エージェント プロファイル です。

```text
---
name: readme-creator
description: Agent specializing in creating and improving README files
---

You are a documentation specialist focused on README files. Your scope is limited to README files or other related documentation files only - do not modify or analyze code files.

Focus on the following instructions:
- Create and update README.md files with clear project descriptions
- Structure README sections logically: overview, installation, usage, contributing
- Write scannable content with proper headings and formatting
- Add appropriate badges, links, and navigation elements
- Use relative links (e.g., `docs/CONTRIBUTING.md`) instead of absolute URLs for files within the repository
- Make links descriptive and add alt text to images
```

## 設定を行う場所 カスタム エージェント

エージェント プロファイルは、さまざまなレベルで定義できます。

* **リポジトリ レベル**: プロジェクト固有のエージェントの `.github/agents/CUSTOM-AGENT-NAME.md` をリポジトリに作成します。
* **組織レベル**: 組織の`/agents/CUSTOM-AGENT-NAME.md`または`.github`リポジトリに`.github-private`を作成して、組織内のより広範な可用性を実現します。
* **エンタープライズ レベル**: エンタープライズ所有者がエンタープライズ設定で指定した組織の`/agents/CUSTOM-AGENT-NAME.md` リポジトリに`.github-private`を作成し、エンタープライズ内のすべてのリポジトリで可用性を確保します。

詳細については、「[組織でカスタム エージェントを使用する準備](/ja/copilot/how-tos/administer-copilot/manage-for-organization/prepare-for-custom-agents)」および「[企業でカスタム エージェントを使用する準備](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents)」を参照してください。

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

プロンプトの送信時に要求を処理するメイン Copilot エージェントに加えて、 Copilot CLI (コパイロット CLI) には、メイン エージェントが一般的な開発タスクを支援するためにサブエージェントとして実行できる次の組み込みエージェントが含まれています。 これらのエージェントは、効率と精度のために最適化されており、基になる言語モデルとツールの機能を利用して、それぞれのドメインで高品質の支援を提供します。

Copilot では、プロンプトと現在のコンテキストに基づいて、適切な組み込みエージェントが自動的に使用されます。 たとえば、プロンプト `How does authentication work in this codebase?` は通常 Explore エージェントをトリガーし、 `/research` スラッシュ コマンドを使用すると Research エージェントがトリガーされます。

* **explore** — 高速で軽量なコードベース探索エージェント。 コード インテリジェンス、grep、glob、ビュー、シェル ツールを使用してファイルを検索し、コード構造を理解します。 ファイルは変更されないため、メイン Copilot エージェントによって実行されている他のサブエージェントと並行して呼び出すことができます。 GitHub MCP サーバー ツールへの読み取り専用アクセス権があります。

* **task** — 開発コマンド (テスト、ビルド、リンター、フォーマッタ、依存関係のインストール) を実行し、結果を効率的にレポートするコマンド実行エージェント。 成功に関する簡単な概要と、失敗した場合の完全な出力が返され、メイン コンテキストがクリーンな状態が維持されます。 親エージェントが使用できるすべてのツール (サブエージェント コンテキストで適切でないツールを除く) にアクセスでき、同じアクセス許可が付与または拒否されます。

* **general-purpose** — このエージェントには、基本的にメイン Copilot エージェントと同じ機能がすべて含まれます。 メイン エージェントは、独立したコンテキスト ウィンドウを必要とするタスクを支援したり、必要に応じて並列で実行したりするために、汎用エージェントをサブエージェントとして実行できます。

* **code-review** — 非常に高い信号対ノイズ比でコードの変更をレビューします。 このエージェントは、ステージング/ステージングされていない変更とブランチの相違を分析し、バグ、セキュリティの脆弱性、競合状態、メモリ リーク、ロジック エラーなど、本当に重要な問題のみを示します。 スタイルや書式設定にコメントを付けることはありません。 ファイルは変更されません。

* **研究** - このエージェントは、スタッフレベルのソフトウェアエンジニアおよび研究スペシャリストとして動作します。 コードベース、API、ライブラリ、およびソフトウェア アーキテクチャに関する、徹底的に調査された包括的な回答が提供されます。
  GitHub検索/探索ツール、Web フェッチ/検索、ローカル ツールを使用します。 他のエージェントとは異なり、リサーチ エージェントは、 `/research` スラッシュ コマンドを使用してのみ呼び出すことができます。 メイン エージェントによって自動的にトリガーすることはできません。

* **ラバーダック** - 独自の計画、コード、テストについて Copilot に第二の意見を与える建設的な評論家。 セッションを駆動するモデルとは異なるモデルで実行されるため、補完的な視点をもたらします。 これは、ファイル自体を変更しないように、提案された変更を確認するように設計されています。 詳細については、「[ラバーダックエージェントについて](/ja/copilot/concepts/agents/copilot-cli/rubber-duck)」を参照してください。

## エージェントをサブエージェントとして実行する

自分で定義したカスタム エージェント (または組み込みのエージェント) を使用する利点の 1 つは、メイン Copilot エージェントが別のコンテキスト ウィンドウでサブエージェントとして実行できることです。 つまり、カスタム エージェント (組み込みのエージェント) は、メイン エージェントのコンテキスト ウィンドウを乱雑にすることなく、特定のサブタスクに集中できます。

必要に応じて、サブエージェントによって実行されるタスクを並列で実行できるため、タスク全体をより迅速に完了できます。

詳細については、「[GitHub CopilotのCLIカスタマイズ機能の比較](/ja/copilot/concepts/agents/copilot-cli/comparing-cli-features)」を参照してください。

## 次のステップ

独自の カスタム エージェントを作成するには、次を参照してください。

* [GitHub Copilot CLI（コマンドラインインターフェース） のカスタムエージェントの作成と使用](/ja/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)
* [Copilot カスタマイズのチートシート](/ja/copilot/reference/customization-cheat-sheet)