カスタム エージェント について
カスタム エージェント は、 Copilot コーディング エージェント の特殊なバージョンであり、独自のワークフロー、コーディング規則、ユース ケースに合わせて調整できます。 カスタム エージェント では、同じ命令とコンテキストを繰り返し提供する代わりに、調整されたチームメイトのように機能する特殊なエージェントを定義できます。標準に従い、適切なツールを使用し、チーム固有のプラクティスを実装できます。
カスタム エージェント は、プロンプト、ツール、および MCP サーバーを指定する Markdown ファイル (エージェント プロファイル と呼ばれます) を使用して定義されます。 これにより、個人とチームは、規則、フレームワーク、および必要な結果を Copilot に直接エンコードできます。 エージェント プロファイル は、カスタム エージェントの動作を定義する成果物として機能し、エージェントをタスクまたは問題に割り当てると、カスタム エージェント がインスタンス化されます。
エージェント プロファイル 形式
エージェント プロファイル は、YAML フロントマターを含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。
- 名前: カスタム エージェント の一意の識別子
- 説明: エージェントの目的と機能について説明します
- プロンプト: エージェントの動作と専門知識を定義するカスタム命令
- ツール: エージェントがアクセスできる特定のツール。 これは省略可能であり、既定では、組み込みのツールや MCP サーバー ツールなど、使用可能なすべてのツールにアクセスできます。
組織レベルおよびエンタープライズ レベルの エージェント プロファイル には、mcp-server プロパティを使用して、エージェント プロファイル 内に MCP サーバー構成を含めることもできます。
例 エージェント プロファイル
これは、名前、説明、プロンプトが構成された基本的な エージェント プロファイル です。
---
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 ) で定義することも、より広範な可用性を実現するために組織またはエンタープライズ レベルで定義することもできます。 「組織でカスタム エージェントを使用する準備」と「企業でカスタム エージェントを使用する準備」を参照してください。
カスタム エージェントを使用できる場所
作成後、カスタム エージェント は、Copilot コーディング エージェント を使用できる場所であればどこでも使用できます。GitHub.com (エージェント タブとパネル、発行割り当て、プル要求)、GitHub Copilot CLI(コマンドラインインターフェース)、Visual Studio Code (チャット モード) を含みます。 各相互作用は、エージェントの定義されたプロファイルに基づいて一貫性を維持し、特定のニーズに合わせてターゲット サポートを確実に調整します。
エージェント プロファイル はチャット モードとして Visual Studio Code で直接使用できますが、2 つの環境によって一部のプロパティが異なる場合があります。 チャット モードの詳細については、「VS Code でのチャット モードの使用」を参照してください。
次のステップ
独自の カスタム エージェント を作成するには、カスタム エージェントの作成 をご参照ください。