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 ) で定義することも、より広範な可用性を実現するために組織またはエンタープライズ レベルで定義することもできます。 「組織でカスタム エージェントを使用する準備」と「企業でカスタム エージェントを使用する準備」を参照してください。

カスタム エージェントを使用できる場所

作成後、カスタム エージェント は、Copilot コーディング エージェント を使用できる場所であればどこでも使用できます。GitHub.com (エージェント タブとパネル、発行割り当て、プル要求)、GitHub Copilot CLI(コマンドラインインターフェース)、Visual Studio Code (チャット モード) を含みます。 各相互作用は、エージェントの定義されたプロファイルに基づいて一貫性を維持し、特定のニーズに合わせてターゲット サポートを確実に調整します。

エージェント プロファイル はチャット モードとして Visual Studio Code で直接使用できますが、2 つの環境によって一部のプロパティが異なる場合があります。 チャット モードの詳細については、「VS Code でのチャット モードの使用」を参照してください。

次のステップ

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