> ## 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** | 理解需求、拆解任务、协调调度、质量把关 |
| **调研员** | 负责调研分析、代码定位、依赖梳理、环境检查与报告输出 |
| **全栈工程师** | 负责实现和修改前端代码、后端代码，以及处理跨栈或其他通用编码任务 |
| **QA** | 负责运行测试构建流程，收集并整理验证结果与相关证据 |
| **代码审查员** | 负责代码审查、风险识别与检测，并提出改进建议 |
| **UI 操作者** | 负责浏览器与 UI 端到端验证，以及可视化 Bug 复现 |
| **故障诊断工程师** | 负责故障复现、根因定位与缺陷诊断，并给出修复建议 |
Lead Agent 会根据任务需要动态调度不同领域的专家子智能体，在会话流中，你可以看到每个专家智能体执行的状态，点击可查看详情。专家之间互不阻塞、并行执行，Lead Agent 负责实时对齐和整合结果。
## 适用场景
Experts 模式为中大型工程任务而生——当你期望端到端一次性交付高质量结果时，它能发挥最大价值。以下是三类典型场景：
| 场景 | 示例任务 | Experts 如何帮你 |
| ------------- | ------------------------- | -------------------------------------------- |
| **前后端全栈开发** | 开发用户管理模块（注册、登录、信息管理） | Lead Agent 生成方案，全栈工程师实现前后端，QA 同步测试，代码审查员把关质量 |
| **复杂问题定位与修复** | 线上性能瓶颈，涉及多个微服务 | Lead Agent 召集调研员与全栈工程师，协同分析日志、追踪调用链、定位并修复 |
| **技术方案调研** | 评估 GraphQL 替代 RESTful API | 调研员搜集资料，全栈工程师评估技术栈影响，输出可执行调研报告 |
对于简单、明确的文件修改，智能体（Agent 模式）依然是更高效的选择。
## 使用指南
### 1. 切换到 专家团（Experts）模式
在 Quest 输入区域底部的配置栏中，点击模式切换按钮，选择 **专家团（Experts）模式**。
切换后，你只需用自然语言描述需求，Lead Agent 会自动理解目标、制定方案并协调专家团队执行。
### 2. 需求规划
专家团（Experts）模式内置了[生成规划能力](/zh/user-guide/chat/plan-agent)，在执行任务前会先生成实施方案：
1. **描述需求**：清晰说明目标、技术栈偏好、质量要求等
2. **生成计划**：Lead Agent 分析需求并生成结构化的实施计划
3. **审阅调整**：你可以在执行前修改计划，补充遗漏的步骤
4. **确认执行**：计划确认后，专家团队开始并行工作
### 3. 任务列表
在任务执行过程中，聊天面板底部会显示实时任务列表：
* **待开始**：等待执行的任务项
* **进行中**：当前正在执行的任务
* **已完成**：已完成的任务项
点击单个任务，你可以随时，查看每个任务的执行进度、过程和结果
此外，当任务需要用户确认或介入时，通知会展示在对话框上方，方便你及时处理。
Experts 模式下，Lead Agent 将自主调度并执行绝大部分任务，仅极少数情况需要你介入确认：
* 终端命令命中黑名单或被识别为高风险操作
* 工具调用次数达到上限
* 其他需人工强干预的异常情况
### 4. 自定义专家团
Experts 模式支持对专家团进行灵活配置：调整内置专家的行为，或引入自定义子智能体扩展团队阵容。
**内置专家团**
可对系统内置专家进行个性化配置，使其更贴合实际工作场景：
* **模型选择** — 每个内置专家默认跟随用户在 Experts 对话中选择的模型。可为单个专家指定特定模型（如 Qwen3.7-Max、DeepSeek-V4-Pro），精细控制成本与能力的权衡。
* **追加提示词** — 为内置专家添加额外提示词，用来引导或约束特定场景下的行为。最多支持 10,000 字符。
* **Skills 与 MCP** — 为内置专家扩展 Skills 与 MCP 服务器，丰富其能力边界。
Lead Agent 不支持自定义配置。
**自定义**
可创建自定义子智能体，适用于智能体与专家团模式，由主智能体按需自主调用。同时支持模型配置与扩展 Skills 与 MCP 服务器。详见[子智能体文档](/zh/extensions/subagent)。
## 专家团全景图
专家团全景图（Expert Team Canvas）是 Experts 模式下的实时可视化面板，让你在同一个窗口中总览所有专家的任务进度与执行流程。当专家团队并行处理复杂任务时，画布帮助你随时掌握全局——哪些任务已完成、哪些正在执行、每个专家具体在做什么——而无需逐条翻阅对话记录。
### 如何打开
在 Experts 模式的对话界面中，任务执行期间上方会显示任务进展卡片。点击卡片上的专家头像即可打开专家团全景图。
### 界面布局
画布包括任务总览和画布视图：
**任务总览面板**
顶部显示任务统计摘要，包括已完成和进行中的任务数量，帮助你快速了解整体进度。下方列出所有参与的专家及其对应任务，每项标注当前状态（已完成、进行中、待处理）。点击任意专家头像，画布会自动定位到该专家的任务区域。
**画布视图**
以卡片形式平铺展示各专家的任务进度与执行流程，每张卡片对应一位专家的工作内容。卡片内可查看该专家的执行步骤、产出摘要和当前状态，多位专家的工作成果一目了然。
## 最佳实践
### 让 Experts 更懂你的意图
| 技巧 | 说明 |
| ---------- | --------------------- |
| **描述最终目标** | 说清楚你想要什么结果，而不只是要做什么操作 |
| **提供上下文** | 相关的业务背景、现有代码结构、技术约束 |
| **明确质量要求** | 是否需要测试、文档、代码规范检查 |
| **说明优先级** | 哪些是必须的，哪些是可选的 |
### 随时干预，无需中断
在专家团执行过程中，你可以随时介入调整，无需停止当前对话：
* **修正方向**：发现偏离预期？直接说明需要改进的点，Lead Agent 会实时调整
* **补充需求**：有新想法或遗漏？随时补充，专家团队会增量完善
* **变更优先级**：需求变化？告知新的侧重点，团队会重新分配资源
## 常见问题
1. 执行过程中可以修改需求吗？
可以。你可以随时补充信息或调整方向，Lead Agent 会协调专家团队适应变化。
2. 专家团（Experts）模式的成本和耗时如何？
专家团（Experts）模式适合中高复杂度任务。相比单 Agent，耗时会增加，但质量提升显著（内部测试显示质量提升约 67%）。对于简单任务，单 Agent 更高效。
3. 专家模式的终端工具运行机制是？
在专家模式中，终端工具会自动运行 Terminal 命令无需每次手动确认，其中潜在危险命令会自动在沙箱环境中运行。