カスタム エージェント について
カスタム エージェント は、 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) または組織レベルまたはエンタープライズ レベル (/agents/CUSTOM-AGENT-NAME.md リポジトリ内の.github-private) で定義して、より広範な可用性を実現できます。 「組織でカスタム エージェントを使用する準備」と「企業でカスタム エージェントを使用する準備」を参照してください。
カスタム エージェントを使用できる場所
メモ
カスタム エージェント は、JetBrains IDE、Eclipse、Xcode 用 パブリック プレビュー にあり、変更される可能性があります。
作成すると、カスタム エージェント は、Copilot コーディング エージェント を使用できるすべての場所で利用可能です。これは、GitHub.com(エージェント タブとパネル、発行割り当て、pull requests)、GitHub Copilot CLI(コマンドラインインターフェース)、Visual Studio Code、JetBrains IDEs、Eclipse、Xcode などが含まれます。
エージェント プロファイル はVisual Studio Code、JetBrains IDE、Eclipse、Xcode で直接使用できますが、一部のプロパティは環境間で機能が異なる場合や無視される場合があります。
Visual Studio Code での カスタム エージェント の使用に関する詳細は、VS Code ドキュメント中のVS Code における カスタム エージェントを参照してください。
次のステップ
独自の カスタム エージェント を作成するには、カスタム エージェントの作成 をご参照ください。