---
title: 子智能体
description: "主智能体可按需调用的专业专家智能体"
---

子智能体是一种专业的"专家"，主智能体（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）调用——不允许更深层的嵌套。