LangGraph 实战笔记：用 AI 发起流程应用

LangGraph 实战笔记用 AI 发起流程应用一句话总结LangGraph 让 AI 从“直线思维”变成“闭环思维”是实现复杂、可循环、人机协同工作流的首选工具。目录一、核心概念无代码版二、LangGraph vs LangChain vs K2 三方对比三、需求拆解AI 发起考勤流程四、为什么这个场景必须用 LangGraph五、关键实现要点无代码版六、生活化类比总结七、选型决策指南八、总结与下一步建议一、核心概念无代码版概念大白话解释生活类比节点 (Node)干活的步骤地铁的站点边 (Edge)步骤之间的连接地铁的轨道状态 (State)全程传递的数据包乘客手里的行李图 (Graph)整个工作流程完整的地铁线路图条件边根据结果决定走哪条路地铁的换乘站循环不满足条件就回去重做坐错站了返回重坐检查点保存进度可随时恢复游戏的存档点二、LangGraph vs LangChain vs K2 三方对比三者核心区别LangChainLangGraphK2 工作流线性调用链A→B→C 直线执行图结构工作流支持循环和分支企业级 BPM 引擎固定流程人工审批为主适合简单任务适合复杂多步任务适合企业固定流程无状态或简单状态内置状态管理完整流程实例管理像「单线地铁」像「换乘地铁网」像「火车轨道」AI 调用工具AI 智能体编排人工系统混合流程LangChain 和 LangGraph 的关系┌─────────────────────────────────────────────────────────────┐ │ │ │ LangChain LangGraph │ │ ┌─────────┐ ┌─────────────────────────┐ │ │ │ LLM │ │ ┌─────┐ ┌─────┐ │ │ │ │ 调用 │ → │ │节点 │→ │节点 │ ... │ │ │ │ 工具 │ │ └─────┘ └─────┘ │ │ │ │ 记忆 │ │ ↖ ↙ │ │ │ └─────────┘ │ 循环/条件 │ │ │ └─────────────────────────┘ │ │ │ │ 基础组件库 基于 LangChain 的编排层 │ │ (砖头、水泥) (用砖头盖成的房子) │ │ │ └─────────────────────────────────────────────────────────────┘关键理解LangGraph不是替代LangChain而是构建在 LangChain 之上LangChain 提供「能力」——调用 LLM、工具、记忆LangGraph 提供「编排」——如何组织这些能力的执行顺序三、需求拆解AI 发起考勤流程需求描述用户说“我想发起考勤”↓AI 返回表单结构↓用户填写数据↓AI 校验数据 ──┬── 通过 → 发起流程│└── 不通过 → 返回让用户重填可循环完整流程架构图┌─────────────────────────────────────────────────────────────────┐ │ LangGraph 工作流全景图 │ │ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 意图识别 │───→│ 生成表单 │───→│ 用户填写 │ │ │ │ Node │ │ Node │ │ (人工) │ │ │ └─────────┘ └─────────┘ └────┬────┘ │ │ │ │ │ ▼ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │ 发起流程 │←───│ 校验通过│←───│ AI 校验 │ │ │ │ Node │ │ 条件 │ │ Node │ │ │ └─────────┘ └────┬────┘ └─────────┘ │ │ │ │ │ ┌─────────────┴─────────────┐ │ │ │ │ │ │ ▼ ▼ │ │ 【成功】结束 【失败】循环回去 │ │ (最多重试 3 次) │ │ │ └─────────────────────────────────────────────────────────────────┘各节点职责说明节点名称职责输入输出意图识别理解用户想发起什么流程用户自然语言流程类型考勤/请假/报销生成表单根据流程类型返回数据结构流程类型表单字段定义用户填写等待用户输入数据表单结构用户填写的内容AI 校验检查数据完整性和合理性用户填写的数据校验结果 反馈信息条件判断决定下一步走向校验结果提交/重试/转人工发起流程调用 OA 系统 API校验通过的数据流程发起成功四、为什么这个场景必须用 LangGraph❌ 用 LangChain 的困境LangChain 线性执行用户输入 → 识别意图 → 生成表单 → 用户填写 → 校验 → 结束 │ ▼ 校验失败 没法回去 只能重新发起整个流程问题校验失败后无法自动循环回填写节点需要自己管理状态和重试逻辑代码会越来越复杂难以维护✅ 用 LangGraph 的优势LangGraph 循环执行用户输入 → 识别意图 → 生成表单 → 用户填写 → 校验 ──┬── 通过 → 发起 │ └── 失败 → 回到填写优势✅ 天然支持循环校验失败自动回到填写节点✅ 状态自动管理每次循环数据不丢失✅ 支持断点续传用户可随时回来继续✅ 流程可视化调试和维护更简单五、关键实现要点无代码版 1. 防止无限循环┌─────────────────────────────────────────┐ │ 循环控制策略 │ ├─────────────────────────────────────────┤ │ 设置最大重试次数建议 3-5 次 │ │ 超过次数 → 转人工处理 │ │ 每次循环记录重试计数 │ └─────────────────────────────────────────┘ 2. 状态持久化断点续传┌─────────────────────────────────────────┐ │ 状态保存机制 │ ├─────────────────────────────────────────┤ │ 每个节点执行后自动存档 │ │ 用户关闭页面后再回来进度不丢失 │ │ 通过线程 ID 关联同一用户的会话 │ └─────────────────────────────────────────┘ 3. 人机交互等待用户填写┌─────────────────────────────────────────┐ │ 人工介入节点 │ ├─────────────────────────────────────────┤ │ 流程在填写节点暂停 │ │ 用户通过前端界面提交数据 │ │ 系统接收后继续执行后续节点 │ └─────────────────────────────────────────┘ 4. 流式反馈实时显示结果┌─────────────────────────────────────────┐ │ 实时反馈机制 │ ├─────────────────────────────────────────┤ │ 不用等全部完成才返回 │ │ 每执行一个节点就返回进度 │ │ 用户能看到校验反馈体验更好 │ └─────────────────────────────────────────┘六、生活化类比总结场景LangChain 方式LangGraph 方式做菜按菜谱做完再尝淡了只能重做边做边尝淡了当场加盐导航固定路线堵车也硬走实时路况自动绕路考试交卷后等批改错了下次改做完一题检查一题错了当场改写文章写完统一检查问题多要重写写一段检查一段有问题立刻改你的考勤流程填完直接提交错了打回重填填完 AI 先校验错了当场提示重填七、选型决策指南场景推荐方案简单问答/单次调用LangChain多步骤需要循环校验LangGraph ✅企业固定审批流程K2/传统 BPMAI 智能体多角色协作LangGraph ✅需要人工介入审批LangGraph ✅高并发企业级流程K2/传统 BPM八、总结与下一步建议核心收获LangGraph LangChain 的能力 工作流的编排 AI 的动态决策LangGraph 不是替代 LangChain而是它的编排层有循环需求的 AI 任务LangGraph 是首选状态管理是核心不用自己存框架自动处理人机交互是亮点支持中断、恢复、转人工维度结论维度结论你的需求匹配度⭐⭐⭐⭐⭐ 完全匹配学习成本中等需理解图、节点、状态概念开发效率高循环和状态管理内置生产成熟度高已有大量生产案例社区支持良好LangChain 生态下一步建议先跑通最小 Demo识别→校验→提交添加状态持久化支持断点续传对接 OA 系统 API正式发起流程完善前端交互流式反馈、重试提示笔记整理完成 概念清晰、架构完整、对比明确可直接用于技术方案评审