Skip to main content

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

カスタム エージェント は、 Copilot コーディング エージェント を、ニーズに合わせて調整された特殊な支援で強化します。

この機能を使用できるユーザーについて

Copilot コーディング エージェント は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。 エージェントは、マネージド ユーザー アカウント によって所有されて明示的に無効になっているリポジトリを除き、GitHub に格納されているすべてのリポジトリで使用できます。
Sign up for Copilot

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

カスタム エージェント は、 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 における カスタム エージェントを参照してください。

次のステップ

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