> ## 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.
# Experts モード
Experts モードは、Qoder が複雑な開発タスク向けに提供するマルチエージェント協調機能です。ユーザーは要件を提示するだけで、システムが自動的にタスクを分解し、専門家チームを編成して、設計、実装、テスト、品質保証を並行して実行し、本番環境で使用可能なエンジニアリング成果物を提供します。
**一言で言うと**：あなたが要件を提示し、AI エキスパートチームが成果物を提供します。
## コアワークフロー
リクエストを開始すると、**Lead Agent** がタスク全体の「司令塔」として機能します。目標を理解し、タスクを分解し、全体を調整し、品質を管理し、必要に応じて異なる分野の専門家を動的に招集して並行して協力させます：
| 役割 | 職責 |
| ----------------------- | ----------------------------------------------------- |
| **Lead Agent** | 要件を理解、タスクを分解、調整・スケジューリング、品質管理 |
| **Researcher** | 調査分析、コード位置特定、依存関係の整理、環境チェック、レポート出力を担当 |
| **Full-Stack Engineer** | フロントエンド/バックエンドコードの実装と修正、クロススタックやその他の汎用コーディングタスクの処理を担当 |
| **QA** | テストとビルドの実行、検証結果とエビデンスの収集・整理を担当 |
| **Code Reviewer** | コードレビュー、リスクの特定と検出を行い、改善提案を提示 |
| **UI Operator** | ブラウザと UI のエンドツーエンド検証、可視化 Bug の再現を担当 |
| **Debug Engineer** | 障害の再現、根本原因の特定、欠陥の診断を担当し、修正提案を提供 |
Lead Agent は、タスクのニーズに応じて異なる分野の専門家サブエージェントを動的にスケジュールします。会話フローでは、各専門家エージェントの実行ステータスを確認でき、クリックすると詳細が表示されます。専門家同士はブロックせず並行実行し、Lead Agent がリアルタイムで調整し結果を統合します。
## 適用シナリオ
Experts モードは中〜大規模のエンジニアリングタスク向けに設計されています。エンドツーエンドで高品質な結果を期待する場合、最大の価値を発揮します。以下は3つの典型的なシナリオです：
| シナリオ | タスク例 | Experts がどう支援するか |
| --------------- | --------------------------------- | ------------------------------------------------------------------------------ |
| **フルスタック開発** | ユーザー管理モジュール開発（登録、ログイン、情報管理） | Lead Agent が計画を生成、Full-Stack Engineer が前後端を実装、QA が並行してテスト、Code Reviewer が品質を確保 |
| **複雑な問題の診断と修正** | 複数のマイクロサービスに関わる本番環境のパフォーマンスボトルネック | Lead Agent が Researcher と Full-Stack Engineer を招集し、ログ分析、コールチェーンの追跡、問題の特定と修正を実施 |
| **技術ソリューション調査** | GraphQL による RESTful API 置換の評価 | Researcher が資料を収集、Full-Stack Engineer が技術スタックへの影響を評価、実行可能な調査レポートを提供 |
シンプルで明確なファイル修正の場合、Agent モードの方が効率的です。
## 利用ガイド
### 1. Experts モードに切り替える
Quest 入力エリア下部の設定バーで、モード切り替えボタンをクリックし、**Experts モード**を選択します。
切り替え後、自然言語で要件を説明するだけで、Lead Agent が自動的に目標を理解し、計画を作成し、専門家チームを調整して実行します。
### 2. 要件計画
Experts モードには[計画生成機能](/ja/user-guide/chat/plan-agent)が組み込まれており、タスク実行前に実装計画を生成します：
1. **要件を説明**：目標、技術スタックの好み、品質要件などを明確に記述
2. **計画を生成**：Lead Agent が要件を分析し、構造化された実装計画を生成
3. **レビューと調整**：実行前に計画を修正し、不足しているステップを追加可能
4. **実行を確認**：計画確認後、専門家チームが並行作業を開始
### 3. タスクリスト
タスク実行中、チャットパネル下部にリアルタイムのタスクリストが表示されます：
* **保留中**：実行待ちのタスク
* **進行中**：現在実行中のタスク
* **完了**：完了したタスク
個々のタスクをクリックすると、いつでも実行進捗、プロセス、結果を確認できます。
また、タスクがユーザーの確認や介入を必要とする場合、通知がダイアログの上部に表示され、迅速に対応できます。
Experts モードでは、Lead Agent がほとんどのタスクを自主的にスケジュール・実行し、介入が必要なのは極めて稀なケースのみです：
* ターミナルコマンドがブラックリストに一致するか、高リスク操作として識別された場合
* ツール呼び出し回数が上限に達した場合
* その他、手動での強制介入が必要な例外状況
### 4. 専門家チームのカスタマイズ
Experts モードでは、専門家チームを柔軟にカスタマイズできます。組み込み専門家の動作を調整したり、カスタムサブエージェントを追加してチーム編成を拡張できます。
**ビルトインエキスパートチーム**
組み込み専門家をワークフローに合わせて調整できます：
* **モデル選択** — 各組み込み専門家はデフォルトで Experts チャットでのユーザーのモデル選択に従います。個別の専門家に特定のモデル（Qwen3.7-Max、DeepSeek-V4-Pro など）を割り当てることで、コストと能力のトレードオフをきめ細かくコントロールできます。
* **追加プロンプト（Additional Prompt）** — 組み込み専門家に追加のプロンプトを設定し、特定のシナリオでの動作を誘導・制約できます。最大 10,000 文字をサポート。
* **Skills & MCP** — Skills や MCP サーバーを追加し、できることを広げられます。
Lead Agent はカスタマイズ設定に対応していません。
**カスタム**
カスタムサブエージェントを作成でき、エージェントモードと Experts モードの両方で利用可能です。メインエージェントが必要に応じて自律的に呼び出します。モデル設定、Skills、MCP サーバーの拡張もサポートしています。詳細は[サブエージェントドキュメント](/ja/extensions/subagent)を参照。
## エキスパートチームキャンバス
エキスパートチームキャンバス（Expert Team Canvas）は、Expertsモードのリアルタイム可視化パネルで、すべてのエキスパートのタスク進捗と実行ワークフローを一つのウィンドウで概観できます。エキスパートチームが複雑なタスクを並行処理する際、キャンバスを使えば常に全体像を把握できます — どのタスクが完了し、どのタスクが実行中で、各エキスパートが何をしているか — 会話履歴をスクロールする必要はありません。
### 開き方
Expertsモードの会話画面で、タスク実行中に上部にタスク進捗カードが表示されます。カード上のエキスパートアバターをクリックすると、エキスパートチームキャンバスが開きます。
### レイアウト
キャンバスにはタスク概要パネルとキャンバスビューがあります：
**タスク概要パネル**
上部にタスクの統計サマリーが表示され、完了済みと進行中のタスク数を確認できます。下部には参加中のすべてのエキスパートとそのタスクが一覧表示され、各項目に現在のステータス（完了、進行中、保留中）が付記されています。エキスパートのアバターをクリックすると、そのタスクエリアに自動スクロールします。
**キャンバスビュー**
各エキスパートのタスク進捗とワークフローをカード形式で横並びに表示します。各カードは1人のエキスパートの作業内容に対応し、実行ステップ、成果物のサマリー、現在のステータスを確認でき、全体の成果を一目で把握できます。
## ベストプラクティス
### Experts にあなたの意図をより理解させる
| テクニック | 説明 |
| ------------- | -------------------------------- |
| **最終目標を説明** | どのような操作をするかではなく、どのような結果が欲しいかを明確に |
| **コンテキストを提供** | 関連するビジネス背景、既存のコード構造、技術的制約 |
| **品質要件を明確化** | テスト、ドキュメント、コード規格チェックが必要かどうか |
| **優先順位を指示** | 必須項目とオプション項目の区別 |
### いつでも介入、中断なし
専門家チームの実行中、会話を停止することなく、いつでも介入して調整可能：
* **方向を修正**：期待とずれている？改善が必要な点を直接伝えると、Lead Agent がリアルタイムで調整
* **要件を追加**：新しいアイデアや見落としがある？いつでも追加でき、専門家チームが増分的に改善
* **優先順位を変更**：要件が変わった？新しい重点を伝えると、チームがリソースを再配分
## よくある質問
1. 実行中に要件を変更できますか？
はい。いつでも情報を追加したり、方向を調整したりできます。Lead Agent が専門家チームを調整して変更に対応します。
2. Experts モードのコストと所要時間は？
Experts モードは中〜高複雑度のタスクに適しています。単一 Agent に比べて所要時間は増えますが、品質は大幅に向上します（内部テストで約67%の品質向上を確認）。シンプルなタスクでは、単一 Agent の方が効率的です。
3. Experts モードのターミナルツールの動作メカニズムは？
Experts モードでは、ターミナルツールは毎回の手動確認なしに Terminal コマンドを自動的に実行します。潜在的に危険なコマンドは、自動的にサンドボックス環境で実行されます。