什么是 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 仍由应用栈负责

常见用途

  1. 构建包含条件分支、循环、Retry 和显式终态的长时间运行 Workflow
  2. 在经外部授权的人工审核点暂停 Run,再通过已验证的 Interrupt Payload 恢复
  3. 持久化 Thread State 以恢复故障,同时把跨 Thread 的用户或应用 Memory 单独存储
  4. 在类型化输入、输出、State 与权限边界后组合 Subgraph 或专业 Agent
  5. 为调试和评测 Replay 或 Fork 已记录的 Trajectory,同时不把重放误当现实副作用回滚

示例

loading...
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 恢复。

相关术语

相关文章