カスタム エージェント について
カスタム エージェント は、Copilot コーディング エージェント の専門的なバージョンです。 ワークフロー、コーディング規則、ユース ケースに合わせて調整できます。
カスタム エージェント では、カスタマイズされたチームメイトのように動作するエージェントを設定します。 標準に従い、適切なツールを使用し、チームのプラクティスを適用します。 毎回同じ手順を繰り返す必要はありません。
カスタム エージェント は、 エージェント プロファイル という Markdown ファイルを使用して定義します。 これらのファイルは、プロンプト、ツール、および MCP サーバーを指定します。 これにより、Copilot に基準と期待する結果を直接組み込むことができます。
エージェント プロファイル は、カスタム エージェント の動作を定義します。 エージェントをタスクまたは問題に割り当てると、作業が開始されます。
エージェント プロファイル 形式
エージェント プロファイル は、YAML フロントマターを含む Markdown ファイルです。 基本プロファイルには、次のものが含まれます。
-
**名前**: カスタム エージェント
の一意の識別子 * 説明: エージェントの目的と実行できる操作 * プロンプト: エージェントの動作と専門知識を定義する手順 * ツール (省略可能): エージェントがアクセスできる特定のツール (既定では、エージェントは使用可能なすべてのツールを使用できます)
組織レベルとエンタープライズ レベルでは、エージェント プロファイル に MCP サーバー設定を含めることもできます。 これらを追加するには、 mcp-server プロパティを使用します。
例 エージェント プロファイル
次の例は、名前、説明、プロンプトを含む基本的な エージェント プロファイル を示しています。
---
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**: エージェントのタブとパネル、課題の割り当て、プルリクエスト -
**コマンド ライン**: GitHub Copilot CLI(コマンドラインインターフェース) -
**IDE**: Visual Studio Code、JetBrains IDE、Eclipse、Xcode
エージェント プロファイル をこれらの IDE で直接利用できます。 一部のプロパティは、動作が異なる場合や、環境によっては無視される場合があります。
カスタム エージェント を Visual Studio Code で使用する方法の詳細については、VS Code ドキュメントの カスタム エージェント について を参照してください。
次のステップ
独自の カスタム エージェント を作成するには、カスタム エージェントの作成 をご参照ください。