用途:帮助开发者用 Python 正确搭建 LangGraph 1.0 的 StateGraph,避免状态被覆盖、图静默停止、递归报错和检查点失效等常见问题。
主要能力:以 TypedDict 定义状态,并在列表字段上使用 reducer(messages 用 add_messages,普通列表用 operator.add);节点函数返回部分状态字典;条件边使用 Literal 类型路由,并在 path_map 中始终包含 END 作为兜底;用 checkpointer 编译图;按超步数而非循环次数设置 recursion_limit;调用时在 config["configurable"] 中显式传入 thread_id。
必要用法:需 Python 3.10+,安装 pip install langgraph>=1.0,<2.0 langchain-core>=1.0,<2.0;跨进程持久化需 pip install langgraph-checkpoint-postgres 及 Postgres 14+。生产环境每次升级 langgraph 后须在预发重跑 PostgresSaver.setup()。
适用场景:构建 ReAct 智能体、规划-执行-校验流程、带分支合并的深度智能体,以及需要多轮记忆与检查点的图。
限制:资料未提供具体收费、价格与平台信息;节点须对输入保持确定性,副作用应放到工具或检查点边界;状态应保持基本类型,避免 datetime 等不可 JSON 序列化对象。