子智能体
子智能体是主 Agent 可以在独立上下文中启动的专用 Agent，完成后会把结果汇总回主对话。ZCode 内置了 general-purpose（通用型） 和 Explore 子智能体，现在你还可以在设置中创建自己的 用户级子智能体。
当主 Agent 判断任务需要独立上下文或并行调研时，会通过 Agent 工具启动子智能体。子智能体在自己的上下文中工作，并把结果汇总回主对话，帮助主 Agent 继续推进任务。
内置：通用型子智能体
general-purpose 是默认的通用型子智能体，拥有完整工具权限，适合在独立上下文中处理需要读取、修改、运行命令或综合推进的任务。主 Agent 可以在需要把一段工作拆出去并行推进时调用它。
适合交给 general-purpose 的任务包括：
- 独立实现一个小功能或修复一个明确问题。
- 在另一个上下文里整理文件、运行验证命令，并回传结果。
- 把可并行的文档、代码或配置任务拆开处理。
如果任务只需要只读调研、证据收集或调用链梳理，优先使用下面的 Explore。
内置：Explore
Explore 是一个只读的文件搜索和代码库调研专家，适合处理大范围检索、调用链梳理、代码结构理解和证据收集这类探索任务。
Explore 子智能体只用于只读探索，不会创建、修改、移动或删除文件。它主要使用读取和搜索相关工具，例如读取文件、按文件名匹配、按正则搜索内容，以及在需要时读取已知 URL 或搜索外部信息。
适合交给 Explore 的任务包括：
- 查找某个能力在哪些文件中实现。
- 梳理模块入口、调用链和关键依赖。
- 在改动前先调研相关代码和风险点。
- 并行搜索多个目录、命名方式或实现路径。
你可以直接在提示词里要求先做探索，例如：
请先用 Explore 调研这个模块的调用链，再总结修改入口和风险点。
请用只读方式搜索这个功能的实现位置，列出相关文件和证据。
自定义子智能体（Beta）
Beta — 用户级自定义子智能体正在灰度上线，能力范围后续可能调整。
现在你可以在 设置 -> 子智能体 中创建自己的子智能体。自定义子智能体可以把一个可复用的角色——例如代码审查员、测试编写者、文档调研员——连同它的模型、工具权限和指令一起打包，在不同任务中重复使用。
在子智能体面板里，你可以：
- 查看 可用的子智能体，包括内置的
general-purpose（默认角色，可用全部工具）和Explore（只读搜索）。 - 新建 子智能体，填写名称、颜色、模型、描述、可用工具和系统提示词。
- 对你创建的子智能体进行 编辑、删除、启用 或 停用（内置角色仅展示，不能编辑或删除）。
新建子智能体
点击右上角的 新建，在表单中配置这个可复用角色：
| 字段 | 说明 |
|---|---|
| 名称 | 子智能体的标识，例如 code-reviewer。 |
| 颜色标记 | 在列表和会话中区分该子智能体身份的颜色，仅作标识，不表达状态。 |
| 模型 | 可选「继承默认」（跟随主 Agent 当前模型），或指定一个具体模型。 |
| 描述 | 展示给主 Agent 的简短说明。主 Agent 依据它判断何时调用该子智能体——描述越准确，越容易在合适的任务中被自动选用。 |
| 可用工具 | 控制该子智能体能调用的工具范围。「默认所有权限」继承全部工具；「自定义可用工具」则逐个勾选（例如只给 Read / Grep / Glob 做只读审查，Bash / Edit / Write 等可写工具会有标记提示）。 |
| 系统提示词 | 描述该子智能体的角色、边界和规则，也就是它运行时的 system prompt。 |
保存后，ZCode 会把子智能体写入 ~/.zcode/agents/<name>.md 这个 Markdown 文件，ZCode Agent 运行时会在下次运行时加载它。启用后，你可以让 Agent 自动选用该子智能体，也可以在聊天输入框中用 @ 引用它。
范围与限制
- 仅限用户级。 当前 Beta 管理的是 全局 / 用户级 子智能体，存放在
~/.zcode/agents/。暂不支持在设置中创建或编辑 工作区 / 项目级 子智能体。 - 内置角色只读。
general-purpose和Explore仅作展示，不能编辑或删除，名称也不能被复用。 - 前台执行。 子智能体在前台运行——同时启动多个时会并行执行，主任务会等它们全部完成后再继续。后台执行尚未开放。