关键要点
- MIT 许可证——库本身完全免费使用、修改和自托管,没有使用上限
- 由 LangChain Inc. 打造,此前作为 LangChain 内部的实验性智能体模块存在,于 2024 年 1 月首次以独立可安装包形式发布
- 核心仓库 langchain-ai/langgraph 已获得超过 41,000 个 GitHub 星标
- LangGraph 1.0 于 2025 年 10 月与 LangChain 1.0 一同正式发布(GA),双方共同承诺在 2.0 之前不会引入破坏性变更
- 核心思路:将智能体建模为图中的节点和边,并使用一个在每一步之间持续存在的共享状态对象
- 内置检查点功能(通过可插拔的检查点器,如内存保存器或数据库支持的检查点器)让图可以暂停、从任意点恢复,并在进程重启后恢复运行
- LangGraph 智能体的生产托管——2025 年之前以"LangGraph Platform"名义销售——现已作为 LangSmith Deployment 出售,是付费 LangSmith 套餐内按量计费的功能,而非拥有独立价目表的独立产品
📍 简单一句话
LangGraph 是由 LangChain Inc. 打造的免费、MIT 许可开源框架,将 AI 智能体建模为节点和边的图结构,具备显式状态、检查点和人工介入中断机制。
💬 简单来说
不同于将智能体写成一个调用模型并寄望结果良好的单一循环,LangGraph 让你把智能体画成流程图——每一步是一个节点,步骤之间每一条可能的路径是一条边,智能体当前的进度是一个状态对象,每一步后都会保存,因此它可以暂停、恢复,或在崩溃后恢复运行。
📌注: LangGraph 是一个需要编写代码调用的库,而不是可下载的应用程序——开源框架本身没有需要安装的图形界面(LangGraph Studio 是一个独立的可视化调试工具,为可选项)。本评测将开源 LangGraph 库及其付费生产部署选项一并覆盖,因为 LangChain Inc. 将两者作为一套相连的产品栈来构建和销售。
LangGraph 由谁打造,又是如何成为独立产品的?
LangChain Inc. 最初将 LangGraph 作为 LangChain 的扩展来开发,用于满足简单循环无法提供的可靠性需求,之后将其拆分为独立的可安装包。 早期的 LangChain 智能体抽象(2024 年之前的"agent executor"模式)以固定循环运行,对中间步骤的控制有限,因此难以加入重试、暂停等待人工决策,或在崩溃后干净地恢复。LangGraph 借鉴了 Google Pregel 和 Apache Beam 中关于状态如何在计算步骤间流转的思路,将智能体显式建模为一个图,从而解决了这一问题。
LangGraph 于 2024 年 1 月作为独立的 Python 包发布,与核心 langchain 包分离,使团队无需依赖 LangChain 框架的其余部分即可采用这一基于图结构的运行时。此后 LangChain Inc. 围绕它打造了一款托管部署产品:2024 年年中推出了名为 LangGraph Cloud 的测试版,于 2025 年 5 月以 LangGraph Platform 的名义正式发布(GA)。2025 年 10 月,伴随着 LangChain 1.0 和 LangGraph 1.0 的正式发布,该托管产品被并入 LangSmith 产品系列,如今作为 LangSmith Deployment 出售,而不再是一个独立命名的平台。
LangChain 内部的实验性模块
- 日期:
- 2023
- 意味着什么:
- 为应对固定 agent-executor 循环的局限,基于图结构的智能体早期构想已存在于 LangChain 代码库中
LangGraph 成为独立包
- 日期:
- 2024-01
- 意味着什么:
- LangGraph 作为独立于核心包 langchain 的可安装 Python 包发布
LangGraph Cloud(测试版)
- 日期:
- 2024-06
- 意味着什么:
- LangGraph 智能体首个托管部署方案,处于测试阶段
LangGraph Platform(正式版)
- 日期:
- 2025-05
- 意味着什么:
- 托管部署产品以 LangGraph Platform 之名正式发布(GA)
LangGraph 1.0
- 日期:
- 2025-10
- 意味着什么:
- 与 LangChain 1.0 同步正式发布;公开承诺在 2.0 之前不引入破坏性变更
并入 LangSmith Deployment
- 日期:
- 2025-10
- 意味着什么:
- 托管部署被重新以按量计费的 LangSmith 功能形式出售,而非独立命名的平台
📌注: 开源 LangGraph 库的 MIT 许可证不受这一定位调整的影响——发生变化的只是托管部署产品的名称和定价结构,通过 pip install 获取的库本身的免费状态并未改变。
LangGraph 是什么?
LangGraph 是一个开源库(MIT 许可证,github.com/langchain-ai/langgraph),用于将智能体构建为有状态的图,支持 Python 和 JavaScript/TypeScript(以 LangGraph.js 的形式提供)。与线性的调用链不同,用 LangGraph 构建的智能体是一个有向图:节点是工作单元(一次模型调用、一次工具调用、一段业务逻辑),边则决定接下来运行哪个节点——包括根据当前状态分支的条件边,以及让智能体回退以重试或重新规划的循环。
- 状态:一个所有节点都会读取和写入的单一类型化对象(通常是 Python 的
TypedDict),使整个图对到目前为止发生的事情拥有单一的事实来源 - 节点与边:节点是接收当前状态并返回状态更新的普通函数;边(包括条件边)根据该状态决定下一个执行的节点
- 检查点与持久化:可插拔的检查点器(开发阶段用内存保存器,生产环境用 Postgres 等数据库支持的检查点器)在每一步之后保存图的状态,并与线程 ID 绑定,使运行可以准确地从中断处暂停和恢复
- 人工介入:
interrupt()函数会在节点内部暂停执行,并将控制权返回给调用代码;使用Command(resume=...)恢复后,同一次图运行会从那个精确点继续——这就是 LangGraph 在不丢失状态的情况下实现审批步骤的方式 - 多智能体与分层图:由于一个节点本身可以调用一个已编译的子图,LangGraph 可以用相同的基础组件支持单智能体、多智能体和分层(主管加工作者)架构
- LangGraph Studio:一个用于检查和逐步跟踪运行中的图的可选可视化工具,独立于核心库
from typing_extensions import TypedDict
from langgraph.graph import StateGraph, START, END
from langgraph.checkpoint.memory import MemorySaver
class State(TypedDict):
topic: str
draft: str
def write_draft(state: State) -> dict:
return {"draft": f"Draft about {state['topic']}"}
def review_draft(state: State) -> dict:
return {"draft": state["draft"] + " (reviewed)"}
builder = StateGraph(State)
builder.add_node("write", write_draft)
builder.add_node("review", review_draft)
builder.add_edge(START, "write")
builder.add_edge("write", "review")
builder.add_edge("review", END)
graph = builder.compile(checkpointer=MemorySaver())
result = graph.invoke(
{"topic": "local LLMs"},
config={"configurable": {"thread_id": "1"}},
)
print(result["draft"])LangGraph 收费多少?
LangGraph 库本身在 MIT 许可证下完全免费——LangGraph 智能体的生产托管才是按量计费的付费附加项。 无论是自托管、商业使用还是修改,LangChain Inc. 都不对开源库收费;其部署方面的收入来自 LangSmith 套餐,与PromptQuorum 的 LangChain 评测中提到的另一档独立的 LangSmith 可观测性/追踪功能,来自同一家公司的产品体系。
- LangGraph(库本身):在 MIT 许可证下永久免费,支持 Python 和 JavaScript/TypeScript,可自托管或嵌入任意应用
- 自托管自己的智能体:可以在自己的服务器上使用自己的检查点器(例如 Postgres)运行已编译的 LangGraph 图,对 LangChain Inc. 而言零成本——自主管理的生产使用没有许可费
- LangSmith Developer 档:每座席每月 0 美元,1 个座席,每月最多 5,000 条基础追踪记录,之后按用量付费——不包含托管部署
- LangSmith Plus 档:每座席每月 39 美元,座席数不限,每月最多包含 10,000 条基础追踪记录,并包含 1 个免费的小型无服务器 LangGraph 部署,以及对按量计费的 Deployment、Engine 等相关基础设施的访问权限
- LangSmith Enterprise:定制报价,增加自托管/混合部署选项及定制 SLA
- 超出包含额度的部署用量与追踪用量分开计费:算力以 LCU 计费(1 LCU = 1.50 美元),数据库用量以 LSU 计费(1 LSU = 1.00 美元),按 vCPU 小时和 GiB 小时计算
- 2025 年之前以"LangGraph Platform"名义销售的产品,如今按 LangSmith Deployment 计费——已不存在独立的 LangGraph Platform 价目表用于预算规划;它是 LangSmith 套餐内的一个计费项
档位 | 价格 | 最适合 |
|---|---|---|
| LangGraph 库 | 免费(MIT 许可证) | 所有人——自托管,零成本 |
| LangSmith Developer | $0/座席/月,5K 条追踪 | 个人开发者、原型验证 |
| LangSmith Plus | $39/座席/月,+按量计费 | 需要托管的团队 |
| LangSmith Enterprise | 定制报价 | 自托管/混合、合规需求 |
价格已根据 LangChain 官方定价页面于 2026 年 9 月核实,全球统一以美元计费——该页面未显示分地区定价,因此在制定预算前请查看最新页面,因为 SaaS 档位和计费费率可能在没有太多提前通知的情况下发生变化。
如何安装并开始使用 LangGraph?
安装 LangGraph 只需一条 pip 或 npm 命令——开源库本身不需要账户、许可密钥或服务器。 通过 LangSmith 进行的托管部署是可选的,只有在你想为他人托管一个智能体时才需要。
- 1安装软件包:
pip install -U langgraph(Python)或npm install @langchain/langgraph(JavaScript/TypeScript)。 - 2将你的模型提供商 API 密钥设置为环境变量(例如
OPENAI_API_KEY)——LangGraph 本身不提供或代理模型访问;你在节点内部调用所选模型。 - 3定义一个状态模式(如
TypedDict或类似结构),据此构建一个StateGraph,用add_node注册节点,并用add_edge或条件边将它们连接起来。 - 4使用
.compile()编译图,并传入checkpointer(开发阶段用内存版的MemorySaver,生产环境用数据库支持的检查点器),使状态在各步骤及进程重启后依然保留。 - 5在需要人工决策才能继续的节点内使用
interrupt(),并通过在同一线程 ID 上调用Command(resume=...)来恢复暂停的运行。 - 6阅读官方 LangGraph 文档并浏览 GitHub 仓库以获取最新 API 参考和 JavaScript/TypeScript 快速上手指南。
- 7可选地部署到 LangSmith Deployment,或在需要生产托管而非本地运行时,将已编译的图自托管在自己的 API 服务器背后。
使用 LangGraph 需要 LangChain Inc. 账户吗?
不需要。LangGraph 库无需任何账户即可安装和运行,你只需自行提供模型提供商的 API 密钥。只有在选择使用 LangSmith 进行追踪或托管部署时才需要账户。
安装 LangGraph 需要依赖 LangChain 吗?
不需要。LangGraph 作为独立软件包发布,可以在不安装核心 langchain 包的情况下安装和使用,不过许多团队会将 LangChain 的 create_agent 抽象(其本身运行于 LangGraph 之上)作为更高层次的入门起点。
谁适合使用 LangGraph?
LangGraph 适合构建生产级智能体、需要对状态、重试或人工审批进行显式控制的团队——并非每个智能体都需要图结构。 对于没有分支或持久化需求的简单线性工具调用智能体来说,它就不太合适。
什么情况下不应该使用 LangGraph?
对于没有重试、分支或跨暂停持久化状态需求的简单线性工作流,应避免使用 LangGraph——图结构抽象会增加直线式脚本本不需要的开销。 以下是几种由其他工具更合适的具体情形。
- 一个总是运行同一固定步骤序列一次并返回结果的工作流——简单的函数调用链,或 LangChain 的
create_agent,用更少的代码就能覆盖这一需求 - 团队想要的是基于角色的思维模型——拥有人设、目标和委派子任务的具名智能体——而不是以显式节点和边的方式思考;CrewAI 正是围绕这种抽象设计的
- 团队尚未投入 LangChain 生态系统,希望依赖足迹尽可能小,并且乐于手动管理状态和重试
- 项目的主要需求是多智能体对话模式(智能体在聊天循环中相互辩论或评审彼此的输出),而不是显式的控制流图——AutoGen 正是围绕这种模式构建的
- 当工作流确实存在循环、条件分支、需要暂停等待人工输入,或必须在任务中途挺过重启时,应改用 LangGraph
LangGraph 与替代方案对比
LangGraph 与其他智能体编排框架相互竞争,每个框架都围绕智能体应如何构建这一问题采用了不同的思维模型。
工具 | 思维模型 | 许可证 | 背后支持 | 最适合 |
|---|---|---|---|---|
| LangGraph | 显式状态图 | MIT | LangChain Inc.(风投支持) | 有状态的生产级智能体 |
| LangChain | Chains + create_agent | MIT | LangChain Inc.(风投支持) | 通用型 LLM 应用 |
| CrewAI | 基于角色的智能体团队 | MIT | CrewAI Inc.(风投支持) | 具名角色的多智能体团队 |
| AutoGen | 多智能体对话 | MIT / CC-BY | Microsoft Research | 聊天循环式智能体模式 |
| Semantic Kernel | 插件 + 规划器 | MIT | Microsoft | 以 .NET 为先的企业应用 |
评估 LangGraph 时的常见误区
这些误区源于将 LangGraph 与 LangChain 或 LangGraph Platform 混为一谈,或者在更简单的工具就能胜任的场合使用了图结构。
常见问题
LangGraph 免费使用吗?
是的。LangGraph 库在 MIT 许可证下开源,可免费用于任何用途,包括商业产品,没有使用限制,也无需支付许可费即可在生产环境中自托管自己的智能体。
LangGraph 是谁开发的?
LangGraph 由 LangChain Inc. 开发,这是由 Harrison Chase 创立的、LangChain 背后的风险投资支持公司。它最初是 LangChain 内部的一个实验性智能体模块,于 2024 年 1 月以独立软件包形式发布。
LangGraph 和 LangChain 有什么区别?
LangChain 提供用于链条、提示词以及更高层 create_agent 抽象的通用框架。LangGraph 是 create_agent 本身运行于其上的、更底层的图结构运行时——当你需要 create_agent 未提供的显式状态、循环或人工介入控制时,可以直接使用 LangGraph。
LangGraph Platform 后来怎么样了?
LangGraph Platform 曾是 LangChain Inc. 托管智能体部署产品的名称,自 2025 年 5 月正式发布起使用,直到 2025 年 10 月。此后它被并入 LangSmith 产品系列,如今作为 LangSmith Deployment 出售,是付费 LangSmith 套餐中的按量计费功能,而不再是拥有独立价目表的独立品牌平台。
在生产环境中托管一个 LangGraph 智能体要花多少钱?
LangSmith Plus 档(每座席每月 39 美元)包含一个免费的小型无服务器部署;超出部分单独计费,算力以 LCU 计价(1 LCU = 1.50 美元),数据库用量以 LSU 计价(1 LSU = 1.00 美元),按 vCPU 小时和 GiB 小时结算。Enterprise 定价为定制报价。
可以自托管 LangGraph 智能体而不为托管部署付费吗?
可以。由于 LangGraph 采用 MIT 许可证,你可以编译一个图,选择自己的检查点器(例如自行管理的 Postgres 数据库),并在自己的 API 服务器或基础设施背后运行,无需支付任何许可费用——通过 LangSmith 进行托管部署只是一种可选的便利方式,并非必需。
LangGraph 中的检查点器是什么?
检查点器是一个可插拔组件,会在每一步之后保存图的状态,并与线程 ID 绑定。开发和测试阶段常用内存版 MemorySaver;生产部署通常使用数据库支持的检查点器,以便运行能够在进程重启后恢复。
LangGraph 中的人工介入是如何工作的?
在节点内部调用 interrupt() 会在该处暂停图的执行,并将控制权返回给调用代码,此时状态已经被检查点保存。在同一线程 ID 上调用 Command(resume=...) 恢复后,运行会从暂停的确切位置继续。
LangGraph 有多少 GitHub 星标?
核心仓库 langchain-ai/langgraph 已获得超过 41,000 个 GitHub 星标——少于核心 LangChain 仓库(超过 140,000 个),这反映出 LangGraph 是一个更专业、更底层的库,而非通用型框架。
在多智能体系统方面,LangGraph 比 CrewAI 更好吗?
两者并非绝对孰优孰劣——它们对多智能体系统的建模方式不同。LangGraph 提供一个逐节点控制的显式状态图,适合需要精细控制或人工审批步骤的团队。CrewAI 提供一种基于角色的抽象(拥有目标和委派任务的具名智能体),对于愿意接受较少底层控制的团队来说,搭建速度更快。
