カスタム エージェント(Custom Agent)は、特定のタスクを処理するために設計された Qoder の AI Agent です。カスタム エージェントを作成して Qoder の機能を拡張できます。各エージェントは独自のコンテキストウィンドウ、ツール権限、システムプロンプトを持ちます。現在、カスタム エージェントのスケジューリング方法は subagent のアプローチを通じて管理されています。
カスタム エージェントの作成
方法1:create-agent を使用(推奨)
Qoder は、インタラクティブなガイダンスを通じてカスタム エージェントを迅速に作成するための組み込み create-agent スキルを提供しています。
使用方法:
/create-agent <要件を入力、例:コードレビューの専門家>
create-agent は以下のステップをガイドします:
- エージェントの名前と説明を定義
- 必要なツール権限を選択
- システムプロンプトテンプレートを自動生成
- エージェントファイルを正しい場所に保存
初めてカスタム エージェントを作成する場合は、/create-agent を使用して設定ファイルを自動生成することをお勧めします。これにより、正しい形式とすべての必要なフィールドが確保されます。
方法2:手動作成
以下のいずれかの場所に .md ファイルを手動で作成することもできます:
| スコープ | パス | 適用範囲 |
|---|
| ユーザーレベル | ~/.qoder/agents/<agentName>.md | すべてのプロジェクト |
| プロジェクトレベル | ${project}/.qoder/agents/<agentName>.md | 現在のプロジェクトのみ |
ファイルには基本情報を定義する frontmatter ブロックと、システムプロンプトの内容を含める必要があります:
---
name: code-review
description: コードレビューの専門家、コード品質とセキュリティをチェック
tools: Read, Grep, Glob, Bash
---
あなたはコード品質を確保する責任を持つシニアコードレビュアーです。
レビューチェックリスト:
1. コードの可読性
2. 命名規則
3. エラー処理
4. セキュリティチェック
5. テストカバレッジ
| フィールド | 必須 | 説明 |
|---|
name | はい | カスタム エージェントの一意の識別子 |
description | はい | 機能と専門性の簡単な説明、自動選択に使用 |
tools | いいえ | 使用可能なツールのリスト、カンマ区切り |
サポートされているツール
| ツール名 | 説明 |
|---|
Bash | 環境で shell コマンドを実行 |
Edit | 特定のファイルに対して編集を実行 |
Write | ファイルを作成または上書き |
Glob | パターンマッチングでファイルを検索 |
Grep | ファイル内容でパターンを検索 |
Read | ファイルの内容を読み取り |
WebFetch | 指定した URL からコンテンツを取得 |
WebSearch | ドメインフィルタリング付きの Web 検索を実行 |
IDE での使用
カスタム エージェントを呼び出す方法は2つあります:
方法1:自動トリガー
Chat パネルで、自然言語でタスクを説明すると、モデルが意図を自動的に認識し、description に基づいて適切なカスタム エージェントを選択します:
モデルは自動的に code-review エージェントを識別して呼び出します。
方法2:手動トリガー
/agent-name を使用して特定のエージェントを手動でトリガーします:
詳細ドキュメント
自動作成や CLI での使用方法を含むカスタム エージェントの完全ガイドについては、CLI 使用ドキュメントを参照してください。