# 子智能体 (/zh-CN/docs/verdent-manager/configuration/subagents)

> 主智能体可按需调用的专业专家智能体



子智能体是一种专业的"专家"，主智能体（Worker）可以在任务执行过程中随时调用它。每个子智能体都有自己的专长、专属提示词，甚至可以运行在不同的模型上。在聊天中，只需输入 `@SubagentName`，它就会加入进来提供帮助——就像在群聊中@一位同事一样。

***

## 内置子智能体 [#内置子智能体]

Verdent 开箱即带 6 个子智能体，覆盖软件开发中最常见的需求：

| 名称                      | 默认模型                            | 擅长                                     |
| ----------------------- | ------------------------------- | -------------------------------------- |
| **General**             | 跟随主智能体                          | 通用研究智能体，处理复杂问题、代码搜索和多步骤任务——几乎什么都能帮上忙   |
| **Fast Context**        | Gemini 3 Flash                  | 快速定位代码、收集上下文证据；专长于代码库索引，速度极快           |
| **Verifier**            | Sonnet 4.6                      | 快速代码审查——在你做出修改后，标记它来捕捉明显的问题            |
| **Verdent Helper**      | Haiku 4.5                       | Verdent 使用助手；关于 Verdent 如何工作的任何问题都可以问它 |
| **Multi-Model Planner** | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 使用多个模型（Claude、GPT、Gemini）生成计划并合并它们的输出  |
| **Reviewer**            | Gemini 3.1 Pro；Opus 4.6；GPT-5.4 | 完整代码审查：逻辑错误、边界情况、隐藏风险                  |

<Note>
  有两个子智能体比较特殊：**Multi-Model Planner** 和 **Reviewer** 会并行运行 2–3 个模型。每个模型独立思考，产出各自的输出，然后将结果合并。其他所有子智能体都是单模型。
</Note>

***

## 如何使用子智能体 [#如何使用子智能体]

在任意对话中，输入 `@` 即可打开子智能体选择菜单（支持模糊搜索）。选择你想要的子智能体，它就会接管当前上下文。

**示例：**

* 在编写复杂的认证逻辑后：`@Reviewer please review this` → Reviewer 从安全、逻辑和边界情况等角度进行检查。
* 面对棘手的架构决策：`@Multi-Model Planner` → 多个模型提出方案，你从中选出最佳的。
* 编码完成后，快速运行 `@Verifier` → 比运行完整测试套件做基础验证更快。

***

## 自定义子智能体 [#自定义子智能体]

内置子智能体覆盖了大多数需求，但有时你需要一个为你的项目量身定制的专家。你可以创建自己的子智能体。

### 存储位置 [#存储位置]

自定义子智能体以 Markdown 文件的形式存储在：

```
~/.verdent/subagents/
```

支持最多 5 层子目录用于组织管理。

### 文件格式 [#文件格式]

每个子智能体都是一个带 YAML frontmatter 的 Markdown 文件：

```markdown
---
name: SQL-Expert
description: Specializes in SQL optimization and database design, good at analyzing slow queries and indexing strategies
color: blue
model: claude-sonnet-4-6
---

You are a senior database expert focused on PostgreSQL performance optimization.
When users provide SQL queries, you should:
1. Analyze the query execution plan
2. Identify performance bottlenecks (full table scans, missing indexes, etc.)
3. Provide concrete optimization suggestions and rewritten SQL
...
```

### 关键细节 [#关键细节]

* **名称：** 只能包含字母、数字和连字符（例如 `SQL-Expert`、`MyAgent123`）。不能有空格或非 ASCII 字符。
* **颜色：** 取以下之一 `dark-green`、`light-green`、`red-orange`、`amber`、`cyan`、`blue`、`pink`、`purple`、`verdent`——便于视觉识别。
* **热重载：** 保存 `.md` 文件立即生效——无需重启 Verdent。

***

## 在设置中管理子智能体 [#在设置中管理子智能体]

所有子智能体管理都在 **设置 → Subagents** 中进行。

| 操作          | 说明                                                                  |
| ----------- | ------------------------------------------------------------------- |
| **查看列表**    | 所有子智能体以卡片形式展示。内置的标记为"Built-in"；基于插件的会显示插件名称。                        |
| **启用 / 禁用** | 单独开启或关闭每个子智能体，互不影响。                                                 |
| **新建**      | 点击 **Add Subagent**，填写 Identifier（唯一名称）、Model、Description 和 Prompt。 |
| **编辑**      | 悬停在卡片上即可编辑。内置子智能体只允许修改 Model 和 Description。                         |
| **复制**      | 复制任意自定义子智能体（副本默认禁用，直到你启用它）。                                         |
| **删除**      | 自定义子智能体可被删除（需确认）。内置的无法删除。                                           |

### 模型选择的区别 [#模型选择的区别]

* **Multi-Model Planner** 和 **Reviewer** 支持多模型选择（一次 2–3 个模型）。
* 其他子智能体使用单模型选择。
* **General** 有一个特殊选项：它可以自动跟随主智能体的模型，免去单独维护配置。

***

## 使用场景 [#使用场景]

### 代码审查 [#代码审查]

在实现复杂逻辑后，标记 `@Reviewer`。它会检查正确性、边界情况和潜在的 bug——省去你手动逐行检查的麻烦。

### 多视角架构设计 [#多视角架构设计]

对于重大决策（如是否采用微服务、数据库选型），使用 `@Multi-Model Planner` 从多个顶级模型获取独立方案，降低决策风险。

### 快速验证 [#快速验证]

代码修改后，`@Verifier` 快速检查语法、类型和基础问题——比完整测试套件更快，比不做检查更可靠。

### 自定义领域专家 [#自定义领域专家]

创建为你的项目量身定制的子智能体：

* 熟悉你的 schema 和查询模式的 SQL 优化专家
* 强制执行你的 ESLint 和设计系统规则的前端代码规范守护者
* 将技术内容改写为清晰、易读文字的文档助手

***

## 注意事项 [#注意事项]

* 自定义子智能体必须配置有效的模型才能启用。如果你使用 BYOK，而密钥过期或模型被下线，该子智能体会被自动禁用。
* 内置子智能体的模型可以更改，但默认值都是经过调优的——修改它们可能降低性能。
* **Description 很重要：** 它会被注入到主智能体的上下文中，影响子智能体何时被调用。更好的描述能带来更智能的路由。
* 子智能体之间不能互相调用。它们只能由主智能体（Worker）调用——不允许更深层的嵌套。