什么是 LangGraph?
更新于
LangGraph 是稳定 1.x 的低层编排 Runtime,用确定性代码、模型调用、Tool 与人工输入构建长时间运行且有状态的 Workflow。
快速了解
| 全称 | LangGraph Agent 编排运行时 |
|---|---|
| 创建时间 | 由 LangChain 团队推出,解决传统 Chain 缺乏循环能力的痛点 |
| 规范文档 | 官方规范 |
工作原理
State、Checkpoint 与 Store 的作用域不同
Node 返回部分 Update,每个 State Channel 的 Reducer 决定如何合并。Checkpointer 记录 Thread 范围的 Snapshot,用于连续会话、Interrupt、Replay 与恢复;Store 保存跨 Thread 的应用数据。仅 Compile 不会自动获得重启恢复,生产系统还需要稳定 Thread ID 与持久化 Checkpointer,内存 Saver 会随进程退出而丢失。
持久执行依赖确定性重放
恢复时从 Node、Subgraph 边界或 Functional Entrypoint 重新开始,而不是回到原代码行。非确定性工作和 Side Effect 应放入显式 Task 或 Node,并使用稳定 Operation ID、Idempotency Key 和未知结果对账。Time Travel 只会创建 Replay 或 Fork,无法撤销已经提交的邮件、支付、部署或数据库写入。
优雅停机是协作式排空,不是取消
LangGraph 1.2 增加基于 RunControl 的 Superstep 间优雅停机。正在执行的 Node 或 Retry Loop 会先完成,再保存可恢复 Checkpoint,并用相同 Thread Identity 继续。Drain 不会取消正在运行的异步任务,因此部署系统仍需设置有限停机期限,以及下游取消或幂等策略。
主要特点
- 提供低层编排 Runtime,不规定唯一 Agent、Prompt、Tool 或 Multi-Agent 架构
- 在同一 Persistence、Streaming 与 Interrupt Runtime 上支持声明式 Graph API 和 Functional API
- 区分 Thread 范围 Checkpoint 与跨 Thread Store,并要求持久化后端才能在重启后恢复
- 通过确定性 Replay 恢复,因此非确定性操作与外部 Side Effect 仍需要 Task、幂等和对账
- LangGraph 1.2 支持协作式优雅停机,但不会把 Drain 当作硬取消
- Authorization、租户隔离、Evaluation 和 Deployment 仍由应用栈负责
常见用途
- 构建包含条件分支、循环、Retry 和显式终态的长时间运行 Workflow
- 在经外部授权的人工审核点暂停 Run,再通过已验证的 Interrupt Payload 恢复
- 持久化 Thread State 以恢复故障,同时把跨 Thread 的用户或应用 Memory 单独存储
- 在类型化输入、输出、State 与权限边界后组合 Subgraph 或专业 Agent
- 为调试和评测 Replay 或 Fork 已记录的 Trajectory,同时不把重放误当现实副作用回滚
示例
Loading code...常见问题
LangGraph 1.x 已经稳定吗?
LangGraph 1.0 已稳定核心 Graph API 与执行模型,但后续 1.x 能力仍有最低版本要求,例如协作式优雅停机需要 LangGraph 1.2。上线前仍应固定精确版本,并验证 Persistence、Replay、Interrupt 与停机行为。
LangGraph 必须使用 LLM 或 Multi-Agent 吗?
不必。LangGraph Node 可以运行确定性代码、调用 API、调用模型、执行 Tool 或组合另一个 Graph;同一个 Workflow 也能混合这些步骤。Functional API 还可以沿用普通 Python 控制流。只有专业分工带来可测收益时才需要多个 Agent,LangGraph 本身不会让系统自动获得自主性或可靠性。
LangGraph Checkpointer 与 Store 有什么区别?
Checkpointer 为一个执行 Thread 记录 State Snapshot,用于会话连续性、Interrupt、Replay 和故障恢复;Store 保存用户偏好或共享知识等跨 Thread 应用数据。InMemorySaver 只存在于当前进程,不适合重启恢复;生产系统还需要保留期限、访问控制、加密和删除策略。
LangGraph Checkpoint 能阻止重复副作用吗?
不能。Resume 与 Interrupt 可能从 Node 或 Entrypoint 开头重放,外部写入成功但 Task 未完成时也可能再次执行。应使用稳定 Operation ID 与 Idempotency Key,对未知结果执行对账,并在模型之外授权写入。
LangGraph 优雅停机会取消正在运行的任务吗?
不会。LangGraph 1.2 的 Drain Request 在 Superstep 之间生效,当前 Node 或 Retry Loop 可能先完成。应同时设置停机期限和下游取消策略,再使用相同 Thread Identity 从已保存的 Checkpoint 恢复。