LangGraph：实战状态代理编排，长任务断点续跑

LangGraph实战状态代理编排长任务断点续跑【免费下载链接】langgraphBuild resilient agents.项目地址: https://gitcode.com/GitHub_Trending/la/langgraph你的 Agent 跑一半挂了只能从头再来多轮对话一重启上下文全丢LangGraph 是专为这类有状态、长期运行代理设计的编排框架把执行流程画成图每一步的状态自动存档挂掉之后从哪里断就从哪里续。 三步跑通第一个 LangGraph 状态图装包pip install -U langgraph想快速出活直接用预构建的 ReAct 代理一行起图from langgraph.prebuilt import create_react_agent app create_react_agent(model, tools) app.invoke({messages: [{role: user, content: 查一下旧金山天气}]})需要精细控制时自己建StateGraph、加节点和边compile()即可运行。JS/TS 也有对应版本 LangGraph.js生态同构。 设计内核一次运行就是一次图调度LangGraph 把一次 Agent 运行当成一张有向图来调度节点是步骤边是状态流转所有状态放在通道里累积按 Pregel 风格的超级步superstep推进——同一批节点并行跑完才算一步。每步结束状态快照入库恢复、回放、人工介入全建立在这上面。libs/langgraph/langgraph/pregel/— 超步调度与执行循环引擎核心libs/langgraph/langgraph/channels/— 状态通道定义值怎么读、怎么合并libs/checkpoint/langgraph/checkpoint/— 检查点持久层配套 Postgres / SQLite 后端 能力深潜断点恢复跑了一半的任务不怕进程挂检查点器在每个超步后把完整状态存成 checkpoint。某个节点失败时同一超步里已成功节点的产出会作为 pending writes 保留恢复时不重跑。定位靠两个 IDthread_id标识一次对话checkpoint_id指向具体某一步从任意中间点重新发起运行都行。跑几小时的批处理代理进程重启不再是灾难。人机协同LLM 动手前先过人的眼图可以在任意节点挂起调用interrupt()后执行停住状态完整落盘等人工审查、修改状态再恢复。libs/prebuilt/langgraph/prebuilt/interrupt.py提供了结构化的HumanInterrupt请求/响应模式。审批流、客服升级、高风险工具调用都靠它兜底。双层记忆短期推理 长期跨会话短期记忆就是图状态本身thread_id天然支持多租户隔离长期记忆由libs/checkpoint/langgraph/store/提供独立的 Store 层跨线程、跨会话读写同样有 Postgres 和 SQLite 实现。对话里记住用户偏好、沉淀历史工单知识不用自己拼向量库胶水。️ 一个真实场景客服工单代理如果你要做客服 Agent可以看 examples/customer-support/ 这个归档示例工单进来后走理解问题 → 查知识库/调工具 → 判断置信度的流程拿不准的问题升级人工处理记录留档到下一轮。它演示的正是状态图最擅长的形状确定性分支和 LLM 判断混排、中途可能中断等人、多轮之间状态不断。注意该目录已转为归档索引最新教程以官方文档为准另外 examples/multi_agent/ 里的分层多代理协作也值得对照着看。⚠️ 上生产前同事会提醒你三句别裸跑反序列化。checkpoint 读取默认允许任意 Python 类型新项目务必设置LANGGRAPH_STRICT_MSGPACKtrue或显式传allowed_msgpack_modules白名单否则落库数据反成代码执行风险。检查点别留在内存里。InMemorySaver只适合 demo上多实例就用 Postgres 后端libs/checkpoint-postgres/长对话的存储增量问题再看 delta channel 相关测试了解优化方向。长任务的延迟来自 LLM 而不是框架。别急着横向堆实例先把每步的超时和重试策略libs/langgraph/langgraph/_internal/_retry.py有现成封装定清楚。 工具链与生态调试首选 LangSmith可视化追踪执行路径、状态转换和运行时指标定位为什么走到这个分支最直接。本地开发用 CLIlibs/cli/起 LangGraph Studio在浏览器里直接看你的状态图长什么样、手动提交输入跑一遍线程下一步去翻一遍 libs/prebuilt/README.md把create_react_agent换成你自己的模型和工具跑通第一条线程——图会画状态就会自己长出来。【免费下载链接】langgraphBuild resilient agents.项目地址: https://gitcode.com/GitHub_Trending/la/langgraph创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考