当前位置: 首页 > article >正文

子代理拆分任务:为什么要用上下文隔离保护 Agent 的思路清晰

子代理拆分任务为什么要用上下文隔离保护 Agent 的思路清晰很多人第一次看到子代理注意力会先落在“一个 Agent 还能再叫出另一个 Agent”这件事上。这个现象当然有意思但如果只停在这里很容易错过s04真正想解决的问题。真正的问题是:主 Agent 一旦做长任务上下文会越来越臃肿思路也会越来越容易被中间过程带偏。读几个文件、跑几次命令、试几轮编辑这些动作本身没问题。问题在于它们都会变成对话历史的一部分。时间一长主 Agent 不但要记住任务目标还要背着一大堆探索痕迹继续往前走负担会越来越重。agents/s04_subagent.py给出的办法很直接:把容易产生大量中间过程的子任务拆到一个全新的上下文里去做主 Agent 只接收最后的结果摘要。这就是这篇文章想讲清楚的重点。链接 s04_subagent.py先说结论s04最值得学的不是多了一个task工具而是下面这句话:上下文隔离不是为了炫技而是为了保护模型的思路清晰度。如果说s03解决的是“任务一复杂怎么别丢计划”那s04更像是在解决:当某个子任务会制造很多噪音时怎么别让这些噪音继续污染主线思考为什么主 Agent 越做越容易乱只要 Agent 开始持续调用工具这种问题几乎一定会出现。第一探索过程天然很啰嗦。找测试框架这件事最后答案可能只是“项目在用pytest”。但模型为了得出这个结论可能会读README.md、扫目录、打开多个py文件、再跑一条 shell 命令。真正有价值的结论只有一句中间痕迹却可能有十几段。第二主 Agent 不一定需要知道全部细节。如果一个子任务只是“帮我摸清情况”那主 Agent 往往只需要拿到结论再决定下一步怎么做。把全部中间过程塞回主上下文很多时候是在增加负担而不是增加能力。第三长上下文会让模型越来越像“边翻聊天记录边工作”。上下文越长模型越容易被最近的工具结果吸住注意力。它不是突然不会做了而是更难始终抓住主线。所以s04的核心思路不是“多开一个助手”而是把探索过程和主线决策拆开。task真正带来的不只是一个新工具表面上看父 Agent 比前一个版本多了一个task工具:PARENT_TOOLSCHILD_TOOLS[{name:task,description:Spawn a subagent with fresh context. It shares the filesystem but not conversation history.,input_schema:{type:object,properties:{prompt:{type:string},description:{type:string}},required:[prompt]}},]但这一行背后其实同时发生了三件事:父 Agent 多了一个“委派子任务”的动作。子 Agent 拿到的是全新消息上下文不继承父 Agent 的对话历史。子 Agent 干完活后只把摘要带回父 Agent而不是把整段工作记录原样带回。也就是说task的价值不在“能不能调用”而在它重新定义了信息流。整体结构图先看整体关系会比较容易抓住重点:直接调用基础工具task prompt读文件 / 改文件 / 跑命令返回结果摘要最终回答用户请求父 Agent 主循环共享工作区子 Agent 循环这张图里最关键的地方有两个。父 Agent 和子 Agent 共享同一个工作区所以它们看到的是同一批文件。父 Agent 和子 Agent 不共享消息历史所以子任务内部的探索过程不会回流到主上下文。这也是s04最有意思的地方:共享外部环境隔离内部思路。哪些东西共享哪些东西隔离很多人会把“子代理”想成一个完全独立的新系统其实这里更准确的理解是: 它像是给任务临时开了一个干净的工作脑区。项目父 Agent子 Agent含义会话历史保留完整主线从一条任务提示开始子任务不会继承主对话包袱工作目录共享共享两边都能读写同一批文件工具集合基础工具 task只有基础工具防止无限套娃返回内容继续主线决策输出摘要只把压缩后的结果带回去这一点非常像团队协作中的分工方式:主负责人保留整体目标和当前进度被委派的人拿到一个清晰任务自行探索最后回来汇报结论而不是把所有过程录音都交上来子 Agent 是怎么“新开一个脑子”的run_subagent()这段实现非常关键因为它把“上下文隔离”这件事写得很直白:defrun_subagent(prompt:str)-str:sub_messages[{role:user,content:prompt}]for_inrange(30):responseclient.messages.create(modelMODEL,systemSUBAGENT_SYSTEM,messagessub_messages,toolsCHILD_TOOLS,max_tokens8000,)这里最重要的不是for _ in range(30)这个循环而是这一句:sub_messages[{role:user,content:prompt}]它的意思很明确:子 Agent 没有继承父 Agent 的聊天记录子 Agent 只拿到一条任务说明子 Agent 从自己的局部上下文开始思考和调用工具这就是“上下文隔离”的真实落点。它不是抽象口号而是直接把消息历史重置为一条新任务。它不是并发更像是同步委派s04还有一个很容易被忽略的点: 这里的子代理并不是并发运行的它本质上还是主程序里的一次同步调用。关键逻辑就在这里:ifblock.nametask:outputrun_subagent(block.input[prompt])也就是说父 Agent 一旦决定委派就会立刻进入run_subagent()。子 Agent 在自己的循环里把事情做完返回摘要之后父 Agent 再继续。所以这个例子强调的重点不是“并行提速”而是“隔离思路”。这也是为什么我觉得它特别值得学: 它提醒我们子代理首先是一种上下文管理手段其次才是协作手段。一次委派到底是怎么流转的把这段流程画成时序图会更容易看懂:共享工作区子 AgentPython Harness父 Agent用户共享工作区子 AgentPython Harness父 Agent用户loop[子 Agent 内部循环]提出任务task(prompt...)新建 sub_messages读文件 / 跑命令 / 改文件工具结果返回总结文本tool_result(summary)继续主线回答从这个时序里可以看出父 Agent 眼里看到的其实只有两件事:我发起了一次task我收到了一段tool_result至于子 Agent 中间读了几个文件、试了几轮命令、有没有走弯路这些过程都被封装在子上下文里了。为什么最后只返回摘要run_subagent()结尾这段代码几乎就是s04的灵魂:return.join(b.textforbinresponse.contentifhasattr(b,text))or(no summary)这段实现说明了一件很重要的事:子 Agent 的输出不是完整历史而是最后一轮文本结果。这样设计有三个直接好处。第一主上下文更干净。父 Agent 不需要反复咀嚼子任务里的试探过程只需要接住结论继续往前走。第二信息密度更高。原本几十段中间记录最后被压缩成几句有用结论主 Agent 的注意力更容易留在关键点上。第三委派边界更清晰。父 Agent 决定“做什么”子 Agent 负责“怎么摸清楚”返回时再把“摸清楚了什么”交回来。当然这也意味着它不是万能方案。如果主 Agent 后面必须依赖子任务的完整推理轨迹或者要审计子任务的每一步那只返回摘要就不够了。换句话说s04适合的是可以被压缩成结论的子任务。为什么子 Agent 不继续拥有task代码里专门把父子工具做了区分:父 Agent 有task子 Agent 没有task这个限制很克制但很合理。如果子 Agent 也继续拥有task那它就可以再叫出新的子 Agent系统很快就会变成无限套娃。教学示例里先把层级收住只保留“一层委派”更方便把核心问题讲透。这也能看出s04的设计态度: 先把信息边界做稳再谈更复杂的协作拓扑。它和s03的关系正好是两个方向我很喜欢把s03和s04放在一起看因为它们解决的是两种完全不同的失控风险。s03处理的是“任务很多时模型容易忘记做到哪了”s04处理的是“探索很多时主上下文容易越来越脏”前者是在补“进度管理”后者是在补“上下文管理”。换句话说:s03让 Agent 更会盯住计划s04让 Agent 更会保护主线思考这两个能力一前一后接起来整个系统就开始有点像真正能长期工作的智能体了。什么样的任务适合交给子 Agent从这份实现出发我觉得下面几类任务尤其适合拆出去:需要读很多文件才能得出一句结论的任务带有明显探索性质、可能会走几轮弯路的任务只需要返回摘要不需要完整过程回放的任务主 Agent 当前只想保留决策主线不想被细节淹没的任务反过来说如果任务本身非常短或者主 Agent 后续必须直接依赖中间细节那就没必要硬拆。子代理不是默认更高级而是在“上下文已经开始变脏”的时候提供了一种很实用的减负方式。最后总结s04_subagent.py看起来是在讲“怎么让 Agent 调用子 Agent”但我觉得更本质的主题其实是:当一个系统开始变复杂时光让它会做事还不够还要学会把不同层次的思考隔离开。父 Agent 保留主线子 Agent 负责探索两边共享工作区但不共享整段对话历史子任务做完之后只把压缩后的结论带回来。这套设计不花哨却非常像真实工程里的经验:不是所有细节都应该进入主决策面能局部消化的信息就尽量局部消化。这也是我理解s04时最有价值的一点:子代理的价值不只是“多一个帮手”更是“给主 Agent 留出一块干净的思考空间”。致谢学习主线参考并受益于shareAI-lab/learn-claude-code

相关文章:

子代理拆分任务:为什么要用上下文隔离保护 Agent 的思路清晰

子代理拆分任务:为什么要用上下文隔离保护 Agent 的思路清晰 很多人第一次看到子代理,注意力会先落在“一个 Agent 还能再叫出另一个 Agent”这件事上。这个现象当然有意思,但如果只停在这里,很容易错过 s04 真正想解决的问题。 …...

开源工具提升下载效率:多网盘直链获取方案实现下载效率提升60%

开源工具提升下载效率:多网盘直链获取方案实现下载效率提升60% 【免费下载链接】Online-disk-direct-link-download-assistant 一个基于 JavaScript 的网盘文件下载地址获取工具。基于【网盘直链下载助手】修改 ,支持 百度网盘 / 阿里云盘 / 中国移动云盘…...

如何让10美元鼠标超越苹果触控板:Mac Mouse Fix终极指南

如何让10美元鼠标超越苹果触控板:Mac Mouse Fix终极指南 【免费下载链接】mac-mouse-fix Mac Mouse Fix - Make Your $10 Mouse Better Than an Apple Trackpad! 项目地址: https://gitcode.com/GitHub_Trending/ma/mac-mouse-fix 你是否曾经为macOS对第三方…...

个人博客域名迁移说明 www.xiaoming.io

因为之前很多文章和插图都链接到了个人博客,一些读者评论和私信反馈链接有问题,图片不显示,这里特地说明如下:个人博客域名从原先的 www.hainter.com 改成了 www.xiaoming.io。例如文章中有链接 http://www.hainter.com/books 不能…...

开始新篇章

此博客发表关于 计算机技术 等方面的文章,欢迎友好评论交流...

终极RPG Maker解密工具:零基础快速提取游戏资源完整指南

终极RPG Maker解密工具:零基础快速提取游戏资源完整指南 【免费下载链接】RPGMakerDecrypter Tool for decrypting and extracting RPG Maker XP, VX and VX Ace encrypted archives and MV and MZ encrypted files. 项目地址: https://gitcode.com/gh_mirrors/rp…...

通义千问3-Reranker-0.6B开箱即用:国产信创服务器上的语义裁判快速搭建

通义千问3-Reranker-0.6B开箱即用:国产信创服务器上的语义裁判快速搭建 1. 为什么需要专业的语义重排序模型? 在信息爆炸的时代,我们每天都要面对海量的文本数据。无论是企业知识库、电商搜索还是智能客服,传统的关键词匹配就像…...

从底层源码深入分析Bean的实例化

在技术领域,我们常常被那些闪耀的、可见的成果所吸引。今天,这个焦点无疑是大语言模型技术。它们的流畅对话、惊人的创造力,让我们得以一窥未来的轮廓。然而,作为在企业一线构建、部署和维护复杂系统的实践者,我们深知…...

3个专业技巧:BilibiliDown跨平台B站视频下载器的完整应用指南

3个专业技巧:BilibiliDown跨平台B站视频下载器的完整应用指南 【免费下载链接】BilibiliDown (GUI-多平台支持) B站 哔哩哔哩 视频下载器。支持稍后再看、收藏夹、UP主视频批量下载|Bilibili Video Downloader 😳 项目地址: https://gitcode.com/gh_mi…...

AI头像生成器真实测评:生成的头像提示词到底好不好用?

AI头像生成器真实测评:生成的头像提示词到底好不好用? 1. 引言:为什么需要AI头像生成器 在社交媒体和数字身份日益重要的今天,一个独特的头像能让你在人群中脱颖而出。但设计一个专业又有个性的头像并不容易,特别是对…...

无公网IP解决方案:内网穿透实现OpenClaw远程调用SecGPT-14B

无公网IP解决方案:内网穿透实现OpenClaw远程调用SecGPT-14B 1. 问题背景与挑战 去年我在尝试将OpenClaw接入本地部署的SecGPT-14B模型时,遇到了一个典型的技术困境:我的开发环境位于家庭宽带网络下,没有固定公网IP地址。这意味着…...

如何5分钟配置绝区零全自动智能助手:释放游戏时间的终极指南

如何5分钟配置绝区零全自动智能助手:释放游戏时间的终极指南 【免费下载链接】ZenlessZoneZero-OneDragon 绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄 项目地址: https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon 还…...

G-Helper深度解析:轻量级华硕性能控制替代方案革新实践指南

G-Helper深度解析:轻量级华硕性能控制替代方案革新实践指南 【免费下载链接】g-helper Lightweight, open-source control tool for ASUS laptops and ROG Ally. Manage performance modes, fans, GPU, battery, and RGB lighting across Zephyrus, Flow, TUF, Stri…...

突破60帧束缚:原神高帧率解锁工具完全指南

突破60帧束缚:原神高帧率解锁工具完全指南 【免费下载链接】genshin-fps-unlock unlocks the 60 fps cap 项目地址: https://gitcode.com/gh_mirrors/ge/genshin-fps-unlock 你是否曾为《原神》的60帧限制而感到遗憾?当你的显示器支持144Hz甚至更…...

Janus-Pro-7B网络问题排查:遇到403 Forbidden等错误如何解决

Janus-Pro-7B网络问题排查:遇到403 Forbidden等错误如何解决 部署好Janus-Pro-7B服务,满心欢喜地准备调用时,屏幕上却弹出一个冷冰冰的“403 Forbidden”,或者连接超时、证书错误……这种瞬间从云端跌入谷底的感觉,相…...

GigE Vision 多相机同步终极检查清单(可直接用于项目部署)

GigE Vision 多相机同步终极检查清单(可直接用于项目部署)📋 GigE Vision 多相机同步终极检查清单一、网络基础设施二、PTP 配置三、硬件触发四、相机参数一致性五、软件数据处理六、验证手段📋 GigE Vision 多相机同步终极检查清…...

ComfyUI视频工作流解决方案:从图像序列到专业视频输出的完整指南

ComfyUI视频工作流解决方案:从图像序列到专业视频输出的完整指南 【免费下载链接】ComfyUI-VideoHelperSuite Nodes related to video workflows 项目地址: https://gitcode.com/gh_mirrors/co/ComfyUI-VideoHelperSuite 还在为ComfyUI中复杂的视频处理流程而…...

革新性无人机数据分析工具:UAV Log Viewer实战指南

革新性无人机数据分析工具:UAV Log Viewer实战指南 【免费下载链接】UAVLogViewer An online viewer for UAV log files 项目地址: https://gitcode.com/gh_mirrors/ua/UAVLogViewer UAV Log Viewer作为一款开源的无人机日志分析神器,正在彻底改变…...

网站SEO排名优化有哪些最佳实践

网站SEO排名优化有哪些最佳实践 在当今数字化时代,网站SEO排名优化成为了每个网站运营者必须面对的重要挑战。在百度等搜索引擎中,高排名不仅能够提升网站的曝光率,还能带来更多的流量和潜在客户。具体有哪些最佳实践可以帮助你提升网站在搜…...

当数字音频遇见时间魔法:FLAC如何为你的音乐收藏施展无损压缩

当数字音频遇见时间魔法:FLAC如何为你的音乐收藏施展无损压缩 【免费下载链接】flac Free Lossless Audio Codec 项目地址: https://gitcode.com/gh_mirrors/fl/flac 你是否曾为音乐收藏占用过多硬盘空间而烦恼?是否在音质与存储效率之间难以抉择…...

专业解决方案:Windows 11 LTSC系统一键安装微软商店完整指南

专业解决方案:Windows 11 LTSC系统一键安装微软商店完整指南 【免费下载链接】LTSC-Add-MicrosoftStore Add Windows Store to Windows 11 24H2 LTSC 项目地址: https://gitcode.com/gh_mirrors/ltscad/LTSC-Add-MicrosoftStore Windows 11 LTSC系统以其卓越…...

突破物理手柄限制!用vJoy打造3类自定义虚拟控制器

突破物理手柄限制!用vJoy打造3类自定义虚拟控制器 【免费下载链接】vJoy Virtual Joystick 项目地址: https://gitcode.com/gh_mirrors/vj/vJoy 当你在赛车游戏中因键盘无法实现精细转向而屡屡撞墙,当直播时需要同时操控游戏与控制台却手忙脚乱&a…...

如何突破登录壁垒?多登录系统让所有玩家畅玩同一游戏服务器

如何突破登录壁垒?多登录系统让所有玩家畅玩同一游戏服务器 【免费下载链接】MultiLogin 外置共存 项目地址: https://gitcode.com/gh_mirrors/mu/MultiLogin 在游戏服务器管理中,管理员常常面临一个棘手问题:如何让使用不同账号系统的…...

RexUniNLU效果实测:对比传统方法,零样本在垂直领域信息抽取的准确率表现

RexUniNLU效果实测:对比传统方法,零样本在垂直领域信息抽取的准确率表现 1. 测试背景与方法论 1.1 为什么需要零样本信息抽取? 在传统NLP项目中,构建一个可用的信息抽取系统通常需要经历数据收集、标注、训练、调优等复杂流程。…...

EasyAnimateV5-7b-zh-InP与Java集成开发实战

EasyAnimateV5-7b-zh-InP与Java集成开发实战 1. 企业级视频生成需求与解决方案 现在很多企业都需要视频内容,电商要商品展示视频,教育机构要教学动画,营销团队要广告视频。传统视频制作成本高、周期长,一个简单的商品视频可能就…...

微软UDOP-large应用案例:跨境电商发票处理效率提升300%

微软UDOP-large应用案例:跨境电商发票处理效率提升300% 1. 引言:跨境电商财务的“效率之痛” 如果你在跨境电商公司待过,一定对财务部门的发票处理流程印象深刻。每天,来自亚马逊、Shopify、速卖通等平台的订单发票,…...

Notepad--跨平台文本编辑器:3个简单技巧提升长期使用性能

Notepad--跨平台文本编辑器:3个简单技巧提升长期使用性能 【免费下载链接】notepad-- 一个支持windows/linux/mac的文本编辑器,目标是做中国人自己的编辑器,来自中国。 项目地址: https://gitcode.com/GitHub_Trending/no/notepad-- N…...

PICO开发效率翻倍:手把手教你用PDC串流实现Unity场景‘所见即所得’

PICO开发效率革命:用PDC串流实现Unity场景实时同步的终极指南 在VR内容开发领域,迭代效率往往决定着项目的成败。传统开发流程中,开发者需要反复在Unity编辑器和头显设备之间切换,每次修改后都要经历漫长的构建部署过程&#xff0…...

安全自定义暗黑2体验:d2s-editor的无门槛存档编辑方案

安全自定义暗黑2体验:d2s-editor的无门槛存档编辑方案 【免费下载链接】d2s-editor 项目地址: https://gitcode.com/gh_mirrors/d2/d2s-editor 副标题:从零开始的本地化存档修改掌握之路 你是否曾因反复刷装备而失去对暗黑破坏神2的耐心&#x…...

JSXBIN高效解码工具:突破Adobe脚本加密的技术方案与实战指南

JSXBIN高效解码工具:突破Adobe脚本加密的技术方案与实战指南 【免费下载链接】jsxer A fast and accurate JSXBIN decompiler. 项目地址: https://gitcode.com/gh_mirrors/js/jsxer 技术原理揭秘 二进制结构解析:JSXBIN如何存储代码信息&#xf…...