カスタム エージェント の概要
カスタム・エージェント は、独自のワークフロー、コーディング規則、ユース ケースに合わせて調整できる、 Copilot エージェントの特殊なバージョンです。 彼らは、あなたの標準に従い、適切なツールを使用し、チーム固有のプラクティスを実装する調整されたチームメイトのように動作します。 これらのエージェントは、同じ命令とコンテキストを繰り返し提供するのではなく、1 回定義します。
カスタム エージェントと呼ばれる Markdown ファイルを使用して、エージェント プロファイルを定義します。 これらのファイルは、プロンプト、ツール、および MCP サーバーを指定します。 これにより、規則、フレームワーク、および必要な結果を Copilotに直接エンコードできます。
エージェント プロファイルは、カスタム エージェントの動作を定義します。 タスクまたは問題にエージェントを割り当てると、 カスタム エージェントがインスタンス化されます。
エージェント プロファイル 形式
エージェント プロファイル は、YAML frontmatter を含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。
* 名前 (省略可能): カスタム エージェントの表示名。 省略すると、エージェントのファイル名が識別子と既定の表示名として使用されます。 * 説明: エージェントの目的と機能について説明します。 * プロンプト: エージェントの動作と専門知識を定義するカスタム命令。 * ツール (省略可能): エージェントがアクセスできる特定のツール。 既定では、エージェントは、組み込みのツールや MCP サーバー ツールなど、使用可能なすべてのツールにアクセスできます。
エージェント プロファイル では、 `mcp-servers` プロパティを使用して 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を作成して、より広範な可用性を実現します。
詳細については、「組織でカスタム エージェントを使用する準備」および「企業でカスタム エージェントを使用する準備」を参照してください。
Where you can use カスタム エージェント
メモ
カスタム・エージェント は、JetBrains IDE、Eclipse、Xcode 用 パブリック プレビュー にあり、変更される可能性があります。
Once you create カスタム エージェント, they become available to:
- Copilot cloud agent on GitHub.com: The agents tab and panel, issue assignment, and pull requests
- Copilot cloud agent in IDEs: Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode
- GitHub Copilot CLI
You can use エージェント プロファイル directly in Visual Studio Code, JetBrains IDEs, Eclipse, and Xcode. Some properties may function differently or be ignored between environments.
For more information on using カスタム エージェント in Visual Studio Code, see カスタム・エージェント in VS Code.
Next steps
To create your own カスタム エージェント, see: