LangGraph 10.13摘要2

LangGraph 1.2 实战连载二记忆、持久化与人工审核——把 Agent 送上生产接上篇《从状态机到 Agent》。本篇全程基于langgraph 1.2.x聚焦敢上生产的四件套持久化、时间旅行、人工介入、多 Agent。代码均可直接跑。回顾一下上篇我们建了一张图上篇我们讲了 StateGraph 的四步建图法、条件路由、以及 1.2 新特性速览。但那些图有个致命问题跑完即焚。进程一关状态全没用户中途离开回来要从头再来。生产环境里这叫事故。本篇解决的就是这件事。一、Checkpointer让 Agent 拥有长期记忆LangGraph 的持久化靠Checkpointer。它的工作方式是每走一步把当前 State 写进存储下次用同一个thread_id调用自动从断点续跑。1.1 内存版MemorySaver开发调试用thread_id是 LangGraph 里最重要的一个概念没有之一。它把一次有状态的对话/任务和一个身份绑定。换thread_id 换一个人/换一单。1.2 落地版SqliteSaver持久化到磁盘内存版进程一关就没。要真持久化用SqliteSaver零依赖、本地文件生产上规模了换PostgresSaverfrom langgraph.checkpoint.postgres import PostgresSaver接数据库即可调用方式一模一样——这就是 Checkpointer 抽象的价值换存储不改业务代码。二、时间旅行把任意历史节点当起点重放有了 Checkpointer你就白赚了时间旅行。两个 API 必须记住get_state(cfg)拿当前或指定检查点的完整 State。updateState(cfg, patch)直接改某个检查点的状态再从这个点继续跑。实战价值客户三周后来投诉当初你们分错类了你能把那次运行的精确检查点捞出来改一个输入看图会怎么重新路由。这是 LangGraph 在生产调试里最值钱的能力没有之一。1.2.13 修了一批 checkpoint / DeltaChannel 的边界 bug旧检查点update_state不再泄漏到其它分支、fork 重放更正确。所以这套能力在 1.2 后期才真正稳。三、Human-in-the-loop把人请回回路LangGraph 把中断-等人-恢复做成了一等公民不是补丁。3.1 最简单编译时声明中断点3.2 更灵活节点内interrupt()1.2.12 起支持 response_schema节点里直接调interrupt()执行到这就停返回值等于人工回传的内容。1.2.12 之后还能用response_schema校验人填的结构对比interrupt_beforeinterrupt()写在节点内部能拿到节点内上下文、能做更细的校验interrupt_before写在编译期适合节点前统一卡一道。生产上我更推荐interrupt()因为你能顺手把response_schema加上——人乱填字段直接被拦下来。四、多 Agent 编排三模式Supervisor / Swarm / Hierarchical单个 Agent 工具一多质量就崩。解法是用多个 Agent 协作。LangGraph 里三种拓扑各有甜区模式结构适合缺点Supervisor调度节点管全局worker 干完回到 supervisor大多数场景默认选它调度节点可能成瓶颈Swarmworker 之间直接交接不过 supervisor长协作、低延迟路由逻辑分散难追溯Hierarchicalsupervisor 套 supervisor组织本身就是树状职责大多数团队用不上容易过度设计4.1 Supervisor 最小骨架LangGraph 提供了create_supervisor之类的预制工具但理解骨架更重要经验法则先 Supervisor等 supervisor 自己成了瓶颈再考虑 Swarm只有当业务真的是树状职责才上 Hierarchical。我见过三个团队提前上 Hierarchical最后两个又重构回了扁平 Supervisor——别抢跑。五、上线前的几句话生产建议Checkpointer 必接MemorySaver 只配开发。生产 Sqlite/Postgres 二选一thread_id设计成一笔业务一个 id。凡是不可逆操作退款、发邮件、写库前加interrupt()人确认 → 才执行。省下的事故费够你买一年算力。节点尽量纯函数 异步任何节点是 async 就用ainvoke()否则整图阻塞。用getState/updateState做可观测LangSmith 或自建 trace 都能接调试时这是你的时光机。新特性按需取Node Caching、Deferred Nodes、Model Hooks、Content-block Streaming 在 1.2 已可用但落地前对照pip show langgraph的版本号核参数别照抄半年前的博客。