ARTICLE · INTELLIGENCE

战地情报 · 详情页

来自尧图项目组的一线实战观察与深度解析

AI Agent 祛魅指南:能用不代表该用——一套 Agent 选型的决策框架与成本模型

AI Agent 祛魅指南:能用不代表该用——一套 Agent 选型的决策框架与成本模型 AI Agent 祛魅指南能用不代表该用——一套 Agent 选型的决策框架与成本模型AI Agent 祛魅指南能用不代表该用——一套 Agent 选型的决策框架与成本模型一、引子当加个 Agent成了默认答案1.1 一个熟悉的评审场景需求评审会上某个环节被抛出一句几乎已经变成条件反射的提议“这块用 Agent 做吧模型能理解自然语言比较灵活。”这句话本身没错。错的是它往往绕过了三个必须先回答的问题这个任务真的需要运行时动态决策吗用哪一档复杂度才够用延迟、Token 与错误恢复的成本谁来算、算过没有2026 年下半年的行业语境让这个问题更紧迫。GitHub 热榜上“给 AI 编码智能体配技能和流程类项目集中出现obra/superpowers 被描述为智能体技能框架与软件开发方法论”[3][5]周度观察称行业重心已从早期单点演示转向全流程交付编码代理正嵌入软件的完整交付链路[4]同期报道把评审称为新瓶颈IDE 正在变成多智能体调度台[6]。这些信号合起来指向同一件事Agent 的能力演示已经不稀缺稀缺的是该不该用、用到哪一档、失败了怎么办的工程判断力。微软 AI Agents for Beginners 课程的第一原则正是这句提醒能用不代表该用“Just because you can use an AI Agent doesn’t mean you always should”转引自课程解读文章[1][2]。本文的任务是把这句提醒翻译成一套可以套用的工具。1.2 本文要回答的三个问题这个任务是否真的需要运行时动态决策还是流程可以预先写成代码路径单次调用、工作流、自主 Agent 三档中哪一档是够用的最低档延迟、Token 与错误恢复构成的总成本是否在预算与 SLO 之内1.3 阅读地图全文按分界线 → 复杂度阶梯 → 成本模型 → 决策框架 → 趋势印证 → 落地清单推进。贯穿全文的是一个虚构场景——工单处理系统明确标注为演示用途不对应任何真实客户案例。开篇先给一张速览表作为全文的浓缩预告方案灵活性可解释性延迟Token 成本典型失败模式可测试性规则代码低高最低零规则覆盖不全最高单次 LLM 调用中中低低且可预测幻觉、格式漂移高工作流中高中高中中约等于步数之和上下文丢失、错误沿链放大中自主 Agent最高低高且波动大高长尾分布任务漂移、循环不收敛、工具误用低二、两份材料的共识先问该不该再问怎么做2.1 微软课程从任务适配性切入微软 AI Agents for Beginners 课程的立场是决策层面的判断一个任务该不该交给 Agent要看它的开放程度、流程能否预先定义、失败代价有多大[1]。课程第一课那句能用不代表该用把责任从模型能力拉回到工程判断上——Agent 是一种架构选择不是功能升级的默认终点。需要说明的是本文对课程原文的引用来自中文解读文章的转引[1]具体英文措辞与课程当前版本的判断维度清单正式引用前应对照官方仓库课程原文核对课程内容本身存在版本更新的可能。2.2 Anthropic从实现分层切入Anthropic《Building Effective Agents》提供了实现层面的划分[2]工作流workflowsLLM 与工具按照预先写定的代码路径被编排起来路径由开发者控制AgentagentsLLM 在循环中自主决定自己的过程与工具使用方式路径由模型在运行时决定。这篇文章的工程取向是明确的从简单方案开始寻找满足需求的最简形态让执行过程尽可能透明例如展示计划步骤。它同时直言 Agent 的代价——更高的 Token 消耗、更长的延迟、错误在多步中累积的风险[2]。2.3 两者如何互补决策维度微软课程视角Anthropic 视角本文合并结论该不该做任务适配性、失败代价找最简方案先做分界线判定再谈架构做到哪一档未展开工作流与 Agent 的实现分层用复杂度阶梯选档成本隐含在不该用提醒中明确提示 token、延迟、错误累积用成本模型量化工程保障任务评估透明性、可观测的计划步骤护栏、评测、降级开关一句话概括微软给要不要做的判断框架Anthropic 给做到哪一档的实现分层本文把两者合成一套可执行流程。2.4 一个被忽视的共同点两份材料都指向同一个边界条件Agent 的价值在于处理开放式、步骤无法提前硬编码的任务。当任务路径可以穷举时把路径交给代码、把节点内的判断交给模型比把整个过程交给模型更可靠、更便宜、更可测试。这条共识是后面所有内容的地基。三、分界线流程可预定义 vs 需要动态决策3.1 两个判据判据 A步骤可枚举性。能否在写代码时穷举出任务的所有可能路径能路径就是代码不能路径就必须在运行时决定。判据 B上下文不可预测性。输入中是否存在大量必须实时读取才能决定下一步的信息比如某个系统返回的报错内容、某个文档的实际结构、某个网页的真实布局。3.2 四种组合上下文可预测上下文不可预测步骤可枚举纯代码 / 规则引擎不该用 LLM工作流代码控制路径LLM 做节点内判断步骤不可枚举通常是需求没想清楚回到产品定义自主 Agent候选区仍需过成本与兜底关值得注意的是右下角格子。不可枚举 可预测这个组合在实践中多半不是任务属性问题而是需求定义问题如果上下文是稳定的那么多想一步通常能把步骤枚举出来。这一格应该是触发需求澄清的警报而不是上 Agent 的理由。3.3 三条伪动态决策陷阱陷阱一输入花样多分支其实有限。表单内容千变万化但处理分支只有退款、报修、投诉三类。这是分类问题不是规划问题。用一个路由节点就能解决。陷阱二团队画不出流程图误以为等于不可预定义。更多时候这是领域知识缺口不是任务的固有属性。请一位资深客服主管坐下来讲半天流程图通常就出来了。陷阱三把需求还会变当成运行时需要动态决策。需求变更是迭代期问题运行时决策是执行期问题。前者需要配置化和灰度发布后者才需要 Agent。3.4 中间地带可预定义骨架 动态填充Anthropic 归纳的几种编排模式——prompt chaining、routing、parallelization、orchestrator-workers、evaluator-optimizer[2]——本质都是代码定骨架、模型填内容。只有当骨架本身也交给模型决定才真正进入 Agent 区间。这个区分很关键很多人说自己在用 Agent实际上用的是带 LLM 节点的工作流这不是贬义恰恰说明他们在正确的位置用了正确的复杂度。3.5 案例演示工单处理的两个分支分支一工单分类与派发。分支可枚举退款 / 报修 / 投诉 / 兜底人工上下文就是工单文本本身。判定结果工作流的路由节点甚至不需要工作流。# 概念示意代码控制路径LLM 只负责节点内的判断# 不绑定任何厂商 SDK 的真实 API 签名categoryllm_classify(ticket,categories[refund,bug,complaint])ifcategoryrefund:returnrefund_flow(ticket)# 预定义流程elifcategorybug:returnbug_triage_flow(ticket)else:returnhuman_handoff(ticket)# 兜底分支二跨系统排查故障工单。要查日志、查监控、查变更记录每一步查什么取决于上一步的结果路径不可提前穷举。判定结果自主 Agent 候选但必须带着护栏进入下一节的阶梯判断。四、复杂度阶梯单次调用 → 工作流 → 自主 Agent4.1 第一档单次调用适用信号一次输入对应一次输出不需要外部工具不需要多步。典型任务抽取字段、分类、摘要、改写、生成结构化输出。失败模式幻觉、输出格式漂移。对策schema 约束输出、解析失败重试、超阈值转人工。成本特征几乎完全可预测。单次输入输出 token 数稳定延迟稳定是最容易做预算的一档。4.2 第二档工作流适用信号步骤可预定义但每一步的内容需要模型判断。五种常见编排模式命名依 Anthropic[2]模式何时用主要代价常见陷阱Prompt chaining任务可拆成固定顺序的子步串行延迟叠加中间结果丢上下文Routing输入可归为有限类别分类错误直接走错分支类别边界模糊Parallelization子任务相互独立并发成本上升合并结果时口径不一Orchestrator-workers子任务需动态拆分调度与汇总成本工作单元粒度过细Evaluator-optimizer有明确的质量评判标准循环成本循环必须设上限失败模式节点间上下文丢失、错误沿链放大、evaluator-optimizer 循环不收敛。成本特征约等于各步之和可预算但要为重试留余量。4.3 第三档自主 Agent适用信号步骤不可预定义需要模型自主规划、调用工具、根据环境反馈决定下一步通常在真实环境中运行较长时间。Anthropic 对 Agent 的描述强调了两面性环境反馈带来纠错能力同时带来更高成本与更多错误累积风险[2]。失败模式任务漂移越做越偏离原始目标、无限循环、工具误用、执行轨迹不可复现。成本特征分布呈长尾。均值毫无意义必须看 P95并且必须设硬上限。必须存在的控制件步数上限、超时、工具白名单、检查点可恢复、敏感操作人工确认、超预算兜底。# 概念示意Agent 骨架中必须存在的减速带forstepinrange(MAX_STEPS):actionagent.decide(state)# 模型自主决策ifaction.typecall_human:# 显式升级returnescalate(state)ifnotallowed(action,TOOL_WHITELIST):returnescalate(state)# 工具白名单拦截stateexecute(action)# 环境反馈checkpoint(state)# 可恢复ifbudget.exhausted():returnfallback(state)# 成本熔断raiseStepLimitExceeded(state)4.4 晋级与降级规则升档三条件同时满足才升上一档的失败模式成为主要瓶颈失败能够被环境反馈自动纠正失败代价可控且有兜底路径。降档三信号出现一个就该考虑降任务路径已稳定重复出现可以固化成代码分支延迟 SLO 开始告警成本超出预算。一句话原则复杂度应停在够用的最低档。升档是为了解决具体的失败模式不是为了架构图好看。4.5 同一案例走完三档# 第一档单次调用labelllm_classify(ticket_text)# 第二档带 evaluator 的工作流draftllm_summarize(ticket_text)foriinrange(MAX_REVIEW_ROUNDS):# 显式上限scorellm_evaluate(draft,rubric)ifscoreTHRESHOLD:breakdraftllm_rewrite(draft,score.feedback)publish(draft)# 第三档带工具循环的 Agent含护栏stateload_ticket(ticket_id)forstepinrange(MAX_STEPS):planagent.decide(state)stateexecute(plan,toolsTOOL_WHITELIST)checkpoint(state)ifbudget.exhausted():returnfallback(state)三段代码的行数差异不大可控性的差异是数量级的第一段可完全单元测试第二段可用固定评测集回归第三段只能做轨迹级评估与运行时护栏。五、成本模型延迟、Token 与错误恢复5.1 成本不止一项是四项① Token 成本。输入 token 包括系统提示、工具定义、历史上下文输出 token 是模型生成的部分。多步循环中若每一步都携带之前全部历史token 消耗随步数显著上升是否呈超线性取决于上下文管理策略截断、摘要、检索因此更稳妥的表述是步数是最贵的变量上下文管理策略决定它涨得有多快。② 延迟成本。n 步 Agent 意味着 n 次模型往返加 n 次工具执行且是串行的。用户等待时间、交互节奏、SLO 达标率都会被步数直接放大。③ 错误恢复成本。重试、人工介入、回滚、值班与客服负担。这是最容易被漏算、也最致命的一项。单步准确率 90% 不等于任务成功率 90%——多步任务中错误会累积。④ 工程与机会成本。评测集建设、护栏开发、可观测性、模型版本变更的回归验证、长期维护人力。这部分不体现在推理账单上却决定了方案能不能活过半年。5.2 一个可用的估算框架以下为概念模型参数需用读者自己的监控数据填充本文不给具体模型价格各厂商定价变动频繁请以官方定价页当日数据为准。单任务期望成本 Σ(各步 token 数 × token 单价) 延迟超标惩罚超 SLO 的业务代价 期望错误恢复次数 × 单次恢复成本 分摊的工程维护成本 期望错误恢复次数 ≈ 任务步数 × 单步失败率 / 单步纠错成功率任务级成功率的简化估算任务成功率 ≈ 单步成功率 ^ 有效步数需要明确标注这是简化模型忽略了步骤之间的相关性用途是解释步数放大失败率这一直觉不是实测数据。举例说明纯算术演示单步成功率 95% 时10 步连乘约为 0.95^10 ≈ 0.60即任务级成功率约六成。若单步成功率是 99%10 步也只剩约 0.90。5.3 三档复杂度的成本画像维度单次调用工作流自主 AgentToken 成本固定、可预测各步之和可预算长尾分布需设硬上限延迟一次往返串行步数叠加数倍于工作流波动大错误恢复重试即可节点级重试 人工兜底需轨迹级诊断 回滚预算方式按调用量按调用量 × 步数按 P95 熔断监控难度低中高5.4 一个成本估算模板字段填写内容示例占位任务名工单分类派发—预计有效步数由流程图统计待填每步输入/输出 token 估计用 20 条真实样本实测待填单步失败率从评测集统计待填单次人工恢复耗时从工单系统统计待填日任务量业务量预测待填延迟 SLO产品定义待填单任务成本区间由下述脚本计算待填# 概念示意成本估算脚本骨架纯算术不接任何厂商 APIdefestimate_task_cost(steps,in_tok,out_tok,in_price,out_price,step_fail_rate,retry_success_rate,recovery_cost,latency_budget,latency_penalty):token_coststeps*(in_tok*in_priceout_tok*out_price)expected_recoveriessteps*step_fail_rate/max(retry_success_rate,1e-6)recovery_totalexpected_recoveries*recovery_cost# 延迟粗略按串行步数估计实际需用真实监控数据校准expected_latencysteps*avg_step_latency latency_totallatency_penaltyifexpected_latencylatency_budgetelse0return{token:token_cost,recovery:recovery_total,latency_penalty:latency_total,total:token_costrecovery_totallatency_total,}5.5 何时成本不构成否决理由两种情况下Agent 的额外成本是划算的一是单次失败代价极高安全、合规、资金相关此时模型的规划与纠错能力可以覆盖成本二是任务本身高度开放、人工处理成本同样很高如跨系统排障。反之高频、低价值、可校验的简单任务是最不该上 Agent 的一类——它们的成本会被调用量无情放大。六、决策框架一张流程图、一份清单、一组反例6.1 六问决策卡任务输出是否可被明确校验步骤是否可提前穷举是否需要根据中间结果改变后续步骤失败是否可由环境反馈自动纠正延迟与成本预算能否覆盖最坏情况是否有兜底人工升级 / 降级路径 / 回滚落点判定问题 1–3 大多为否 / 可预定义 → 纯代码或单次调用步骤可预定义但内容需判断 → 工作流步骤不可预定义、可被环境反馈纠正、且预算可覆盖最坏情况 → 自主 Agent第 6 问为否 →不做无论前三问结果如何。6.2 五类不该用 Agent的反模式反模式为什么不该用替代方案主要风险确定性业务规则计费、额度、合规判定规则必须可审计、可复现代码规则引擎模型只做解释层模型输出被误当判定依据高频低价值任务简单分类、格式转换调用量放大成本单次调用 缓存账单失控强实时交互延迟 SLO 秒级、步数多串行步数击穿延迟预算单次调用或异步工作流用户体验崩塌无校验手段的开放式生成错误无法被发现先建评测与抽检再考虑 Agent幻觉静默流入生产失败不可逆且无兜底资金划转、生产写操作错误无法挽回人工确认门 规则代码事故6.3 三条降级路径Agent → 工作流路径稳定重复出现后把高频路径固化成代码分支把低频未知路径留给 Agent 兜底工作流 → 单次调用节点判断稳定后可用小模型或微调模型替代降低单步成本单次调用 → 规则代码模式完全确定后用确定性代码替换获得最高可靠性与零推理成本。关键在于降级不丢能力只是把灵活性换成可靠性。这不是技术倒退是成熟系统的自然收敛。6.4 案例推演需求 A工单分类派发。步骤可枚举、输出可校验、失败代价低。结论单次调用 路由节点。需求 B多系统故障排查。路径不可枚举、有环境反馈、失败可被纠正。结论自主 Agent但必须带步数上限、工具白名单、检查点与人工升级。需求 C自动退款执行。失败不可逆、金额相关。结论不用 Agent 做执行模型只做事实抽取与建议执行前走人工确认门。# 概念示意人工确认门ifaction.typeinSENSITIVE_ACTIONS:approvalrequest_human_approval(actionaction,evidencestate.evidence,model_recommendationmodel_output,)ifnotapproval.granted:returnescalate(state)execute(action)七、趋势印证2026 年 10 月从演示到可靠性工程7.1 技能与方法论层项目走热2026 年 10 月 2 日的 GitHub 日榜收录 15 个项目、合计新增约 8,783 star其中给 AI 编码智能体配技能和流程的项目数量居前obra/superpowers 被描述为智能体技能框架与软件开发方法论[3]相关生态观察也把这类项目视为 2026 年 Agent 落地的代表性方向[5]。这恰好印证了本文的核心论点当 Agent 的基础能力不再是瓶颈约束 Agent 的技能、流程与护栏成为工程抓手。换句话说热榜投票给的是如何让 Agent 可靠交付而不是如何让 Agent 更自主。7.2 可靠性工程成为交付门槛周度观察称行业重心已从早期单点演示转向全流程GitHub Copilot 迭代 Agent Merge 与 PR 全链路上下文编码代理正嵌入软件完整交付流程[4]。同期报道则提出 IDE 变成多智能体调度台、“评审成新瓶颈”并提到 Codex CLI 0.160.0 的任务命令中心与可选 Guardian review 等特性[6]。需要注意证据强度上述产品特性来自二手资讯汇总[4][6]具体名称、版本号与行为边界应以厂商官方发布或更新日志为准本文仅作趋势方向的旁证使用。这与成本模型直接呼应可靠性工程要压降的正是错误恢复成本那一项。评审、结果校验、回滚能力都是把期望错误恢复次数往下压的手段。7.3 冷静剂热榜数据的波动热榜本身并不稳定。同为掘金的统计10 月 2 日日榜 15 个项目合计新增约 8,783 star[3]10 月 11 日日榜 13 个项目合计新增约 39,582 star[7]10 月 4 日周榜 19 个项目合计新增约 70,976 star[8]且 10 月 11 日星数最高的两个项目分别是逆向工程工具与游戏主机移植工具并非 AI 项目[7]。数据采集侧也显示热度指标本身缺失无法据此排序GitHub 趋势聚合记录同此[10][11]。同时老牌基础设施项目长期稳态在榜。以 fmtlib/fmt 为例一篇热榜观察将其 14 年的工程基因概括为 ChangeLog、CONTRIBUTING、完整单测与开发文档与短期爆红的演示型仓库形成对照[9]。技术选型的判断标准应当是长期可维护性而不是一周的 star 增速。八、落地清单选型之后要建的四件事8.1 评测集与验收标准指标定在任务级成功率不是单步准确率保留人工抽检比例抽检样本进入回归集线上失败案例持续回流到评测集评测集随系统一起演进。8.2 护栏与控制件# 概念示意护栏配置字段为概念命名不对应任何真实 SDKagent_guardrails:max_steps:12timeout_seconds:180tool_whitelist:[search_logs,read_metrics,query_changes]sensitive_actions:[refund,delete_record,prod_write]require_human_approval_for:[sensitive_actions]budget:max_tokens_per_task:200000on_exhaustion:fallback_to_workflowcheckpoint:enabled:trueinterval_steps:2escalate_on:[step_limit,tool_denied,budget_exceeded,evaluator_fail]8.3 成本监控与降级开关监控单任务成本分布看 P50/P95不看均值监控人工升级率、平均步数、循环收敛率设置超预算自动降级开关Agent → 工作流 → 单次调用逐级兜底。8.4 组织侧立项评审 checklist项目优先级缺失后果任务级评测集P0无法判断方案是否真的可用步数/超时/预算上限P0成本与延迟不可控敏感操作人工确认P0不可逆事故轨迹日志trajectory loggingP1故障无法定位降级开关P1故障时只能整体下线成本 P95 看板P2预算失控在月底才被发现失败案例回流机制P2系统长期停滞不进化九、结语把 Agent 当作最后手段而非默认答案回到开头那个评审场景。现在当有人说这块用 Agent 做你有了可回答的追问清单步骤能不能穷举输出能不能校验失败能不能被环境纠正最坏情况的成本和延迟谁来兜底三句口诀供转发与自查能预定义就别交给模型。够用的最低复杂度就是最好的复杂度。算不清错误恢复成本就先别上 Agent。Agent 不是产品的功能升级项而是一种在路径不可预定义前提下才成立的架构选择。它的价值真实存在但它的账单同样真实。把选择权拿回自己手里比追逐任何一轮热榜都更接近工程的本质。欢迎用你自己的场景套一遍决策卡把真实的成本数据反馈回来那是迭代这套框架最有价值的输入。参考资料[1] 《AI Agent原理与实战》2026版 第4课 何时需要 Agent决策框架CSDNhttps://blog.csdn.net/weixin_40192882/article/details/166995425[2] Building Effective AgentsAnthropic Engineeringhttps://www.anthropic.com/engineering/building-effective-agents链接见于[1]所述材料正式引用前建议核对原文最新版本措辞[3] GitHub 热榜项目日榜2026-10-02本期共收录 15 个热门开源项目合计新增 8,783 star掘金https://juejin.cn/post/7691498553260949544[4] 2026 年第 40 周 GitHub 趋势周报导读掘金https://juejin.cn/post/7692739051067260937[5] AI Agent 落地元年下半场从 Coding Agent 到 Personal Agent可靠性工程才是交付门槛CSDNhttps://blog.csdn.net/m0_74899094/article/details/167465935[6] AI 新闻日报 2026-10-04IDE 变成多智能体调度台 / 评审成新瓶颈CSDNhttps://blog.csdn.net/qq_39427511/article/details/167072184[7] GitHub 热榜项目日榜2026-10-11本期共收录 13 个热门开源项目合计新增 39,582 star掘金https://juejin.cn/post/7694947768088772623[8] GitHub 热榜项目周榜2026-10-04本期共收录 19 个热门开源项目合计新增 70,976 star掘金https://juejin.cn/post/7692065346283733032[9] GitHub 每日热评热榜冷思考当万千 Agent 爆红时14 年的 fmtlib/fmt 为何依旧霸榜CSDNhttps://blog.csdn.net/TunerT_TQ/article/details/164403082[10] Latest 10 Trending Repositories - October 05, 2026 · Issue #571 · marc-ko/daily-trending-repoGitHubhttps://github.com/marc-ko/daily-trending-repo/issues/571[11] AI Open Source Trends 2026-10-04 · Issue #328 · kouweizhu/agents-radarGitHubhttps://github.com/kouweizhu/agents-radar/issues/328
RELATED READING

延伸阅读

更多一线实战笔记与深度复盘,助您持续精进