> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qoder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# カスタム エージェント

カスタム エージェント（Custom Agent）は、特定のタスクを処理するために設計された Qoder の AI Agent です。カスタム エージェントを作成して Qoder の機能を拡張できます。各エージェントは独自のコンテキストウィンドウ、ツール権限、システムプロンプトを持ちます。現在、カスタム エージェントのスケジューリング方法は subagent のアプローチを通じて管理されています。

## カスタム エージェントの作成

### 方法1：create-agent を使用（推奨）

Qoder は、インタラクティブなガイダンスを通じてカスタム エージェントを迅速に作成するための組み込み `create-agent` スキルを提供しています。

**使用方法**：

```bash theme={null}
/create-agent <要件を入力、例：コードレビューの専門家>
```

`create-agent` は以下のステップをガイドします：

* エージェントの名前と説明を定義
* 必要なツール権限を選択
* システムプロンプトテンプレートを自動生成
* エージェントファイルを正しい場所に保存

<Tip>
  初めてカスタム エージェントを作成する場合は、`/create-agent` を使用して設定ファイルを自動生成することをお勧めします。これにより、正しい形式とすべての必要なフィールドが確保されます。
</Tip>

### 方法2：手動作成

以下のいずれかの場所に `.md` ファイルを手動で作成することもできます：

| スコープ      | パス                                        | 適用範囲        |
| --------- | ----------------------------------------- | ----------- |
| ユーザーレベル   | `~/.qoder/agents/<agentName>.md`          | すべてのプロジェクト  |
| プロジェクトレベル | `${project}/.qoder/agents/<agentName>.md` | 現在のプロジェクトのみ |

ファイルには基本情報を定義する frontmatter ブロックと、システムプロンプトの内容を含める必要があります：

```markdown theme={null}
---
name: code-review
description: コードレビューの専門家、コード品質とセキュリティをチェック
tools: Read, Grep, Glob, Bash
model: "[ModelName](modelId)"
skills: 
 - {skillName1}
 - {skillName2}
mcpServers:
 - {mcpServerName1}
 - {mcpServerName2}
---

あなたはコード品質を確保する責任を持つシニアコードレビュアーです。

レビューチェックリスト：
1. コードの可読性
2. 命名規則
3. エラー処理
4. セキュリティチェック
5. テストカバレッジ
```

| フィールド         | 必須  | 説明                            |
| ------------- | --- | ----------------------------- |
| `name`        | はい  | カスタム エージェントの一意の識別子            |
| `description` | はい  | 機能と専門性の簡単な説明、自動選択に使用          |
| `model`       | いいえ | 使用するモデルを指定。未設定の場合、会話のモデル選択に従う |
| `tools`       | いいえ | 使用可能なツールのリスト、カンマ区切り           |
| `skills`      | いいえ | 許可されたスキルのリスト                  |
| `mcpServers`  | いいえ | 許可された MCP サーバーのリスト            |

#### MCPサーバー

カスタムエージェントはMCP（Model Context Protocol）サーバーの設定をサポートしており、エージェントが外部ツールやサービスを呼び出すことができます。エージェント設定に`mcpServers`フィールドを追加してMCPサーバーを関連付け、エージェントの機能を拡張できます。

#### モデル設定

カスタムエージェントは使用するモデルの指定をサポートしています。Quest ビューの **Setting → Agents** ページで対象のエージェントを選択し、**Change Model** をクリックして、各エージェントの役割に最適なモデルを割り当てることができます。

#### サポートされているツール

| ツール名        | 説明                       |
| ----------- | ------------------------ |
| `Bash`      | 環境で shell コマンドを実行        |
| `Edit`      | 特定のファイルに対して編集を実行         |
| `Write`     | ファイルを作成または上書き            |
| `Glob`      | パターンマッチングでファイルを検索        |
| `Grep`      | ファイル内容でパターンを検索           |
| `Read`      | ファイルの内容を読み取り             |
| `WebFetch`  | 指定した URL からコンテンツを取得      |
| `WebSearch` | ドメインフィルタリング付きの Web 検索を実行 |

## IDE での使用

カスタム エージェントを呼び出す方法は2つあります：

### 方法1：自動トリガー

Chat パネルで、自然言語でタスクを説明すると、モデルが意図を自動的に認識し、description に基づいて適切なカスタム エージェントを選択します：

```
このインターフェースの実装をレビューして
```

モデルは自動的に `code-review` エージェントを識別して呼び出します。

### 方法2：手動トリガー

`/agent-name` を使用して特定のエージェントを手動でトリガーします：

```
/code-review
```

## 詳細ドキュメント

自動作成や CLI での使用方法を含むカスタム エージェントの完全ガイドについては、[CLI 使用ドキュメント](/ja/cli/using-cli#subagent)を参照してください。