カスタム エージェントの呼び出し

Copilot CLI のカスタム エージェント、スキル、および MCP サーバーを使用して、その機能を拡張します。

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

GitHub Copilot CLI（コマンドラインインターフェース） はすべての Copilot プランで利用可能です。 Copilot を organization から受け取る場合は、organization の設定で Copilot CLI ポリシーを有効にする必要があります。

この記事で

カスタム エージェント を使用する

カスタム エージェント は、Copilot の専門領域に特化したバージョンです。 カスタム・エージェント は、 Copilot が固有のワークフロー、特定のコーディング規則、および専門家のユース ケースを処理するのに役立ちます。

Copilot CLIには、一般的なタスク用のデフォルトグループとしてカスタム エージェントが含まれています。

エージェント 説明
探検する 簡単なコードベース分析を実行し、メイン コンテキストに追加せずにコードに関する質問をすることができます。
Task テストやビルドなどのコマンドを実行し、成功に関する簡単な概要と失敗時の完全な出力を提供します。
汎用 完全なツールセットと高品質の推論を必要とする複雑な複数ステップのタスクを処理し、メインの会話を明確に集中させるために別のコンテキストで実行します。
コードレビュー 本物の問題のみを表示し、ノイズを最小限に抑えることに焦点を当てて変更をレビューします。

CLI が使用する AI モデルは、特定の専門知識を持つ カスタム エージェント を使用して動作するサブエージェント プロセスにタスクを委任することを選択できます (作業がより効果的に完了すると判断した場合)。 モデルは、メイン エージェントで作業を直接処理することを同じように選択できます。

独自の カスタム エージェント は、エージェント プロファイル と呼ばれる Markdown ファイルを使用して定義できます。このファイルでは、エージェントに必要な専門知識、使用できるツール、応答方法に関する具体的な指示を指定できます。

カスタム エージェント は、ユーザー、リポジトリ、または組織/エンタープライズ レベルで定義できます。

タイプ場所Scope
ユーザーレベル カスタム エージェントローカル ~/.copilot/agents ディレクトリすべてのプロジェクト
リポジトリレベル カスタム エージェント
          `.github/agents` ローカル リポジトリとリモート リポジトリ内のディレクトリ | 現在のプロジェクト |

| 組織レベルおよびエンタープライズレベル カスタム エージェント | /agents 組織または企業の .github-private リポジトリ内のディレクトリ | 組織とエンタープライズ アカウントのすべてのプロジェクト |

名前の競合の場合、システム レベルのエージェントはリポジトリ レベルのエージェントをオーバーライドし、リポジトリ レベルのエージェントは組織レベルのエージェントをオーバーライドします。

カスタム・エージェント は、次の 3 つの方法で使用できます。

  • CLI の対話型インターフェイスでスラッシュ コマンドを使用して、使用可能な カスタム エージェント の一覧から選択します。

    /agent

  • プロンプト内でカスタム エージェントを直接呼び出す。

    Use the refactoring agent to refactor this code block

    Copilot は、使用するエージェントを自動的に判断します。

  • コマンドライン オプションで使用する カスタム エージェント を指定します。 例えば次が挙げられます。

    copilot --agent=refactor-agent --prompt "Refactor this code block"

詳しくは、「Copilotコーディングエージェント 用のカスタム エージェントの作成」をご覧ください。

スキルを使用する

Copilot の能力を向上させ、命令、スクリプト、リソースを用いて専門的なタスクを実行できるようにするスキルを作成できます。

詳しくは、「GitHub Copilot CLI（コマンドラインインターフェース）のエージェントスキルの作成」をご覧ください。

MCP サーバーを追加する

Copilot CLI には、既に構成されている GitHub MCP サーバーが付属しています。 この MCP サーバーを使って GitHub.com 上のリソースを操作でき、たとえば CLI から pull request をマージできます。

Copilot CLI で使用できる機能を拡張するには、MCP サーバーをさらに追加できます。

  1. 次のスラッシュ コマンドを使います。

    /mcp add

  2.        <kbd>Tab</kbd> キーを使ってフィールド間を移動し、追加する MCP サーバーの詳細を入力します。

  3.        <kbd>Ctrl</kbd>+<kbd>S</kbd> キーを押して、詳細を保存します。

構成した MCP サーバーの詳細は、既定では mcp-config.json ディレクトリにある ~/.copilot ファイルに格納されます。 この場所は、COPILOT_HOME 環境変数を設定して変更できます。 サーバー定義の JSON の構造については、「モデル コンテキスト プロトコル (MCP) を使用したGitHub Copilotコーディング エージェントの拡張」をご覧ください。

Copilot CLI での MCP サーバーの追加と管理の詳細については、 GitHub Copilot CLI（コマンドラインインターフェース） 用の MCP サーバーを追加する を参照してください。

次のステップ

タスクの実行中にエージェントの動作をガイドおよび調整して作業を追跡する方法については、 GitHub Copilot CLI（コマンドラインインターフェース） のステアリング エージェント を参照してください。