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

カスタム・エージェントは、 Copilot エージェントの特殊なバージョンであり、独自のワークフロー、コーディング規則、ユースケースに合わせて調整できます。彼らは、あなたの標準に従い、適切なツールを使用し、チーム固有のプラクティスを実装する調整されたチームメイトのように動作します。これらのエージェントは、同じ命令とコンテキストを繰り返し提供するのではなく、1 回定義します。

カスタムエージェントは、エージェントプロファイルという Markdown ファイルを使用して定義します。これらのファイルは、プロンプト、ツール、および MCP サーバーを指定します。これにより、規則、フレームワーク、および必要な結果を 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 用パブリックプレビューにあり、変更される可能性があります。

カスタムエージェントを作成したら、以下で利用できるようになります。

        **GitHub.com の Copilot コーディングエージェント**: エージェント タブとパネル、問題の割り当て、リクエストのプル

        **IDE の Copilot コーディングエージェント**: Visual Studio Code、JetBrains IDE、Eclipse、Xcode

          **GitHub Copilot CLI（コマンドラインインターフェース）**

エージェントプロファイルを、Visual Studio Code、JetBrains IDE、Eclipse、Xcode の中で直接使用することができます。一部のプロパティは、動作が異なる場合や、環境間で無視される場合があります。

Visual Studio Code の中でカスタムエージェントを使用する方法の詳細については、「カスタム・エージェント in VS Code (VS Code 内のカスタム・エージェント)」を参照してください。

次のステップ

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

        [AUTOTITLE](/copilot/how-tos/use-copilot-agents/coding-agent/create-custom-agents)

        [AUTOTITLE](/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli)

        [AUTOTITLE](/copilot/reference/customization-cheat-sheet)

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

この記事の内容