LangGraph 完整指南:3 步跑起来,构建中断也不丢状态的状态化智能体

📅 发布时间:2026/9/1 9:55:04
LangGraph 完整指南:3 步跑起来,构建中断也不丢状态的状态化智能体
LangGraph 完整指南3 步跑起来构建中断也不丢状态的状态化智能体【免费下载链接】langgraphBuild resilient agents.项目地址: https://gitcode.com/GitHub_Trending/la/langgraph一个 Agent 正在执行需要跑 40 分钟的任务。第 30 分钟进程崩溃重启后中间状态全丢只能从头再来。LangGraph 要解决的就是这件事它由 LangChain 团队开发把智能体逻辑组织成一张状态化的图每一步自动写入检查点失败后从最后一个节点继续而不是重跑。LangGraph 谁在维护、谁在生产环境用维护方LangChain Inc即 LangChain 原班团队。README 明确说明它可以脱离 LangChain 单独使用。生产用户Klarna客服场景、ReplitAI 编码、Elastic 等公司已在生产环境使用。替代的旧做法以前保存状态、失败重试、等人审批都得自己写逻辑散落在各处、难测试。LangGraph 把这些收进图引擎你只描述节点和边。设计渊源受 Google 的 Pregel 和 Apache Beam 启发采用超级步骤式的并行调度。LangGraph 最快安装方式一条命令到第一次运行pip install -U langgraph最简入口是 libs/prebuilt/ 里的create_react_agent传入模型、工具列表和一个内存检查点器就得到一个能循环调用工具的 Agentfrom langgraph.prebuilt import create_react_agent from langgraph.checkpoint.memory import MemorySaver agent create_react_agent( openai:gpt-4o, tools[search], checkpointerMemorySaver()) agent.invoke({messages: [(user, 2024 年 G7 在哪举办?)]}, config{configurable: {thread_id: t1}})运行后你会看到答案和工具调用轨迹状态留在内存检查点里用同一个thread_id再调用可以继续对话。想要图形界面libs/cli提供langgraph dev命令本地启动后浏览器里能看到图被渲染成可交互 UI线程状态实时显示在侧栏LangGraph 是怎么工作的三个核心机制1. 超级步骤执行Pregel 模型每段逻辑写成一个节点函数节点之间用边连接。运行时按超级步骤推进每步并行执行所有就绪节点节点读取当前状态、算出新状态写回共享的通道。状态字段可以声明 reducer 函数决定合并方式比如消息列表用追加。输入是状态字典输出是更新后的状态字典流向完全由边决定。2. 检查点持久化durable execution每个超级步骤结束后完整状态被序列化落盘。MemorySaver存内存生产换libs/checkpoint-sqlite或libs/checkpoint-postgres实现即可。崩溃后用thread_id加载最近检查点从中断的节点继续已完成的步骤不重跑。3. 人在回路中断human-in-the-loop节点里调用interrupt()整个图挂起状态保留在磁盘上进程可以安全退出。人工审核后调用Command(resumeapprove)继续拒绝则走另一分支。转账、删数据这类敏感操作官方推荐的就是这条路。用它做了什么两个真实示例 notebookexamples/ 目录已标注归档新教程迁往官方文档站但代码完整适合直接读react-agent-from-scratch.ipynb从零手搓一个 ReAct 智能体。输入是几个工具和一个 prompt处理过程是思考→调工具→观察的循环产出一个开箱即用的工具调用 Agent。hierarchical_agent_teams.ipynb一个经理智能体拆任务、派给多个下属智能体、最后汇总。多智能体协作被组织成一张可中断、可恢复的状态图。边界与权衡适合什么、不适合什么适合长时运行、多步骤、需要扛故障和人工干预的流程——客服、数据流水线、多智能体协作以及跑几十分钟到几小时的任务。不适合单次 prompt 调用、简单的查文档→填模板流程。只用一次模型上图引擎就是杀鸡用牛刀。学习成本状态 schema、reducer、通道、超级步骤这些概念需要消化曲线比高层 Agent 包更陡。自由度与样板代码它定位低层重试、超时、中断都自己接线灵活但代码量更多。常见模式建议直接用libs/prebuilt省一半样板。LangGraph 下一步去哪看examples/ — 可运行的示例 notebook已归档代码完整libs/langgraph/ — 核心源码状态图、通道、Pregel 引擎libs/checkpoint-sqlite/ — 本地持久化检查点器docs/ 目录 — 目前仅有 llms.txt 与重定向配置正文文档已迁至官方站点在站点内搜索 LangGraph quickstart 即可【免费下载链接】langgraphBuild resilient agents.项目地址: https://gitcode.com/GitHub_Trending/la/langgraph创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考