LangGraph 线程、检查点与 Store

langgraph_threads_checkpoints_store2026-10-29 11:03:47

LangGraph 线程、检查点与 Store

Checkpointer 按 thread 保存图状态快照,用于同一会话的连续交互、中断恢复、容错和历史查看。调用持久化图时需要稳定的 thread_id;仅配置内存 Checkpointer 不能保证进程重启后的数据仍存在。

Store 保存图状态之外的应用数据,可跨 thread 使用,例如用户偏好、长期事实或共享知识。典型系统同时使用 Checkpointer 与 Store:前者记录某条执行线,后者管理跨执行线的长期资料。

检查点包含状态值、下一步任务和元数据。应用可读取当前状态与历史,也可更新状态后从新的检查点继续。时间旅行并不是修改过去的外部世界;数据库写入、邮件发送等副作用需要单独处理一致性。

持久化设计还包括序列化、加密、保留期限、租户隔离、删除、迁移和并发策略。thread_id 是技术关联键,不应直接替代授权检查。

官方入口:持久化、记忆。

本页目录