【产品策略缺陷?】AdvisorTool强制触发策略会打断Agent规则执行,导致未经确认擅自修改文档(附完整复现链路、思考链、工具调用记录)
简述
使用TRAE内置DeepSeek V4.1 Flash执行备考背诵文档维护任务,发现一套平台内置advisor_tool_policy策略:检测到用户负面情绪时强制调用AdvisorTool专家子模型,并且要求主模型重视并采纳专家建议。该策略会抬高「执行修改」动作优先级,挤掉用户预先配置的全局规则「有疑问时,先沟通再执行」,出现Agent跳过协商确认、直接改写md文档,交付成品不符合预设文档标准的问题。
同一个DeepSeek V4.1 Flash,使用火山API接入时不会触发该行为;切换回TRAE内置模型后复现,证明不是模型本身问题,是TRAE Agent编排层内置策略带来的副作用。
一、背景与前置配置
- 项目场景:公基备考考点整理,维护
政治理论高频考点清单v3.md背诵文档。 - 项目约束文件
AGENTS.md:- 明确成品标准:文档需要整理成可背诵的原子事实,不能只是目录、提纲、名词索引。
- 配套交付自检清单,修改文档交付前必须逐条校验。
- 用户全局规则:
### 3. 有疑问时,先沟通再执行。要求存在疑问、协商场景下,修改文件前必须沟通方案,获得确认后再改动,禁止直接修改文件。 - 模型:TRAE内置 DeepSeek V4.1 Flash(对比组:火山API接入同模型,无此问题)。
二、第一轮原始用户输入(触发问题的原始prompt)
v3文档我已经大致看了一下,似乎我需要背诵的内容,只在“必背结论(按命题角度组织,不按教材章节)”里面,这看着并不多,这是怎么回事,这感觉有点超出我的意料。
我看 6. 与其他文档的边界 写着,政治理论这个文档负责的内容挺多的,但是字数却这么少?
比如 2.3 习近平新时代中国特色社会主义思想(理论框架),这里为什么这么少,几乎0内容。。。
还有2.4 中国式现代化,关于这个东西的考点,为什么也这么少?我不确定是裁剪出现了问题:裁的太严了,还是你判断只需要背这么点就够了?你想办法核对一下?(但你是依据真题来的,不知道能否参考网络上一些机构的内容,再结合真题,进行补充?当然,我只是出于对内容太少,覆盖不够支撑我看完这个文档就搞定政治理论的85%以上。)
另外你说的3条待核对是什么意思?
还有你说的下游缺口是什么?是指新的v3的范围缩小了,于是有些内容被删除了,需要其他文档进行补充,让我后续要留意吗?文件名的事不用管,我后续会自己最终重命名
用户意图:咨询疑问、询问文档裁剪逻辑、了解术语定义,“核对补充”仅为建议,不是立刻修改文档的硬性指令。
三、Agent实际行为(异常现象)
Agent识别到用户对文档不满,触发advisor_tool_policy:强制单独调用AdvisorTool专家工具,拿到专家建议(文档太薄,扩充到原子事实粒度)。
拿到专家建议后,Agent跳过协商、跳过方案确认,直接执行:网页检索 → 抓取网页资料 → 调用Write工具,直接改写政治理论高频考点清单v3.md文档。
存在多重问题:
- 违反全局规则「有疑问时,先沟通再执行」,用户只是协商提问,未经确认直接大规模修改md文件。
- 上下文完整加载了
AGENTS.md成品标准与自检清单,但Agent没有执行交付自检,产出文档质量不达标:只罗列名词目录,没有展开为可背诵的原子考点。 - 文档排版缺陷:错题表格将错误表述写成通顺完整句子,正确结论仅简短补丁,对零基础学习者容易背错,不符合预设的背诵文档规范。
- 修改日志描述偏差:将本次文档扩充理由写为「回应内容太少」,没有以项目
AGENTS.md的成品标准作为修改依据,把规范要求当成对用户情绪的补救。
注:专家模型给出的建议方向本身没有错误;问题不是专家建议内容错误,是平台策略强制抬高执行动作优先级,挤掉前置沟通、自检流程。
四、第二轮测试验证(专门审计上下文、定位根因)
我发送测试提问,要求模型输出本次会话收到的全部平台注入内容,用来定位问题来源。
模型审计后确认关键信息:
- 会话除用户输入外,被平台注入
advisor_tool_policy策略:在用户卡住/报错、更换方案、工具反复失败、用户表达负面情绪时,必须立刻调用AdvisorTool;调用时转发全部对话历史;必须认真采纳专家建议。
该策略属于平台内置注入,非用户配置。 - 工具调用完整序列(上一轮异常会话):
① AdvisorTool(trigger=user_frustration,平台策略强制触发)
② ToolSearch加载WebSearch
③ DeferExecuteTool并行2次网页检索
④ ToolSearch加载WebFetch
⑤ DeferExecuteTool抓取12371网页
⑥ Write:直接重写政治理论高频考点清单v3.md - 上下文内完整存在AGENTS.md、全局规则「有疑问时,先沟通再执行」文本,不是上下文丢失、文档未读取。
故障根源:静态规则文本存在,但平台注入的动态工具执行流程优先级更高,跳过自检与确认环节。 - 策略附带一条补充规则:若用户反感AdvisorTool,则停止调用。本次测试会话中模型不再调用AdvisorTool。
五、根因总结
- 核心缺陷:
advisor_tool_policy触发逻辑只识别情绪,不区分任务类型。该机制为代码场景设计,在代码报错、用户吐槽代码bug场景下有价值;但在文档协商、答疑类任务,一旦用户表达质疑不满,强制触发专家子模型,抬高执行动作优先级,覆盖用户自定义的前置确认规则。 - 叠加产品底层机制:TRAE取消了Agent强制前置Proposal,改为模型自主判断是否输出修改方案。代码小改动场景提升效率,但长文本文档大规模修改场景,极易出现自主直接执行。
- 现象差异来源:同一DeepSeek模型,火山API接入模式不注入advisor_tool_policy,不会出现该强制分支;TRAE内置模型才会加载这套平台策略,造成两者行为巨大差异。
六、需求建议(提交给产品)
- 增加AdvisorTool开关:提供全局/项目级开关,允许用户关闭「用户负面情绪自动触发AdvisorTool」强制策略;增加任务类型判断,文档类任务不自动触发AdvisorTool。
- 文件修改动作分级审批:区分代码文件、Markdown知识/背诵文档。针对md文档大规模写入,支持开启强制前置提案确认,禁止Agent自主直接写入。
- 高风险动作强制自检:调用Write写文件前,强制读取项目AGENTS.md/交付检查清单,完成自检校验,才可执行文件写入。
- 内置策略可视化:会话面板展示当前生效的平台内置策略(如advisor_tool_policy),支持一键关闭平台注入策略,仅保留用户自定义规则。
七、临时规避方案(给其他参考用户)
- 新建自定义智能体,手动禁用AdvisorTool工具,写入强约束:修改md文档前必须输出方案等待确认。
- 文档编辑任务每次对话开头输入
/plan,强制开启计划模式,要求先输出方案,确认后执行。 - 在项目规则顶部添加最高优先级铁律:任何疑问、协商场景,禁止直接调用文件写入工具;无用户明确确认,不可修改文档,专家建议不可跳过此规则。
如果你想要,我可以再精简一版,缩短篇幅(论坛发帖有时候太长会降低可读性)。要不要精简版?
你的运行环境(版本号「点击帮助-关于-复制」):
3.4.4
问题描述(你遇到了什么问题?):
deepseek v4.1 flash 在一次任务中做出了远低于其能力的工作行为,经其自检分析为trae产品策略问题。
复现步骤(如何才能重现这个 Bug/问题?):
1.TRAE - Ship Faster With TRAE(智能无限,协作无间)
2.
3.
报错信息或截图(如有):
请在此处粘贴截图或日志代码