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 级委派父→子防止无限递归。中断传播主代理中断时所有活跃子代理同步终止。图1SubAgent 委派架构图完全隔离 仅返回摘要delegate_taskdelegate_taskdelegate_task最终摘要最终摘要最终摘要主代理 Parent Agent子代理 1独立上下文 / 工具集子代理 2独立上下文 / 工具集子代理 3独立上下文 / 工具集从架构图可以看出子代理完全隔离于主代理。下面从最基础的单个任务委派开始掌握 SubAgent 的核心用法。二、基础用法单个任务委派单个任务委派适用于复杂调试、代码审查、单主题研究等独立任务子代理串行执行。2.1 核心语法delegate_task( goal任务目标清晰具体, context任务上下文完整背景、约束、依赖, toolsets[可用工具集] )2.2 实操示例代码调试委派将测试失败调试任务委派给子代理隔离执行环境delegate_task( goal调试 test_foo.py 第42行断言失败问题, context项目路径~/myprojectPython 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主代理par[并行执行]结果按任务输入顺序返回delegate_task(任务1)delegate_task(任务2)delegate_task(任务3)独立研究 WebAssembly独立研究 RISC-V独立研究 量子计算返回摘要返回摘要返回摘要并行执行让效率倍增但要想充分发挥 SubAgent 的潜力还需要按需调整模型、工具集、超时等配置。四、子代理配置与优化4.1 自定义子代理模型为子代理指定廉价 / 轻量模型降低成本、提升速度# ~/.hermes/config.yamldelegation:model:google/gemini-flash-2.0# 子代理专用模型provider:openrouter# 模型提供商4.2 工具集精细化控制子代理默认禁止高风险工具可按需配置可用工具集工具集适用场景[terminal, file]代码调试、文件编辑、构建任务[web]研究、文档查询、事实核查[file]只读代码审查、配置分析[terminal]系统运维、进程管理默认禁止工具delegation递归、memory内存修改、send_message跨平台推送。4.3 迭代与超时控制最大迭代限制子代理工具调用次数默认 50避免无限循环delegate_task( goal快速检查配置文件, context查看~/config.yaml语法正确性, toolsets[file], max_iterations10 # 限制10轮内完成 )超时时间默认 600 秒10 分钟超时自动终止delegation:child_timeout_seconds:300# 5分钟超时4.4 嵌套委派高级默认子代理不可递归委派可通过roleorchestrator开启二级委派最多 3 层delegate_task( goal统筹代码审查与修复, context管理3个子代理审查、修复、测试, toolsets[terminal, file], roleorchestrator # 允许二级委派 )配置优化完成后将 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 区别特性SubAgentdelegate_task代码执行execute_code推理能力完整 LLM 推理支持多步决策仅执行脚本无推理上下文独立会话支持复杂背景无会话仅脚本执行并行性最多 3 个并发单个执行适用场景需判断、推理的复杂任务机械式脚本任务成本较高LLM 调用较低仅执行理解了 SubAgent 与代码执行的定位差异后最后总结几项最佳实践帮你用得更加得心应手。七、最佳实践与注意事项7.1 最佳实践上下文完整化传递目标、背景、约束、依赖避免模糊描述。模型分层简单任务用廉价模型复杂任务用高性能模型。工具集最小化仅授予必要工具降低安全风险。并行分组同类任务并行避免跨类型干扰。结果精简子代理返回摘要减少主会话冗余。7.2 注意事项无记忆继承子代理完全空白不继承父代理会话。不可递归默认禁止子代理再委派避免无限循环。中断同步主代理中断时所有子代理终止。结果汇总仅最终摘要返回中间过程不污染主会话。安全隔离子代理独立执行错误不影响主代理。八、总结SubAgent 委派是 Hermes Agent 多任务处理的核心能力通过上下文隔离、并行执行、成本优化可高效处理复杂调试、并行研究、批量重构等场景。合理配置模型、工具集与迭代限制结合完整上下文传递能最大化发挥子代理价值大幅提升任务处理效率与主会话轻量化。
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 级委派父→子防止无限递归。中断传播主代理中断时所有活跃子代理同步终止。图1SubAgent 委派架构图完全隔离 仅返回摘要delegate_taskdelegate_taskdelegate_task最终摘要最终摘要最终摘要主代理 Parent Agent子代理 1独立上下文 / 工具集子代理 2独立上下文 / 工具集子代理 3独立上下文 / 工具集从架构图可以看出子代理完全隔离于主代理。下面从最基础的单个任务委派开始掌握 SubAgent 的核心用法。二、基础用法单个任务委派单个任务委派适用于复杂调试、代码审查、单主题研究等独立任务子代理串行执行。2.1 核心语法delegate_task( goal任务目标清晰具体, context任务上下文完整背景、约束、依赖, toolsets[可用工具集] )2.2 实操示例代码调试委派将测试失败调试任务委派给子代理隔离执行环境delegate_task( goal调试 test_foo.py 第42行断言失败问题, context项目路径~/myprojectPython 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主代理par[并行执行]结果按任务输入顺序返回delegate_task(任务1)delegate_task(任务2)delegate_task(任务3)独立研究 WebAssembly独立研究 RISC-V独立研究 量子计算返回摘要返回摘要返回摘要并行执行让效率倍增但要想充分发挥 SubAgent 的潜力还需要按需调整模型、工具集、超时等配置。四、子代理配置与优化4.1 自定义子代理模型为子代理指定廉价 / 轻量模型降低成本、提升速度# ~/.hermes/config.yamldelegation:model:google/gemini-flash-2.0# 子代理专用模型provider:openrouter# 模型提供商4.2 工具集精细化控制子代理默认禁止高风险工具可按需配置可用工具集工具集适用场景[terminal, file]代码调试、文件编辑、构建任务[web]研究、文档查询、事实核查[file]只读代码审查、配置分析[terminal]系统运维、进程管理默认禁止工具delegation递归、memory内存修改、send_message跨平台推送。4.3 迭代与超时控制最大迭代限制子代理工具调用次数默认 50避免无限循环delegate_task( goal快速检查配置文件, context查看~/config.yaml语法正确性, toolsets[file], max_iterations10 # 限制10轮内完成 )超时时间默认 600 秒10 分钟超时自动终止delegation:child_timeout_seconds:300# 5分钟超时4.4 嵌套委派高级默认子代理不可递归委派可通过roleorchestrator开启二级委派最多 3 层delegate_task( goal统筹代码审查与修复, context管理3个子代理审查、修复、测试, toolsets[terminal, file], roleorchestrator # 允许二级委派 )配置优化完成后将 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 区别特性SubAgentdelegate_task代码执行execute_code推理能力完整 LLM 推理支持多步决策仅执行脚本无推理上下文独立会话支持复杂背景无会话仅脚本执行并行性最多 3 个并发单个执行适用场景需判断、推理的复杂任务机械式脚本任务成本较高LLM 调用较低仅执行理解了 SubAgent 与代码执行的定位差异后最后总结几项最佳实践帮你用得更加得心应手。七、最佳实践与注意事项7.1 最佳实践上下文完整化传递目标、背景、约束、依赖避免模糊描述。模型分层简单任务用廉价模型复杂任务用高性能模型。工具集最小化仅授予必要工具降低安全风险。并行分组同类任务并行避免跨类型干扰。结果精简子代理返回摘要减少主会话冗余。7.2 注意事项无记忆继承子代理完全空白不继承父代理会话。不可递归默认禁止子代理再委派避免无限循环。中断同步主代理中断时所有子代理终止。结果汇总仅最终摘要返回中间过程不污染主会话。安全隔离子代理独立执行错误不影响主代理。八、总结SubAgent 委派是 Hermes Agent 多任务处理的核心能力通过上下文隔离、并行执行、成本优化可高效处理复杂调试、并行研究、批量重构等场景。合理配置模型、工具集与迭代限制结合完整上下文传递能最大化发挥子代理价值大幅提升任务处理效率与主会话轻量化。
