AI产品库
LangGraph Logo

品牌档案

LangGraph

用图编排长时间运行的有状态智能体

官方把它定义为「用于构建有状态智能体的低层编排框架」:为任何长时间运行、带状态的工作流或智能体提供底层支撑设施,包括持久化执行、人在环路、完整记忆与生产部署能力,可独立使用也可与 LangChain 生态组合。

深度介绍

LangGraph详细介绍

🧭

低层编排框架:把控制权留给开发者

官方对定位的表述很明确——「低层编排框架」,也就是说它不提供开箱即用的成品智能体,而是提供搭建这类系统所需的基础设施:状态如何传递、节点如何跳转、失败如何恢复。相比把提示词与工具塞进一个黑盒,这种做法的好处是流程完全可控、每一步都可观测;代价是需要自己设计图结构、状态模型与终止条件。官方也说明它可以脱离 LangChain 单独使用,若已经在用 LangChain 组件则可以直接组合。

🔁

持久化执行与故障恢复

官方列出的第一项能力是持久化执行:智能体在运行中会保存状态,遇到失败或中断后能从断点继续,而不是从头再来。对长时间运行的任务(例如需要多轮检索与多步工具调用的研究流程),这一点直接决定可用性——否则一次网络抖动就要重跑整个流程,既费钱又耗时。实现上它依赖检查点存储,官方提供内存与数据库等多种后端。生产环境需要注意的是检查点本身的写入开销与数据保留策略,高频状态下要评估存储成本。

🧑‍💻

人在环路:随时检视与修改状态

第二项是人在环路:可以在执行过程中的任意点中断流程、查看并修改智能体状态,再决定是否继续。这适合需要审批的业务流(例如对外发送内容、执行变更类操作),也是把智能体从 Demo 推向生产的关键机制之一。设计时建议把「需要人工确认」的判定条件写成显式规则而不是交给模型判断,并明确超时与默认动作;否则流程可能卡在等待审批上,反而降低可用性。

🧠

两层记忆:工作记忆与跨会话长期记忆

官方强调「完整记忆」包含两层:面向当前推理过程的短期工作记忆,以及跨会话保留的长期持久记忆。前者决定一次任务里模型能看到多少上下文,后者决定助手是否记得使用者的偏好与历史。工程上这两层的取舍不同:短期记忆主要受上下文窗口与成本约束,需要摘要或裁剪策略;长期记忆则涉及存什么、怎么检索、何时遗忘,官方文档设有专门章节说明实现方式。

🐞

用 LangSmith 看执行路径与做评测

官方把与 LangSmith 的配合列为能力之一:可视化工具可以追踪执行路径、捕获状态转移并给出运行时指标,便于定位「哪一步开始跑偏」。对智能体而言,这类观测尤其重要,因为同一段提示词在不同轮次可能走完全不同的分支,只看最终输出无法判断问题所在。团队落地时的常见做法是:先在开发环境开启全量追踪,把典型失败案例固化成评测集,再把评测接入发布流程。

🚀

生产部署与可视化原型

部署方面,官方推荐使用配套的部署平台,定位是面向长时间运行的有状态工作流的基础设施,支持发现、复用、配置与共享智能体,并提供可视化原型工具供团队快速迭代。这里的关键差别在于「有状态」:普通无状态服务的扩缩容经验不能直接套用,需要处理会话粘性、检查点共享与并发写入等问题。选型时建议把状态存储的可用性与一致性要求写进架构文档,再决定部署形态。

🧩

生态组合:Deep Agents、LangChain 与双语言实现

官方给出的组合方式是:需要快速搭建智能体时用建立在 LangGraph 之上的更高层封装(支持规划、使用子智能体与文件系统);需要模型、工具与检索组件时用 LangChain;需要追踪、评测与部署时用 LangSmith。此外还有等价的 JavaScript/TypeScript 实现,便于前后端一体或 Node 技术栈的团队。对已有技术栈的团队,这套分层的好处是可以只取所需,而不必整体迁移。

🏛

设计来源、采用情况与许可

官方在致谢中说明其设计受 Pregel 与 Apache Beam 启发,公开接口参考了 NetworkX,由 LangChain Inc. 构建但可脱离 LangChain 使用——这几条对判断技术血统与迁移风险有用:图计算与数据流模型的成熟经验被直接借用。采用方名单里包含多家知名公司,官方另设案例页面。许可为 MIT,核验时仓库约有 4.2 万 star,发布非常活跃:最新记录为 1.2.12(2026 年 9 月 21 日),与主包同时维护的还有 SDK 与检查点相关包。

产品特点

核心功能与独有价值

01

低层编排:只给基础设施,不给黑盒

官方把它定义为「用于构建有状态智能体的低层编排框架」,开发者自行设计图结构、状态模型与终止条件,流程完全可控、每一步可观测,也可脱离 LangChain 单独使用。

02

持久化执行加人在环路

运行状态会被保存,失败或中断后可从断点继续;同时支持在任何执行点中断、查看并修改状态后继续,适合需要审批与长流程的生产场景。

03

短期与长期两层记忆

官方强调「完整记忆」包含面向当前推理的短期工作记忆与跨会话保留的长期持久记忆:前者受上下文窗口与成本约束,需要摘要或裁剪策略;后者涉及存什么、怎么检索与何时遗忘,文档分别给出实现方式与注意事项。

04

LangSmith 观测与部署配套

可借助配套平台追踪执行路径、捕获状态转移并做评测,另有面向长时间运行有状态工作流的部署平台与可视化原型工具,形成从开发到上线的闭环。

最近动态

重要更新

langgraph 1.2.12:最新版本记录

发布记录显示 langgraph 1.2.12 于 2026 年 9 月 21 日发布,属于核验时点最新的版本。该仓库以多包形式发布,主包与配套包分别打版本,升级时建议确认各包之间的兼容关系。

SDK 与主包同步更新

2026 年 8 月,langgraph-sdk 发布 0.4.4(8 月 19 日),主包 langgraph 发布 1.2.11(8 月 7 日)。SDK 主要面向与服务端交互的场景,若使用官方部署平台,升级时应同步核对 SDK 与主包版本。

检查点相关包更新,影响持久化能力

2026 年 7 月,langgraph-checkpoint 发布 4.2.0(7 月 30 日)、langgraph-checkpoint-postgres 发布 3.1.1(7 月 28 日)。检查点包决定持久化执行与状态恢复的行为,生产环境升级前应在测试环境验证中断恢复流程。

文档与生态入口的变化(核验时点)

截至核验时,官方 README 把文档入口统一指向 docs.langchain.com,API 参考独立在 reference.langchain.com,并把建立在 LangGraph 之上的更高层封装列为首选推荐(适合需要规划、子智能体与文件系统的场景)。入口与推荐方式会随官方调整,使用前建议以仓库当期说明为准。

产品总结

LangGraph 是 LangChain Inc. 出品的开源智能体编排框架,官方把它定义为「用于构建有状态智能体的低层编排框架」:不提供成品智能体,而是提供搭建这类系统所需的底层设施。项目以 MIT 许可开源,核验时 GitHub 仓库约有 4.2 万 star,发布节奏很密集——最新记录为 langgraph 1.2.12(2026 年 9 月 21 日),同期还有 langgraph-sdk 0.4.4、langgraph-checkpoint 4.2.0 与 langgraph-checkpoint-postgres 3.1.1 等配套包各自发布版本。官方致谢中说明其设计受 Pregel 与 Apache Beam 启发、公开接口参考 NetworkX,由 LangChain 团队构建但可脱离 LangChain 单独使用。 官方列出的核心能力有五项。持久化执行让智能体在失败或中断后从断点继续,适合长时间运行的任务;人在环路支持在执行过程任意点中断、检视并修改状态后继续;完整记忆包含面向当前推理的短期工作记忆与跨会话保留的长期记忆;与配套观测平台结合可追踪执行路径、捕获状态转移并查看运行时指标;部署侧则提供面向长时间运行有状态工作流的基础设施与可视化原型工具。 生态方面,官方建议按需求分层取用:想快速搭建智能体可用建立在 LangGraph 之上的更高层封装(支持规划、子智能体与文件系统);需要模型、工具与检索组件时用 LangChain;需要追踪、评测与部署时用配套平台。此外还有等价的 JavaScript/TypeScript 实现,方便 Node 技术栈的团队复用同一套编排思路。官方另提供快速开始的文档、API 参考、免费课程与采用案例页面,采用方名单中包含多家知名公司。 使用前需要注意:它是低层框架,图结构、状态模型与终止条件都要自己设计,前期投入高于开箱即用的方案;持久化执行依赖检查点存储,需评估写入开销与数据保留策略;人在环路的判定建议写成显式规则并定义超时默认动作,避免流程卡在等待审批;有状态服务的扩缩容与无状态服务不同,会话粘性、检查点共享与并发写入需要提前设计;主包与 SDK、检查点包分别发版,升级时应同步核对兼容关系。

产品类型
智能体编排框架
支持平台
Python 包(pip install lan / JavaScript/TypeScript(La / 与 LangChain 组件集成 / LangSmith 追踪与评测 / LangSmith 部署平台 / LangSmith Studio 可视化原型 / 持久化检查点(内存、Postgres 等) / Deep Agents 更高层封装
资费模式
框架本身为 MIT 许可免费开源;LangSmith 的追踪、评测与部署平台按官方方案计费。

核验信息

参考文章与数据来源

本页事实来自 LangGraph 官方渠道:GitHub 仓库 README(「用于构建有状态智能体的低层编排框架」定位、MIT 许可徽章与安装命令、持久化执行/人在环路/完整记忆/观测/生产部署五项能力说明、生态组合与配套包介绍、文档与 API 参考入口、设计来源与致谢、采用方与案例页链接)与发布页的版本及日期,以及官方产品页与官方文档(概览与快速开始页面)。star 数、版本与功能核验于 2026 年 9 月 22 日,项目发布频繁,请以官方文档与发布说明为准。

  1. 其他LangGraph 官方仓库
  2. 官网官方产品页
  3. 官方文档官方文档
  4. 官方文档官方文档 · 快速开始
  5. 官方文档官方 API 参考
  6. 其他LangGraph.js 仓库
  7. 官网官方采用案例页
  8. 其他官方版本发布页

用户体验调查

LangGraph介绍页面对您是否有帮助?