AI 项目的技术债:框架选错的代价比你想的大
数据截至 2026-07,价格与限额以各官网为准。
多智能体框架的技术债,贵就贵在它不是一层可替换的依赖,而是你整个业务流程的表达方式。换数据库你还能靠一层 DAO 挡一挡,换编排框架往往意味着”谁调用谁、状态怎么传、失败怎么退回”这套逻辑要按新范式重写一遍——代码删得掉,团队对流程的理解和踩过的坑删不掉。
常见的误解是:这些框架底下都是同一批大模型 API,换起来能有多难?确实,模型调用那一层是可移植的,写提示词、解析返回、重试退避这些代码大多能原样搬。问题在于,你真正投入时间的地方通常不是这一层,而是”三个 agent 怎么配合、跑到一半失败怎么办、人怎么插进去审一道”。这部分逻辑在不同框架里的表达方式完全不同,搬不过去。
下面按”债从哪来 → 利息长什么样 → 怎么少借”的顺序讲。需要说明的是,本文关于框架能力的对比结论主要来自 2026 年若干篇第三方实战对比文章的口径,不是逐条核对官方文档得来的,具体能力和 API 请以各项目官方文档当前版本为准。
一、最省钱的一条:先确认你是不是真需要多智能体框架
这条值得放在所有选型讨论之前。有一个说法在实践者中传得不多但很重要:如果你的场景只是单个 agent 调一两个工具,OpenAI Agents SDK 或 Anthropic Claude Agent SDK 往往是 2026 年更快的路径——你可能根本不需要多智能体框架。
很多”技术债”的源头不是选错了框架,而是压根不该引入框架。一个客服问答机器人,能查订单、能查物流,就这两个工具,用厂商 SDK 三十行代码能跑起来的东西,套上一层图编排之后,你要维护节点定义、状态 schema、条件边,还要跟着框架版本升级。功能一样,维护面积翻了几倍。
可操作的判断:把你要做的事画在纸上。如果画出来是一条直线加两个工具调用,别上框架;如果画出来有分叉、有回头箭头、有”这一步做完要等人点确认”,再往下看。
二、迁移贵在哪:三种架构模型互相不通约
真正让迁移成本高起来的,是这三个主流框架用的是三种不同的心智模型:
- LangGraph 是有向图。节点是函数或 LLM 调用,边定义控制流,状态以带类型的字典在节点之间传递。你写的是”图的结构”。
- CrewAI 是角色分工的一队 agent。研究员 → 写手 → 审稿这种,可以串行也可以并行。你写的是”谁负责什么”。
- AutoGen / AG2 是基于对话的。agent 之间互相交谈来推进任务,对话模式最丰富,擅长多方辩论和达成共识这类场景,也常被用在代码生成与调研上。你写的是”让谁跟谁说话”。
这三种表达方式之间没有机械的翻译规则。一个在 CrewAI 里写成”三个角色顺序交接”的流程,搬到 LangGraph 要重新想清楚状态字典里放什么、边的条件怎么判断;一个在 AutoGen 里靠多轮对话自然收敛的辩论过程,用图去表达就得显式地把终止条件写出来。迁移的工作量不在打字,在于重新想一遍。
这也是为什么”先随便选一个跑起来,不行再换”这个策略在别的技术栈成立、在这里代价偏高——你换的不是库,是你对业务流程的建模方式。
相关的横向对比可以看LangGraph 和 CrewAI 怎么选:先看你的流程有没有环。
三、AutoGen 进入维护模式:选型信息本身也会过期
一条在 2026 年选型时必须知道的事实:微软把重心转到了更大的 Agent Framework,AutoGen 的主要新功能开发已经停止,仍有 bug 修复和安全补丁,社区正在找替代路线。有实践者直言,2026 年不该把它作为任何新项目的起点。
这句话要就事论事地读,不必过度反应。维护模式不等于项目消失:安全补丁还在发,存量项目不必恐慌迁移,急着连夜重写反而是新增风险。但对新项目来说,选一个新功能开发已停止的框架,意味着你从第一天起就在给自己攒债——将来需要的新能力大概率要自己实现,社区新出的集成也不会优先适配。
这件事对技术债的启示比框架本身更普适:选型依据是有保质期的。一个项目的活跃度、维护状态、路线图,都可能在一年内翻转。所以选型文档里最好留一行”这个判断基于什么时候的什么信息”,方便半年后有人来复核,而不是把当时的结论当成永久真理写进 wiki。
更细的讨论见AutoGen 进入维护模式:新项目还该不该选它。
四、拿过期的对比表做决策,是最隐蔽的那种债
上一节说的保质期问题,有个具体例子:CrewAI 在 2025 年加了 Flows,一种事件驱动的 pipeline 模式,面向更可预测的生产型负载。多数较老的对比文章没有涵盖这一点,还在沿用”CrewAI 只适合做原型”的旧结论。
如果你的团队在做选型时搜到的正好是这类旧文,很可能会因为一个已经不成立的理由排除掉一个本来合适的选项,或者反过来,为了一个”CrewAI 做不到”的假设去上更重的方案。这种债最隐蔽,因为决策过程看起来完全合理,只是输入数据过期了。
可操作的做法有这么几条:
- 选型时至少去项目仓库看一眼最近的提交和 release 记录,比看第三方对比文更能反映真实状态。
- 对比文优先看有明确日期标注的,没写日期的直接降权。
- 把”这个结论的依据日期”写进选型文档,别只写结论。
- 决策会上明确问一句:这个否决理由是基于哪个版本的行为?
CrewAI Flows 的具体用法可以看CrewAI 的 Flows:它已经不只是原型工具了。
五、五个维度里,哪些会变成长期利息
某次第三方实测对比给出的排序是这样的(同样是第三方口径,仅供参考):
- 学习曲线:CrewAI 最平缓,LangGraph 最陡。
- 控制力:LangGraph 最强。
- 生产成熟度:LangGraph 最成熟。
- token 效率:LangGraph 最好,AutoGen 开销最大。
- 生态规模:LangGraph 最大。
这五个维度对技术债的贡献方式不一样,值得分开看。
学习曲线是一次性成本,团队学会了就摊完了,除非人员流动很大。它容易被高估——很多团队因为”这个太难学”而选了上手快的方案,结果在第二个季度撞上控制力不足的墙。
控制力和生产成熟度会转成长期利息。控制力不足的表现通常不是”做不到”,而是”做得到但很别扭”:为了实现一个条件跳转要绕三层封装,之后每次改需求都要重新绕一遍。这类成本是按月付的。
token 效率是真金白银的持续支出。同样的任务,编排开销大的方案每次多烧的 token 会随调用量线性放大。这块可以参考Agent 框架的 token 开销差多少:选型时容易忽略的一笔。
生态规模影响的是”遇到问题时有没有人踩过”。生态小的框架,你的每个问题都可能是第一次被提出来,排查时间不可预测。
一个具体的分水岭:带反馈环的循环任务上 LangGraph 胜出——CrewAI 技术上支持循环,但调试很痛苦。同时 LangGraph 对执行流的控制更精细,支持持久化的长时运行工作流与 human-in-the-loop,含 checkpointing、streaming、human-in-the-loop 这几类原语。如果你的流程里有”审核不通过要退回上一步重做”这种回边,这一条基本能定方向。
六、少借债的几个具体做法
前面讲的都是判断,这一节讲怎么在代码结构上留后路。
把工具层和编排层分开。 查数据库、调内部 API、解析文档这些工具函数,写成不依赖任何框架的普通函数,框架那边只做一层薄封装。这样将来换框架,工具层原封不动,只重写编排。这是这三个框架之间迁移时,唯一能大面积复用的部分。
提示词不要写进节点定义里。 单独放文件或配置,用变量引用。提示词是你调了很久才调好的资产,别让它跟框架的类结构绑死。
先写一个能跑的最小闭环,再考虑角色拆分。 很多团队一上来就设计五个角色的协作,实际跑起来发现三个角色纯属交接开销。少一个 agent,少一份状态传递的复杂度。相关思路见Agent SDK 还是多智能体框架。
把可观测性当成第一天的需求,不是上线前的补丁。 多 agent 系统出问题时,最费时间的是搞清楚”到底哪一步开始跑偏的”。如果日志里只有最终输出,排查基本靠猜。
选型结论落成文档,写清楚适用边界。 现成的判断路径大致是:有循环、有分支逻辑、需要生产级可观测性、多人协作、失败代价高,倾向 LangGraph;一天内要出可用原型、流程基本线性,倾向 CrewAI。不存在唯一最好的答案:CrewAI 的原型门槛最低,LangGraph 在生产环境上更经打。
七、协议层能不能帮你减债
有一个方向值得留意但不宜寄予过高期望:如果 agent 之间、agent 与工具之间通过标准协议通信,理论上换框架的成本会低一些。
目前的情况是:OpenAgents 声称自己是唯一原生同时支持 MCP 与 A2A 的框架(这是该项目自己的说法,本文未做独立核实);CrewAI 已加入 A2A 支持。协议层的生态还在演进,具体支持程度请以各项目官方文档当前版本为准。
务实的判断是:协议能降低”工具接入”这一层的重复劳动,这部分收益比较确定;但它降不掉”流程怎么编排”这层的迁移成本,因为编排逻辑本来就不在协议的管辖范围内。别指望上了协议就能随便换框架。想了解协议本身可以看A2A 协议入门。
八、诚实说局限
这篇有几处需要打折看待。
第一,前面引用的能力排序来自第三方实测对比,不同团队的测试场景、模型选择、代码写法都会影响结论,你自己的场景未必复现同样的排序。真要做决策,最好用你自己的典型任务跑一个小样本。
第二,本文没有涉及各框架的版本号和具体 API 签名,因为这些变化频繁,写死在文章里反而误导,请以官方文档当前版本为准。
第三,“技术债”这个说法本身有被滥用的风险。不是所有欠债都该马上还。一个已经稳定跑了一年、需求不再变化的存量系统,即使当初选型不理想,重写的收益也可能是负的。判断标准应该是”这块代码接下来还要不要频繁改”,而不是”它是不是符合当前的最佳实践”。
第四,本文对比的是这三个较常被提及的框架,市面上还有其他选项,没有覆盖不代表不值得考虑。
小结
多智能体框架的迁移成本主要不在模型调用层,而在编排逻辑——LangGraph 的图、CrewAI 的角色队伍、AutoGen 的对话,是三种互不通约的建模方式,换框架等于重新建模。选型前先问自己是不是真需要框架,单 agent 调一两个工具的场景用厂商 SDK 通常更快。AutoGen 已进入维护模式,存量项目不必恐慌迁移,但新项目起步时值得把这一点算进去。旧对比文章可能没覆盖 CrewAI 在 2025 年新增的 Flows,别用过期信息否决选项。最实在的减债动作只有一条:把工具层和提示词从框架里剥出来,让将来的迁移只需要重写编排那一小块。