复杂任务跑20轮后Agent开始胡说八道——重复已做过的操作、提出已否决的方案。这不是模型变笨了是上下文窗口被污染。本文用Subagent分层架构让父Agent保持清醒子Agent承担脏活实现20轮对话上下文仅2k tokens。小李的噩梦当Agent开始失忆帮我审查src/utils.py的代码质量。小李对Agent说。Agent开始工作 read_file src/utils.py读到500行代码 bash pip install flake8安装检查工具 bash flake8 src/utils.py输出200个警告 read_file src/utils.py又读一遍因为忘了内容 ...20轮后Agent说“根据分析建议安装flake8检查代码…”小李懵了“你不是已经安装并运行过了吗”发生了什么复杂任务的中间过程安装工具的错误尝试、调试输出像垃圾一样堆积。模型开始失忆——忘记自己已经做过的事。核心洞察操作系统的进程隔离思想操作系统怎么处理进程隔离每个进程有独立内存空间一个进程崩溃不影响其他进程。这正是Subagent的灵感来源。Subagent分层模式用户任务父Agent战略层委派: PEP8检查Subagent A独立上下文返回摘要3个警告委派: 复杂度分析Subagent B独立上下文返回摘要复杂度正常汇总摘要生成报告单Agent模式用户任务Agent处理安装flake8运行flake8输出50行安装radon运行radon输出30行上下文爆炸30k tokens模型失忆项目经理与外包团队类比方案A自己全做单Agent模式所有细节都在你脑子里越来越乱最后忘了最初的客户需求是什么方案B委派外包Subagent模式团队A做市场调研给你一份5页摘要团队B做竞品分析给你一份5页摘要团队C做技术评估给你一份5页摘要你基于三份摘要写最终方案关键洞察父Agent保持干净的上下文只关心任务和结果Subagent在隔离环境中折腾中间过程不污染父上下文只返回最终摘要相当于进程的退出码和输出技术实现独立上下文是关键# ❌ 错误继承父Agent的上下文污染sub_messagesparent_messages[new_task]# ✅ 正确全新的独立上下文隔离sub_messages[{role:user,content:prompt}]这就像父Agent是项目经理知道整个项目背景Subagent是临时外包只知道自己要做的那一小块外包搞砸了就换一家不影响项目经理的决策代码实现50行核心逻辑defrun_subagent(prompt:str,max_iterations:int30)-str: 在独立上下文中运行Subagent 关键fresh messages不受父Agent历史影响 # ⭐ 核心创建全新的messages不继承父Agent历史sub_messages[{role:user,content:prompt}]foriinrange(max_iterations):# 安全限制responseclient.messages.create(modelMODEL,systemSUBAGENT_SYSTEM,# 子Agent的System Prompt不同messagessub_messages,toolsBASE_TOOLS,# ⭐ 子Agent只有基础工具不能递归spawnmax_tokens4000)sub_messages.append({role:assistant,content:response.content})# 如果Subagent完成了返回最终答案ifresponse.stop_reason!tool_use:returnextract_final_answer(response)# 执行工具调用resultsexecute_tools(response)sub_messages.append({role:user,content:results})return(stopped after max iterations)# 父Agent使用Subagentdefparent_agent_loop(messages):whileTrue:responsellm.call(messagesmessages,toolsPARENT_TOOLS)forblockinresponse.content:ifblock.typetool_use:ifblock.nametask:# ⭐ 父Agent有委派工具# 在隔离上下文中执行子任务outputrun_subagent(block.input[prompt])results.append({tool_use_id:block.id,content:output})else:# 父Agent自己执行基础工具results.append(execute_tool(block))messages.append({role:user,content:results})关键设计独立上下文sub_messages [{role: user, content: prompt}]工具集裁剪Subagent只有基础工具不能递归spawn防止爆炸摘要驱动Subagent只返回最终摘要不返回完整工具调用历史迭代限制max_iterations防止无限循环运行效果代码审查场景对比无Subagent单Agent模式Round 1-5: 检查PEP8安装flake8运行输出50行警告 Round 6-10: 检查复杂度安装radon运行输出30行分析 Round 11: 模型开始混淆根据PEP8检查我建议安装radon...已经做过了 Round 15: 模型忘记原始文件内容重新读取 Round 20: 上下文已满模型开始胡言乱语有Subagent分层模式Parent: Delegating: PEP8检查 Worker: 完成返回摘要3个警告已修复2个 Parent: Delegating: 复杂度分析 Worker: 完成返回摘要Cyclomatic复杂度平均5.2正常 Parent: Delegating: 安全检查 Worker: 完成返回摘要未发现SQL注入风险 Parent: 综合分析所有摘要生成最终报告差异单Agent20轮后失忆上下文爆炸~30k tokens分层模式父Agent只处理3个摘要综合上下文干净~2k tokens给你的团队3种Subagent设计模式模式1MapReduce分而治之# 分析src/目录下所有Python文件filesglob(src/**/*.py)# 为每个文件启动Subagent并行summaries[]forfileinfiles:summaryrun_subagent(f分析{file}的代码质量)summaries.append(summary)# 父Agent汇总final_reportsynthesize(summaries)模式2流水线工序分解# 代码审查流水线syntax_checkrun_subagent(检查语法错误)style_fixrun_subagent(f基于{syntax_check}修复代码风格)optimizationrun_subagent(f基于{style_fix}优化性能)模式3专家会诊多维度分析security_expertrun_subagent(从安全角度审查代码)performance_expertrun_subagent(从性能角度审查代码)maintainability_expertrun_subagent(从可维护性角度审查代码)# 父Agent综合三位专家意见final_reviewsynthesize(security_expert,performance_expert,maintainability_expert)避坑指南❌ 陷阱1让Subagent继承上下文# 错误把父Agent的messages传给Subagentsub_messagesparent_messages[{role:user,content:prompt}]这会污染Subagent的上下文失去隔离意义。❌ 陷阱2Subagent返回太多细节# 错误返回所有工具调用历史returnjson.dumps(sub_messages)# 太冗长Subagent应该返回结构化摘要父Agent只关心结果。❌ 陷阱3递归spawn# 危险Subagent也有task工具可能无限递归PARENT_TOOLSBASE_TOOLS[task_tool]# 父有taskCHILD_TOOLSBASE_TOOLS[task_tool]# 子也有task错误✅ 最佳实践明确边界在System Prompt中强调角色边界PARENT_SYSTEM你是项目经理。专注于 - 任务分解与委派 - 结果汇总与综合 - 不处理具体实现细节 SUBAGENT_SYSTEM你是技术专家。专注于 - 高效完成分配的任务 - 返回简洁的结构化摘要 - 不描述过程只描述结果 总结分层架构的威力Subagent不是多此一举而是复杂任务管理的必要分层战略层父Agent保持清醒掌控全局战术层Subagent承担脏活隔离污染这就像操作系统的进程隔离——不是多余的复杂性而是可靠性的基石。 互动投票你的场景中哪种任务最适合用SubagentA. 代码审查多维度分析B. 数据 processing大批量文件C. 重构任务多文件协调D. 探索性任务可能失败的尝试思考题你的场景中哪些任务适合委派给Subagent如何设计Subagent的返回格式让父Agent能高效汇总如何防止Subagent滥用递归限制预算控制