90% 的 Agent 失败，不是框架不行，而是卡在 5 个工程问题

先说几个核心判断：大多数 Agent 的失败，根源不在于框架本身，而在于五个反复出现的工程问题。这篇文章会从演示环境一路拆解到生产环境，看看那些看似“换个框架就能解决”的 Bug ，到底卡在哪里。

核心内容：
1. Agent从演示到生产环境面临的核心工程挑战
2. 导致Agent失败的五大基础工程问题剖析
3. 针对工具调用等关键问题的解决思路

在过去一年里，但凡亲手修过 Agent 的 Bug ，应该都撞上过一堵名叫“工程复杂性”的墙。

AI Agent 社区有个很典型的叙事：先用 LangChain，发现太抽象；换成 CrewAI，发现协作链路不可控；再研究 LangGraph，开始手动画图，终于觉得找到了银弹——然后上线一周，凌晨三点被 PagerDuty 叫醒。

一位在 Agent 领域深耕了 18 个月的开发者 Mukunda Katta ，在 Dev.to 上发了一篇文章，标题直接戳中了很多人的痛点：大多数 Agent 的失败并不有趣，它们只是同样的 5 个问题，换了一套模型、换了一个框架、换了一周时间——但根因一模一样。

这篇文章之所以在开发者社区引发强烈共鸣，是因为它做了一件很罕见的事：不是在推框架，而是在拆问题。

为什么是现在： Agent 正在跨越 Demo 到 Production 的峡谷

2024 年是“Agent 能做什么”的秀场年。 2025 年是“Agent 框架哪家强”的选型年。而 2026 年上半年给出的信号很明确：这不再是一个框架问题，而是一个工程问题。

一个典型现象：几乎所有 Agent 框架的 Demo 跑起来都很顺。给 GPT-4 配上一个搜索工具，再加一个代码解释器，演示效果令人心动。可一旦接入自己的业务系统，Bug 就开始冒头——不是偶尔出错，而是一个接一个的连锁失败。

：Demo 里的 Agent 面对的是精心控制的环境和单一意图。而生产环境的 Agent 面对的是模糊意图、不可靠的下游服务、以及一个东西没处理好就影响全局的级联效应。

这可不是一个“换个更好的模型”就能解决的问题。当 Claude Opus 4.7 和 GPT-4.1 的能力已经碾压一年前， Agent 的失败率却并没有同等下降——问题不在推理引擎，而在工程底盘。

逐个击破： 5 个被框架掩盖的工程问题

Katta 把这些“换了马甲但本质相同”的问题归纳为五个类别。每一个都很基础，但恰恰因为没有得到基础层面的解决，它们在高层的框架中反复出现。

问题一：工具调用失败——Agent 最脆弱的环节

这可能是 Agent 失败的第一大来源。模型生成了正确的 JSON 、正确的函数名、正确的参数类型——但工具就是没跑通。原因可能是一百种里的任何一种：超时、网络抖动、 API 返回了意料之外的格式、权限过期、限流、参数语义正确但业务逻辑非法……

框架对这件事的处理通常极其粗粒度：要么重试 n 次，要么把错误信息原样丢回给 LLM ，寄希望于模型能“看懂”并纠正。但实际效果是——当第一个工具调用失败后， Agent 的后续行为往往越来越离谱。因为它拿到的错误信息对 LLM 来说并非结构化的工程信号，而是一段需要重新“理解”的自然语言。

，而在于：让工具的错误信号对 Agent 可编程。错误不只是给人类看的日志，它应该是 Agent 决策循环中可消费的结构化输入。这意味着你需要一个薄薄的错误抽象层——不是框架，而是工程契约。

问题二：上下文丢失——Agent 的“健忘症”

多轮对话中， Agent 需要在不断膨胀的消息历史中，记住最初的任务目标、中间的关键决策、以及已经尝试过什么。这不只是 token 限制的问题。

：上下文没有丢在 token 数量上，而是丢在了注意力分布上。当对话历史超过几千个 token ，模型开始倾向于关注最近的几轮交互，而忘记几十轮前的约束条件。 Agent 会说“好的我帮你查一下”，然后用一个和最初需求完全不同的参数去调工具。

Katta 的观点很尖锐：框架在上下文管理上做了太多“自动化”，反而剥夺了开发者对关键信息的控制力。

。这是信息架构问题，不是框架配置项。

问题三：循环死锁——Agent 在执行迷宫里打转

这个问题每个 Agent 开发者都经历过： Agent 卡住了，一直在做同一件事，每次都说“我再试试”，每次的结果都一样。

框架会给这种行为起好听的名字： ReAct 循环、 Self-Reflection 、多步推理。但当它退化成一个死循环时，再高级的命名也帮不了你。

，而是它的终止条件定义得太模糊。 Agent 不知道什么算“完成”，什么算“失败”，什么算“换一条路径”。框架通常只提供一个最大步数作为兜底，这无异于给一个没有刹车的车装了一个油量表——不在根因上解决问题。

工程上的解法是显式定义退出语义：不是 “最多 10 步”，而是 “如果连续 3 步没有获得新的信息增量，则终止当前分支并上报”。这是策略控制，是业务逻辑，不可能被塞进一个通用框架的统一循环里。

问题四：错误传播——级联效应如何放大一个小偏差

Agent 是多步骤的，而多步骤系统有一个铁律：

。

一个典型的级联场景：第一步工具调用的参数略有偏差→返回了部分正确但不完整的结果→Agent 基于不完整的结果做推理→推理结论偏了→第二步工具调用基于偏了的结论→彻底跑偏。这时候框架做了什么？什么都没做。因为从框架的视角看，每一步都“成功”了——没有抛异常，没有超时，所有返回都是格式正确的 JSON 。

：工具返回了结果，但结果在业务语义上是错的。框架的层次完全感知不到这种错误，只有业务层的工程校验才能捕获。

这意味着任何严肃的 Agent 系统，都必须在工具和推理之间插入业务校验层。这不属于框架的职责，但这是 Agent 能不能跑稳的决定性因素。

问题五：状态混乱——外部系统与 Agent 认知之间的裂缝

Agent 知道“订单已取消”——它从消息历史里读到了。但外部数据库里的订单状态是“待支付”。为什么？因为上一个步骤的写入操作失败了，但没有被正确感知。或者写入成功了，但 Agent 的上下文没有更新。

： Agent 维护了一个“信念状态”（ Belief State ），外部系统有它的“事实状态”（ Ground Truth ）。当两者不同步时， Agent 的每一步决策都是基于错误的信念。

解决思路不新鲜：外部系统的状态变化应该以结构化的方式同步回 Agent 的决策循环，而不是只存在于 LLM 的“记忆”里。但这又绕回了第一个问题——你不能指望框架来定义你的业务实体和状态同步协议。

框架不是敌人，但也不是答案

Katta 的主张非常明确：不需要复杂的框架。他的实践是用小型库逐个击破——工具调用用一个轻量库处理、上下文管理用另一个、循环控制自己写、错误传播靠工程纪律、状态同步用成熟的分布式模式。

这不是“反框架”，而是“框架归位”。

。至于 Agent 的行为边界、退出策略、错误契约、状态建模——这些是你的业务逻辑，框架不可能替你定义。

这也解释了为什么今年出现了一个看似矛盾的动向： Agent 框架在功能表上越来越强，但一线开发者的实际感受是——真正跑稳的 Agent ，自己手写的东西反而越来越多。不是在框架之上开发，而是在框架之外搭建。

方法论的转向：从“Agent 的智能上限”到“Agent 的工程下限”

过去两年，整个行业在追求“让 Agent 更聪明”。更长的上下文、更强的推理、更多的工具。但 2026 年上半年出现的信号是：

。

换句话说，一个 Agent 在理想环境下能做到 95 分，但在真实环境下只能稳定输出 65 分——而一个稳定 70 分的 Agent 比一个偶尔 95 分的 Agent 有商业价值得多。

这要求我们的关注点发生迁移：不再问“这个 Agent 能做什么”，开始问“这个 Agent 在什么条件下会做什么蠢事”。对五个工程问题的深入程度，直接决定了你的 Agent 在凌晨三点是安静运行还是在发告警。

工程下限的提升不需要框架换代，但需要思维切换——把 Agent 当作一个

来设计，而不是一个“聪明的函数调用”。

来源： Dev.to | 发布时间： 2026 年 5 月