Hermes Agent 核心必学：SubAgent 子代理的 5 个实战技巧，多任务处理效率翻倍

Hermes Agent SubAgent 子代理使用教程

一个大型项目同时遇到代码 bug、文档错误和性能瓶颈，难道要逐一排队处理？如果能把不同任务同时交给多个 “AI 助手” 并行处理就好了。SubAgent（子代理）就是 Hermes Agent 为此提供的核心能力——通过 delegate_task 工具可将复杂、并行或隔离的任务委派给独立子代理执行，实现 上下文隔离、并行处理、主会话轻量化，大幅提升多任务处理效率与复杂问题解决能力。本文从核心原理、基础用法、并行任务、高级配置、实战场景到最佳实践，带你全面掌握 SubAgent 委派用法。

一、SubAgent 核心原理

1.1 什么是 SubAgent 委派

SubAgent 是独立隔离的轻量级 Agent 实例，通过 delegate_task 工具由主代理（父代理）创建，拥有独立上下文、终端会话与受限工具集，任务完成后仅将最终摘要返回给主代理，不污染主会话历史。

1.2 核心价值

• ✅ 上下文完全隔离：子代理无父代理会话历史，避免上下文膨胀与干扰。

• ✅ 并行任务处理：默认支持 3 个子代理并发，大幅提升多任务效率。

• ✅ 轻量化主会话：仅返回关键结果，减少主会话 Token 消耗。

• ✅ 模型成本优化：子代理可指定廉价模型，降低复杂任务推理成本。

• ✅ 风险隔离：子代理独立执行，错误 / 异常不影响主代理。

1.3 关键特性

• 无记忆继承：子代理完全 “空白”，仅继承父代理的 API 密钥与凭证配置。

• 工具集受限：可自定义子代理可用工具，禁止递归委派、内存修改等高风险操作。

• 深度限制：默认仅支持 1 级委派（父→子），防止无限递归。

• 中断传播：主代理中断时，所有活跃子代理同步终止。

图1：SubAgent 委派架构图

#mermaid-svg-NsyUusyetgxKJFmQ{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-NsyUusyetgxKJFmQ .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-NsyUusyetgxKJFmQ .error-icon{fill:#552222;}#mermaid-svg-NsyUusyetgxKJFmQ .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-NsyUusyetgxKJFmQ .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-NsyUusyetgxKJFmQ .marker{fill:#333333;stroke:#333333;}#mermaid-svg-NsyUusyetgxKJFmQ .marker.cross{stroke:#333333;}#mermaid-svg-NsyUusyetgxKJFmQ svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-NsyUusyetgxKJFmQ p{margin:0;}#mermaid-svg-NsyUusyetgxKJFmQ .label{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;color:#333;}#mermaid-svg-NsyUusyetgxKJFmQ .cluster-label text{fill:#333;}#mermaid-svg-NsyUusyetgxKJFmQ .cluster-label span{color:#333;}#mermaid-svg-NsyUusyetgxKJFmQ .cluster-label span p{background-color:transparent;}#mermaid-svg-NsyUusyetgxKJFmQ .label text,#mermaid-svg-NsyUusyetgxKJFmQ span{fill:#333;color:#333;}#mermaid-svg-NsyUusyetgxKJFmQ .node rect,#mermaid-svg-NsyUusyetgxKJFmQ .node circle,#mermaid-svg-NsyUusyetgxKJFmQ .node ellipse,#mermaid-svg-NsyUusyetgxKJFmQ .node polygon,#mermaid-svg-NsyUusyetgxKJFmQ .node path{fill:#ECECFF;stroke:#9370DB;stroke-width:1px;}#mermaid-svg-NsyUusyetgxKJFmQ .rough-node .label text,#mermaid-svg-NsyUusyetgxKJFmQ .node .label text,#mermaid-svg-NsyUusyetgxKJFmQ .image-shape .label,#mermaid-svg-NsyUusyetgxKJFmQ .icon-shape .label{text-anchor:middle;}#mermaid-svg-NsyUusyetgxKJFmQ .node .katex path{fill:#000;stroke:#000;stroke-width:1px;}#mermaid-svg-NsyUusyetgxKJFmQ .rough-node .label,#mermaid-svg-NsyUusyetgxKJFmQ .node .label,#mermaid-svg-NsyUusyetgxKJFmQ .image-shape .label,#mermaid-svg-NsyUusyetgxKJFmQ .icon-shape .label{text-align:center;}#mermaid-svg-NsyUusyetgxKJFmQ .node.clickable{cursor:pointer;}#mermaid-svg-NsyUusyetgxKJFmQ .root .anchor path{fill:#333333!important;stroke-width:0;stroke:#333333;}#mermaid-svg-NsyUusyetgxKJFmQ .arrowheadPath{fill:#333333;}#mermaid-svg-NsyUusyetgxKJFmQ .edgePath .path{stroke:#333333;stroke-width:2.0px;}#mermaid-svg-NsyUusyetgxKJFmQ .flowchart-link{stroke:#333333;fill:none;}#mermaid-svg-NsyUusyetgxKJFmQ .edgeLabel{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-NsyUusyetgxKJFmQ .edgeLabel p{background-color:rgba(232,232,232, 0.8);}#mermaid-svg-NsyUusyetgxKJFmQ .edgeLabel rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-NsyUusyetgxKJFmQ .labelBkg{background-color:rgba(232, 232, 232, 0.5);}#mermaid-svg-NsyUusyetgxKJFmQ .cluster rect{fill:#ffffde;stroke:#aaaa33;stroke-width:1px;}#mermaid-svg-NsyUusyetgxKJFmQ .cluster text{fill:#333;}#mermaid-svg-NsyUusyetgxKJFmQ .cluster span{color:#333;}#mermaid-svg-NsyUusyetgxKJFmQ div.mermaidTooltip{position:absolute;text-align:center;max-width:200px;padding:2px;font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:12px;background:hsl(80, 100%, 96.2745098039%);border:1px solid #aaaa33;border-radius:2px;pointer-events:none;z-index:100;}#mermaid-svg-NsyUusyetgxKJFmQ .flowchartTitleText{text-anchor:middle;font-size:18px;fill:#333;}#mermaid-svg-NsyUusyetgxKJFmQ rect.text{fill:none;stroke-width:0;}#mermaid-svg-NsyUusyetgxKJFmQ .icon-shape,#mermaid-svg-NsyUusyetgxKJFmQ .image-shape{background-color:rgba(232,232,232, 0.8);text-align:center;}#mermaid-svg-NsyUusyetgxKJFmQ .icon-shape p,#mermaid-svg-NsyUusyetgxKJFmQ .image-shape p{background-color:rgba(232,232,232, 0.8);padding:2px;}#mermaid-svg-NsyUusyetgxKJFmQ .icon-shape .label rect,#mermaid-svg-NsyUusyetgxKJFmQ .image-shape .label rect{opacity:0.5;background-color:rgba(232,232,232, 0.8);fill:rgba(232,232,232, 0.8);}#mermaid-svg-NsyUusyetgxKJFmQ .label-icon{display:inline-block;height:1em;overflow:visible;vertical-align:-0.125em;}#mermaid-svg-NsyUusyetgxKJFmQ .node .label-icon path{fill:currentColor;stroke:revert;stroke-width:revert;}#mermaid-svg-NsyUusyetgxKJFmQ :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}

完全隔离 ｜ 仅返回摘要

delegate_task

delegate_task

delegate_task

最终摘要

最终摘要

最终摘要

主代理 Parent Agent

子代理 1独立上下文 / 工具集

子代理 2独立上下文 / 工具集

子代理 3独立上下文 / 工具集

从架构图可以看出，子代理完全隔离于主代理。下面从最基础的单个任务委派开始，掌握 SubAgent 的核心用法。

二、基础用法：单个任务委派

单个任务委派适用于复杂调试、代码审查、单主题研究等独立任务，子代理串行执行。

2.1 核心语法

delegate_task(
goal="任务目标（清晰具体）",
context="任务上下文（完整背景、约束、依赖）",
toolsets=["可用工具集"]
)

2.2 实操示例：代码调试委派

将测试失败调试任务委派给子代理，隔离执行环境：

delegate_task(
goal="调试 test_foo.py 第42行断言失败问题",
context="项目路径：~/myproject，Python 3.11。错误：assertEqual 预期200实际500，接口/api/health 响应异常",
toolsets=["terminal", "file"]
)

2.3 关键注意：上下文必须完整

子代理无父代理历史，必须传递所有必要信息，避免模糊描述：

• ❌ 错误：goal="修复接口错误"（无上下文，子代理无法执行）

• ✅ 正确：goal="修复/api/health接口500错误" + 完整错误日志/项目信息

单个任务委派解决了独立问题，而当需要同时处理多个不相关的任务时，并行委派能大幅提升效率。

三、高级用法：并行批量委派

并行批量委派支持最多 3 个子代理同时执行，适用于多主题研究、多文件重构、多模块审查等并行场景。

3.1 核心语法

delegate_task(tasks=[
{"goal="任务1", "context="上下文1", "toolsets=["工具集1"]},
{"goal="任务2", "context="上下文2", "toolsets=["工具集2"]},
{"goal="任务3", "context="上下文3", "toolsets=["工具集3"]}
])

3.2 实操示例：并行技术研究

同时委派 3 个子代理，分别研究 WebAssembly、RISC-V、量子计算 2025 进展：

delegate_task(tasks=[
{
"goal": "研究2025年WebAssembly浏览器与非浏览器支持情况",
"context": "重点：主流浏览器兼容性、Node.js/wasmtime运行时、语言支持（Rust/Go）",
"toolsets": ["web"]
},
{
"goal": "研究2025年RISC-V服务器与嵌入式 adoption 现状",
"context": "重点：服务器芯片厂商、嵌入式生态、软件适配（Linux/RTOS）",
"toolsets": ["web"]
},
{
"goal": "研究2025年量子计算纠错与实际应用进展",
"context": "重点：纠错技术突破、金融/材料应用、头部厂商路线",
"toolsets": ["web"]
}
])

3.3 并行任务特性

• 并发限制：默认最大 3 个，可通过 delegation.max_concurrent_children 配置调整。

• 结果排序：按任务输入顺序返回，与完成时间无关。

• 进度实时显示：CLI 树状视图展示各子代理工具调用与完成状态。

图2：并行任务执行时序图

子代理3子代理2子代理1主代理子代理3子代理2子代理1主代理#mermaid-svg-q53doFSmIdqZP2Ao{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;fill:#333;}@keyframes edge-animation-frame{from{stroke-dashoffset:0;}}@keyframes dash{to{stroke-dashoffset:0;}}#mermaid-svg-q53doFSmIdqZP2Ao .edge-animation-slow{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 50s linear infinite;stroke-linecap:round;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-animation-fast{stroke-dasharray:9,5!important;stroke-dashoffset:900;animation:dash 20s linear infinite;stroke-linecap:round;}#mermaid-svg-q53doFSmIdqZP2Ao .error-icon{fill:#552222;}#mermaid-svg-q53doFSmIdqZP2Ao .error-text{fill:#552222;stroke:#552222;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-thickness-normal{stroke-width:1px;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-thickness-thick{stroke-width:3.5px;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-pattern-solid{stroke-dasharray:0;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-thickness-invisible{stroke-width:0;fill:none;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-pattern-dashed{stroke-dasharray:3;}#mermaid-svg-q53doFSmIdqZP2Ao .edge-pattern-dotted{stroke-dasharray:2;}#mermaid-svg-q53doFSmIdqZP2Ao .marker{fill:#333333;stroke:#333333;}#mermaid-svg-q53doFSmIdqZP2Ao .marker.cross{stroke:#333333;}#mermaid-svg-q53doFSmIdqZP2Ao svg{font-family:\”trebuchet ms\”,verdana,arial,sans-serif;font-size:16px;}#mermaid-svg-q53doFSmIdqZP2Ao p{margin:0;}#mermaid-svg-q53doFSmIdqZP2Ao .actor{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-q53doFSmIdqZP2Ao text.actor>tspan{fill:black;stroke:none;}#mermaid-svg-q53doFSmIdqZP2Ao .actor-line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-q53doFSmIdqZP2Ao .innerArc{stroke-width:1.5;stroke-dasharray:none;}#mermaid-svg-q53doFSmIdqZP2Ao .messageLine0{stroke-width:1.5;stroke-dasharray:none;stroke:#333;}#mermaid-svg-q53doFSmIdqZP2Ao .messageLine1{stroke-width:1.5;stroke-dasharray:2,2;stroke:#333;}#mermaid-svg-q53doFSmIdqZP2Ao #arrowhead path{fill:#333;stroke:#333;}#mermaid-svg-q53doFSmIdqZP2Ao .sequenceNumber{fill:white;}#mermaid-svg-q53doFSmIdqZP2Ao #sequencenumber{fill:#333;}#mermaid-svg-q53doFSmIdqZP2Ao #crosshead path{fill:#333;stroke:#333;}#mermaid-svg-q53doFSmIdqZP2Ao .messageText{fill:#333;stroke:none;}#mermaid-svg-q53doFSmIdqZP2Ao .labelBox{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-q53doFSmIdqZP2Ao .labelText,#mermaid-svg-q53doFSmIdqZP2Ao .labelText>tspan{fill:black;stroke:none;}#mermaid-svg-q53doFSmIdqZP2Ao .loopText,#mermaid-svg-q53doFSmIdqZP2Ao .loopText>tspan{fill:black;stroke:none;}#mermaid-svg-q53doFSmIdqZP2Ao .loopLine{stroke-width:2px;stroke-dasharray:2,2;stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);}#mermaid-svg-q53doFSmIdqZP2Ao .note{stroke:#aaaa33;fill:#fff5ad;}#mermaid-svg-q53doFSmIdqZP2Ao .noteText,#mermaid-svg-q53doFSmIdqZP2Ao .noteText>tspan{fill:black;stroke:none;}#mermaid-svg-q53doFSmIdqZP2Ao .activation0{fill:#f4f4f4;stroke:#666;}#mermaid-svg-q53doFSmIdqZP2Ao .activation1{fill:#f4f4f4;stroke:#666;}#mermaid-svg-q53doFSmIdqZP2Ao .activation2{fill:#f4f4f4;stroke:#666;}#mermaid-svg-q53doFSmIdqZP2Ao .actorPopupMenu{position:absolute;}#mermaid-svg-q53doFSmIdqZP2Ao .actorPopupMenuPanel{position:absolute;fill:#ECECFF;box-shadow:0px 8px 16px 0px rgba(0,0,0,0.2);filter:drop-shadow(3px 5px 2px rgb(0 0 0 / 0.4));}#mermaid-svg-q53doFSmIdqZP2Ao .actor-man line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;}#mermaid-svg-q53doFSmIdqZP2Ao .actor-man circle,#mermaid-svg-q53doFSmIdqZP2Ao line{stroke:hsl(259.6261682243, 59.7765363128%, 87.9019607843%);fill:#ECECFF;stroke-width:2px;}#mermaid-svg-q53doFSmIdqZP2Ao :root{–mermaid-font-family:\”trebuchet ms\”,verdana,arial,sans-serif;}par[并行执行]结果按任务输入顺序返回delegate_task(任务1)delegate_task(任务2)delegate_task(任务3)独立研究 WebAssembly独立研究 RISC-V独立研究 量子计算返回摘要返回摘要返回摘要

并行执行让效率倍增，但要想充分发挥 SubAgent 的潜力，还需要按需调整模型、工具集、超时等配置。

四、子代理配置与优化

4.1 自定义子代理模型

为子代理指定廉价 / 轻量模型，降低成本、提升速度：

# ~/.hermes/config.yaml
delegation:
model: "google/gemini-flash-2.0" # 子代理专用模型
provider: "openrouter" # 模型提供商

4.2 工具集精细化控制

子代理默认禁止高风险工具，可按需配置可用工具集：

默认禁止工具：delegation（递归）、memory（内存修改）、send_message（跨平台推送）。

4.3 迭代与超时控制

• 最大迭代：限制子代理工具调用次数（默认 50），避免无限循环：

delegate_task(
goal="快速检查配置文件",
context="查看~/config.yaml语法正确性",
toolsets=["file"],
max_iterations=10 # 限制10轮内完成
)

• 超时时间：默认 600 秒（10 分钟），超时自动终止：

delegation:
child_timeout_seconds: 300 # 5分钟超时

4.4 嵌套委派（高级）

默认子代理不可递归委派，可通过 role="orchestrator" 开启二级委派（最多 3 层）：

delegate_task(
goal="统筹代码审查与修复",
context="管理3个子代理：审查、修复、测试",
toolsets=["terminal", "file"],
role="orchestrator" # 允许二级委派
)

配置优化完成后，将 SubAgent 应用到实际开发中，才能真正体现其价值。

五、实战场景示例

5.1 代码审查 + 修复（串行）

委派子代理审查认证模块并修复安全漏洞：

delegate_task(
goal="审查并修复Flask认证模块安全问题",
context="项目路径：~/webapp，文件：src/auth/login.py/jwt.py。重点：SQL注入、JWT验证、密码处理，修复后执行pytest测试",
toolsets=["terminal", "file"]
)

5.2 多文件重构（串行）

委派子代理批量替换 Python 项目 print 为日志模块：

delegate_task(
goal="重构src目录所有Python文件，替换print为logging",
context="使用logging模块，按日志级别替换，不修改测试文件，重构后执行pytest验证",
toolsets=["terminal", "file"]
)

5.3 系统巡检（并行）

并行委派 3 个子代理，分别检查 CPU、内存、磁盘状态：

delegate_task(tasks=[
{"goal": "检查服务器CPU使用率，超过90%告警", "context": "Linux系统，top命令", "toolsets":["terminal"]},
{"goal": "检查内存占用，超过85%告警", "context": "free -h命令", "toolsets":["terminal"]},
{"goal": "检查磁盘使用率，超过80%告警", "context": "df -h命令", "toolsets":["terminal"]}
])

通过实战可以看到，SubAgent 擅长需要推理的复杂任务，这与单纯的代码执行工具有本质区别。

六、SubAgent 与 execute_code 区别

理解了 SubAgent 与代码执行的定位差异后，最后总结几项最佳实践，帮你用得更加得心应手。

七、最佳实践与注意事项

7.1 最佳实践

7.2 注意事项

八、总结

SubAgent 委派是 Hermes Agent 多任务处理的核心能力，通过上下文隔离、并行执行、成本优化，可高效处理复杂调试、并行研究、批量重构等场景。合理配置模型、工具集与迭代限制，结合完整上下文传递，能最大化发挥子代理价值，大幅提升任务处理效率与主会话轻量化。