LangGraph 状态设计

说明 LangGraph 中状态、节点、边、检查点和中断恢复的设计方法。

LangGraph 的重点不是图画得多复杂，而是状态设计是否清楚。状态决定每个节点能看到什么、能修改什么，也决定任务能不能中断、恢复和复盘。

如果状态设计混乱，图结构越复杂，系统越难排查。

State 应该放什么

State 里适合放任务推进必需的信息：

不要把所有聊天历史和业务主数据都塞进 State。State 是任务快照，不是数据库。

每个节点应该只负责一类明确变化，比如检索、调用工具、总结结果、判断下一步。节点返回状态增量，而不是随意改全局对象。

这样做的好处是每一步更容易观察和回放。

Checkpoint 让长任务可以中断和恢复。对多步骤 Agent 来说，这不是锦上添花，而是生产系统需要的能力。

没有检查点，浏览器断开、工具失败或人工介入都会让任务状态变得不可控。

LangGraph 的核心不是画图，而是把多步骤 Agent 的状态变成可管理对象。