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

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

## custom agents を使用する

custom agentは、Copilotの特殊なバージョンです。
Custom agents は Copilot 独自のワークフロー、特定のコーディング規則、スペシャリストのユース ケースを処理するのに役立ちます。

Copilot CLI には、一般的なタスクの既定の custom agents グループが含まれています。

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

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

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

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

| タイプ                                                                                                                                                                                                              | 場所                              | Scope      |
| ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------- | ---------- |
| ユーザー レベル custom agent                                                                                                                                                                                            | ローカル `~/.copilot/agents` ディレクトリ | すべてのプロジェクト |
| リポジトリ レベル custom agent                                                                                                                                                                                           |                                 |            |
| `.github/agents` ローカル リポジトリとリモート リポジトリ内のディレクトリ                                                                                                                                                                   | 現在のプロジェクト                       |            |
| 組織レベル custom agent                                                                                                                                                                                               |                                 |            |
| `/agents` 組織の `.github` または `.github-private` リポジトリ内のディレクトリ                                                                                                                                                      | 組織内のすべてのプロジェクト                  |            |
| エンタープライズ レベル custom agent                                                                                                                                                                                        |                                 |            |
| `/agents` エンタープライズ設定で指定された組織の `.github-private` リポジトリ内のディレクトリ。 詳細については、「[企業でカスタム エージェントを使用する準備](/ja/copilot/how-tos/administer-copilot/manage-for-enterprise/manage-agents/prepare-for-custom-agents)」を参照してください。 | エンタープライズ アカウントのすべてのプロジェクト       |            |

名前の競合 (エージェントが同じファイル名を共有する)、ユーザー レベルのエージェントはリポジトリ レベルのエージェントをオーバーライドし、リポジトリ レベルのエージェントは組織レベルのエージェントをオーバーライドし、組織レベルのエージェントはエンタープライズ レベルのエージェントをオーバーライドします。

Custom agents は、次の 3 つの方法で使用できます。

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

  ```shell
  /agent
  ```

* プロンプトで custom agent に直接呼び出す:

  ```shell
  Use the refactoring agent to refactor this code block
  ```

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

* コマンド ライン オプションで使用する custom agent を指定します。 例えば次が挙げられます。

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

詳細については、「[Copilot cloud agent用のカスタム エージェントの作成](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/create-custom-agents)」を参照してください。

## スキルを使用する

命令、スクリプト、リソースを使用して特殊なタスクを実行する Copilot の能力を高めるスキルを作成できます。

詳細については、「[エージェント スキルの追加 GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-skills)」を参照してください。

## MCP サーバーを追加する

Copilot CLI は、既に構成されている GitHub MCP サーバーに付属しています。 この MCP サーバーを使用すると、 GitHub.com上のリソースと対話できます。たとえば、CLI からのプル要求をマージできます。

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

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

   ```shell
   /mcp add
   ```

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

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

構成した MCP サーバーの詳細は、既定では `mcp-config.json` ディレクトリにある `~/.copilot` ファイルに格納されます。 この場所は、`COPILOT_HOME` 環境変数を設定して変更できます。 サーバー定義の JSON の構造については、「[リポジトリの MCP サーバーを構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/configure-mcp-servers#writing-a-json-configuration-for-mcp-servers)」をご覧ください。

Copilot CLIでの MCP サーバーの追加と管理の詳細については、[GitHub Copilot CLI 用の MCP サーバーを追加する](/ja/copilot/how-tos/copilot-cli/customize-copilot/add-mcp-servers) を参照してください。

## 次のステップ

タスクの実行中にエージェントの動作をガイドおよび調整して作業を追跡する方法については、 [ステアリングエージェント GitHub Copilot CLI](/ja/copilot/how-tos/copilot-cli/use-copilot-cli/steer-agents) を参照してください。