LangGraph、CrewAI还是直接调用API:2026年如何选择智能体框架
高级11 分钟阅读自动化

LangGraph、CrewAI还是直接调用API:2026年如何选择智能体框架

2026年的智能体框架生态比以往成熟,却依然没有明确的统一选择。LangGraph、CrewAI、Pydantic AI、OpenAI Agents SDK和直接调用API各自适合一部分团队和项目,但没有一种方案适用于所有情况。本文将如实比较这些方案,并提供一套决策框架。

您应该能够做到的事情

不存在放之四海而皆准的最佳智能体框架。复杂状态机适合LangGraph,多智能体角色协作适合CrewAI;OpenAI/Anthropic SDK适合希望紧贴单一供应商、保持简单的团队;Pydantic AI主打类型安全;直接调用API则提供最大的控制力。正确的选择取决于你的具体项目,而且许多成熟团队确实会在生产环境中直接调用API。

AI Expert Team发布日期: 2026年5月15日
仅在此浏览器中保存。
本文内容

2026年的智能体框架生态比两年前成熟了不少,却依然没有变得更容易选择。LangChain/LangGraph仍占据主导地位,但受到的质疑也越来越多。CrewAI已经找到了自己的细分市场。Pydantic AI凭借类型安全赢得了一批拥趸。OpenAI Agents SDK和Anthropic Claude SDK也在不断发展。与此同时,一些团队正悄然回归直接调用API,尤其是在生产环境中。

每个框架都有支持者,也都有批评者。争论声量很大,而最终决策往往更多取决于个人偏好,而非客观标准。

本文从一线架构师的视角拨开噪声,说明各框架实际解决什么问题、分别适合哪些场景,以及我们在生产环境中观察到的真实做法。不做阵营之争,只谈取舍。

智能体框架有什么用

在开始比较之前,先明确我们究竟在选择什么。一个“智能体框架”通常会提供:

  1. 定义智能体的方式——智能体扮演什么角色、可以使用哪些工具、应当遵循什么行为方式。
  2. 执行循环——调用LLM、解析输出、决定下一步、调用工具,然后重复这一过程。
  3. 状态管理——智能体记住哪些信息,以及如何组织这些信息。
  4. 工具集成——如何定义工具并将其提供给智能体。
  5. 编排能力——让多个智能体协作,处理分支工作流和重试。
  6. 可观测性接口——支持追踪、日志和调试。
  7. 便捷工具——提示词模板、常用模式和辅助函数。

不同框架对这些能力的侧重点各不相同。有些着重于编排,有些专注于智能体定义,还有些只在模型API之上提供一层很薄的封装。

框架生态概览

LangChain / LangGraph

这是其中体量最大的一套方案。LangChain最初只是一个用来串联LLM调用的Python库,后来成为许多AI项目事实上的框架。LangGraph则是构建在其之上的智能体专用框架。

擅长之处:

  • 用LangGraph构建状态机。 它的图模型以节点表示步骤、以边表示转换,并在节点间传递状态,非常适合复杂的智能体工作流。
  • 生态丰富。 提供大量向量数据库、模型供应商、工具和可观测性集成。
  • 通过LangSmith实现可观测性。 追踪与调试界面已经相当成熟。
  • 采用广泛。 示例多、文档多,熟悉它的开发者也多。

不足之处:

  • 抽象成本。 LangChain尤其如此:抽象层很多,调试更加困难,也需要花力气才能弄清底层究竟发生了什么。
  • API变动频繁。 经常出现破坏性变更,12个月前的代码往往已经需要更新。
  • 性能开销。 多层间接封装会增加延迟和token消耗。
  • 学习曲线。 真正熟练掌握通常需要数周时间。

适合选择的情况:

  • 智能体工作流复杂,存在状态分支。
  • 团队能从标准框架中受益,例如工程师较多,需要统一通用模式。
  • 希望使用LangSmith的可观测性能力。

适合跳过的情况:

  • 简单聊天机器人或单智能体循环,直接调用API更简单。
  • 团队过去已经深受LangChain频繁变更之苦。
  • 项目对每一毫秒的延迟都很敏感。

CrewAI

CrewAI是一个专注于角色型智能体的多智能体框架。每个智能体都有自己的角色、目标和背景设定,并相互协作完成任务。

擅长之处:

  • 多智能体编排。 原生支持智能体彼此沟通、委派任务和协同工作。
  • 基于角色的思维模型。 很容易理解,例如“研究员智能体负责X,写作智能体负责Y”。
  • 处理多智能体场景时比LangGraph简单。 可以更快上手。
  • 社区活跃。

不足之处:

  • 单智能体能力挖掘有限。 如果任务只需要一个复杂智能体,CrewAI的抽象会显得不合适。
  • 性能。 多智能体配置会成倍增加LLM调用,成本和延迟也会迅速上升。
  • 成熟度仍有差距。 它比LangChain年轻,仍有一些不够完善的地方。
  • 设计取向鲜明。 灵活性不如更直接的框架。

适合选择的情况:

  • 多智能体工作流确实需要区分角色。
  • 适合采用“团队”模式,即一组智能体共同完成工作。
  • 希望快速验证多智能体构想。

适合跳过的情况:

  • 单智能体任务,使用它会过于复杂。
  • 对性能敏感的生产环境,因为多智能体成本很高。
  • 所谓“智能体协作”只是形式大于实质。

Pydantic AI

这是一个较新的框架,重点关注类型安全和开发体验。

擅长之处:

  • 强类型。 全面采用Pydantic,输入和输出均有类型定义,可以在开发阶段发现错误。
  • API简洁。 抽象层少于LangChain,更接近模型API。
  • 现代Python风格。 支持异步、类型提示和Pydantic v2。
  • 不绑定特定模型。 兼容大多数供应商。

不足之处:

  • 生态规模较小。 集成数量少于LangChain。
  • 大规模应用验证较少。 框架较新,生产实践仍在形成。
  • 编排工具较少。 面对复杂工作流时,功能不如LangGraph丰富。

适合选择的情况:

  • 重视类型安全的Python团队。
  • 单智能体或简单的多智能体配置。
  • 偏好少量抽象的团队。

适合跳过的情况:

  • 编排极其复杂,LangGraph可能更合适。
  • 非Python项目,因为它只支持Python。
  • 需要庞大的预置集成生态。

OpenAI Agents SDK

这是OpenAI官方的智能体框架,针对OpenAI模型进行了优化。

擅长之处:

  • 针对OpenAI优化。 专门面向GPT-5/o3的使用模式设计。
  • API简单。 抽象程度低于LangChain。
  • 内置智能体移交。 将任务移交给其他智能体是一等能力。
  • 追踪能力成熟。 内置可观测性,并与OpenAI控制台集成。

不足之处:

  • 锁定OpenAI。 它围绕OpenAI模型设计,接入其他供应商并不顺手。
  • 灵活性较低。 有些模式在通用框架中更容易实现。
  • 比LangChain新。 社区规模较小。

适合选择的情况:

  • 全面采用OpenAI模型。
  • 希望走一条由供应商官方支持的路线。
  • 智能体复杂度为简单到中等。

适合跳过的情况:

  • 采用多供应商策略,此时更适合通用框架或直接调用API。
  • 主要使用Anthropic或Google。

Anthropic Claude SDK

与前者类似,这是Anthropic为使用Claude构建智能体提供的方案。

擅长之处:

  • 针对Claude优化。 尤其适合Claude的扩展思考、计算机操作和MCP集成。
  • 符合Claude模型的惯用方式。
  • MCP支持强大。

不足之处:

  • 锁定Claude。 取舍与OpenAI Agents SDK相同。

适合选择的情况:

  • 全面采用Claude。
  • 大量使用Claude特有的功能。

适合跳过的情况:

  • 采用多供应商策略。

直接调用API

完全不用框架,直接调用OpenAI、Anthropic或Gemini API,并自行编写执行循环。

擅长之处:

  • 完全控制。 系统的每个方面都由你掌控。
  • 没有抽象成本。 看到的代码就是实际运行的代码。
  • 容易调试。 无须穿透层层封装。
  • 容易优化。 没有框架开销。
  • 不受框架版本变动影响。 何时升级由你决定。

不足之处:

  • 代码更多。 原本由框架处理的模式,需要你自己实现。
  • 重复造轮子。 常见模式会在不同项目中反复实现。
  • 标准化程度较低。 不同团队会以不同方式构建相似系统。

适合选择的情况:

  • 成熟团队交付生产系统,并且可靠性比开发便利性更重要。
  • 用例单一明确,不需要框架提供的灵活性。
  • 性能关键路径。
  • 已经用框架做过原型并掌握相关模式。

适合跳过的情况:

  • 项目处于从零探索“该构建什么”的阶段,此时框架有助于发现模式。
  • 团队工程能力有限。

LlamaIndex

LlamaIndex最初是一个以RAG为重点的库,后来逐步扩展到更广泛的智能体领域。

擅长之处:

  • 重度依赖RAG的系统。 对于以检索为核心的智能体,它属于业界领先方案。
  • 数据连接器。 提供大量数据源集成。
  • 成熟的检索抽象。

不足之处:

  • 智能体抽象相对较弱。 更适合RAG,而非通用智能体。
  • 与LangChain生态存在一些重叠。

适合选择的情况:

  • 高度侧重检索或RAG。
  • 需要连接多种数据源。

适合跳过的情况:

  • 与RAG无关的智能体工作。

Microsoft Autogen、Semantic Kernel

这是Microsoft提供的两套方案:Autogen面向多智能体,Semantic Kernel面向通用AI应用。

擅长之处:

  • Microsoft生态集成。 与Azure、.NET和Microsoft 365配合良好。
  • Semantic Kernel: 相比其他方案更偏企业级。
  • Autogen: 擅长多智能体研究。

不足之处:

  • 在以Microsoft技术为主的组织之外,社区规模较小。
  • 发展势头不如LangChain/LangGraph。

适合选择的情况:

  • 主要采用Microsoft技术栈的团队。
  • 深度集成Azure。

需要考虑的维度

选择框架不是选出一个赢家,而是让各种取舍与项目相匹配。

维度1:编排复杂度

你的智能体工作流有多复杂?

  • 简单(聊天机器人、单智能体、线性流程): 直接调用API或Pydantic AI。
  • 中等(单智能体、分支逻辑): Pydantic AI、LangGraph或直接调用API。
  • 复杂(多个智能体、状态机、重试): LangGraph、CrewAI或自定义方案。
  • 非常复杂(大型状态机、并行智能体、复杂路由): LangGraph或自定义方案。

维度2:生产成熟度

你更看重可靠性,还是实验速度?

  • 实验或原型阶段: 任何框架都能帮助你快速推进。
  • 面向客户的生产系统: 优先选择已有充分实践的方案。LangChain的成熟模式最多,直接调用API的控制力最强。
  • 关键任务型生产系统: 直接调用API往往更占优势,因为每一行代码都在你的掌控之中。

维度3:团队规模与技能

  • 小型团队(1–3名工程师): 框架负担越小越好,可选择直接调用API或简单框架。
  • 中型团队(5–15名工程师): 框架有助于统一规范,可选择LangChain或Pydantic AI。
  • 大型团队(20人以上): 需要借助框架统一共享模式,可选择LangGraph或内部框架。

维度4:供应商策略

  • 多供应商: 选择通用框架(LangChain、Pydantic AI)或直接调用API。
  • 单一供应商: 选择供应商SDK(OpenAI Agents SDK、Anthropic Claude SDK)。

维度5:性能敏感度

  • 延迟敏感(实时用户体验): 直接调用API,因为框架会增加延迟。
  • 成本敏感(高调用量): 直接调用API,因为框架可能增加token消耗。
  • 常规要求: 任何框架都可以。

维度6:可观测性需求

  • 需要强大的开箱即用能力: LangChain + LangSmith。
  • 自行构建: 任意框架 + 自建可观测性层。

转向直接调用API的趋势

2026年,我们越来越多地看到一种模式:成熟团队从框架迁移到直接调用API来运行生产系统。

原因包括:

  • 从事智能体开发1–2年后,团队已经掌握了相关模式,框架原本用于传授模式的价值也随之降低。
  • 框架会变,直接API相对稳定。生产稳定性往往更青睐后者。
  • 性能方面,框架会增加开销,直接调用API则没有这层负担。
  • 可调试性方面,出现故障时,直接调用API更容易看清“究竟发生了什么”。
  • 定制方面,每个生产系统都有独特要求。框架往往不易深度定制,而直接调用API可以充分适配。

这并不是在否定框架。框架很适合学习、制作原型和构建中等复杂度的生产系统。但对于成熟的生产系统,直接调用API往往是更好的选择。

常见的迁移路径是:

  1. 从LangChain或类似框架开始。
  2. 构建初始版本。
  3. 掌握常用模式。
  4. 发现阻力点,例如调试、性能和定制问题。
  5. 将热点路径迁移为直接调用API。
  6. 最终,大部分生产代码都改为直接调用API。

这不代表框架失败,而是某些团队使用框架时自然会经历的生命周期。

一套实用的决策框架

如果你正在为新项目选择方案:

第1步:明确项目情况。

  • 智能体有多复杂?
  • 有多少名工程师参与?
  • 是生产系统还是原型?
  • 使用单一供应商还是多个供应商?

第2步:应用经验法则。

场景推荐方案
原型,复杂编排LangGraph
原型,多智能体CrewAI
生产环境,简单智能体直接调用API或Pydantic AI
生产环境,复杂编排LangGraph或自定义方案
单一供应商(OpenAI / Anthropic)供应商SDK
重视类型安全的Python团队Pydantic AI
重度依赖RAGLlamaIndex + 你选择的智能体方案
主要采用Microsoft技术栈Semantic Kernel / Autogen

第3步:先做原型,再评估。

用一周时间试用选定的框架,构建一个有代表性的功能切片,然后评估:

  • 它是否符合你的使用模式?
  • 你是在借助框架推进工作,还是一直在与框架较劲?
  • 调试是否可控?
  • 性能是否可以接受?

如果答案是肯定的,就继续使用;如果不是,就尝试其他框架或直接调用API。

第4步:避免不可逆的锁定。

即使使用框架,也要让代码结构保留更换框架的可能性。把框架相关代码隔离在薄薄的一层中,将业务逻辑写成与框架无关的代码。

可跨框架复用的模式

无论选择什么框架,以下模式都普遍适用:

关注点分离。 将提示词管理、智能体逻辑、工具定义和执行循环彼此分开。每个框架只能帮你处理其中一部分,其余部分仍需自行完成。

可观测性。 追踪每一次LLM调用和每一次工具调用,并汇总指标。无论选择什么框架,这都是你的责任。

步骤预算与退出机制。 每个生产级智能体都需要这些机制。框架不会替你强制执行,必须自行添加。

评估套件。 框架通常不包含严谨的评估工具,需要另行构建,例如使用Promptfoo、Braintrust或自定义方案。

生产加固。 限流、幂等性、错误处理和回退机制。框架会提供部分基础能力,其余部分仍要由你完成。

只要重视这些通用模式,具体选择哪一个框架就没那么重要,团队的工程纪律反而更关键。

各框架结论

在使用过其中许多框架后,我们给出以下带有明确倾向的判断:

LangChain/LangGraph: 功能强大,但较为笨重。值得学习;在生产环境中,热点路径往往最终会迁出这一框架。

CrewAI: 很适合尝试多智能体构想。但在生产中,多智能体范式经常被用在原本不需要它的任务上,应有选择地使用。

Pydantic AI: 被低估了。类型安全会持续带来回报,值得一试。

OpenAI Agents SDK / Anthropic Claude SDK: 如果你已决定长期采用对应供应商,它们会很好用;否则需要考虑供应商锁定风险。

LlamaIndex: 在重度RAG场景中依然是佼佼者,但用于通用智能体时吸引力较弱。

直接调用API: 这是成熟团队常走的一步。不一定要从这里起步,但生产关键代码很可能最终会走到这里。

Microsoft Autogen / Semantic Kernel: 适合Microsoft生态,离开这个生态后吸引力较弱。

一段迁移历程

下面用一个真实的发展过程具体说明:

第1–3个月: 团队使用LangChain构建第一批AI功能。交付速度很快,也学到了许多模式。

第4–6个月: 可观测性、评估和性能等生产级要求开始出现,团队在LangChain之上补齐这些能力。

第7–9个月: LangChain的部分抽象开始造成阻力,团队着手用自己的接口封装LangChain。

第10–12个月: 一次LangChain版本升级破坏了多个系统,团队改用直接API重写热点路径,冷门路径则继续保留在LangChain中。

第2年: 大部分生产代码都改为直接调用API。LangChain偶尔用于原型开发。团队基于直接API构建的内部“智能体框架”成为标准方案。

这只是一条可行路径,其他路径同样有效。有些团队一直愉快地使用LangChain,也有些团队从第一天起就完全跳过它。

换个角度:你真正选择的是什么

选择框架的背后,其实也是在选择:

  • 一个可供学习的社区。
  • 一种你愿意承受的API变动速度。
  • 一套需要统一采用的模式。
  • 一种调试体验。
  • 一套可观测性方案。
  • 未来的迁移成本。

框架只是这些因素的一种具体体现,但真正影响团队日常工作的正是这些因素。

能够契合你所在的社区、对变更的承受能力、常用模式、调试方式和可观测性需求的框架,才是正确选择。如果这些方面并不匹配,再流行的框架也不适合你。

要点总结

2026年并不存在通用的最佳智能体框架。正确选择取决于项目复杂度、团队规模、生产成熟度、供应商策略和团队偏好。

一套可行的方法是:

  • 按照上述经验法则,让框架与项目要求相匹配。
  • 正式投入前先构建原型。
  • 调整代码结构,为日后更换框架保留空间。
  • 无论使用什么框架,都要重视通用模式。
  • 做好持续演进的准备:现在合适的方案,12个月后可能不再合适。

许多成熟团队最终会在生产关键代码中直接调用API。框架仍适合制作原型、学习和处理中等复杂度的编排。选择框架不是阵营之争,而要结合具体情境。

选择今天最合适的方案;等它不再合适时,再作调整。你构建的系统,比用来构建它的框架更重要。

继续阅读

通过下一篇文章继续沿着相同的学习路径进行学习。

深入学习

精选的外部课程,帮助您更深入地了解该主题。

查看所有 自动化 课程