メインコンテンツへスキップ

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 スキルを提供しています。 使用方法
/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
skills: 
 - {skillName1}
 - {skillName2}
mcpServers:
 - {mcpServerName1}
 - {mcpServerName2}
---

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

レビューチェックリスト:
1. コードの可読性
2. 命名規則
3. エラー処理
4. セキュリティチェック
5. テストカバレッジ
フィールド必須説明
nameはいカスタム エージェントの一意の識別子
descriptionはい機能と専門性の簡単な説明、自動選択に使用
toolsいいえ使用可能なツールのリスト、カンマ区切り
skillsいいえ許可されたスキルのリスト
mcpServersいいえ許可された MCP サーバーのリスト

MCPサーバー

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

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

ツール名説明
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 使用ドキュメントを参照してください。