十年匠心定制 · 商业建站与技术教学双线并行 咨询热线:400-886-1026 service@lmnt.cn
ARTICLE DETAIL

资讯详情

深耕网站建设与运营推广的一线实战洞察。

LangGraph 智能体开发实战:用图结构编排可控的 Agent 工作流

LangGraph 智能体开发实战:用图结构编排可控的 Agent 工作流 这里写自定义目录标题欢迎使用Markdown编辑器一、为什么 Agent 需要图而不是链二、核心概念State、Node、Edge 与条件边三、状态持久化让 Agent 具备记忆和断点续跑四、并行与扇出让 Agent 学会多线程五、实战案例自动化数据分析 Agent生成一个适合你的列表创建一个表格设定内容居中、居左、居右SmartyPants创建一个自定义列表如何创建一个注脚注释也是必不可少的KaTeX数学公式新的甘特图功能丰富你的文章UML图表流程图FLowchart流程图导出与导入导出导入欢迎使用Markdown编辑器你好 这是你第一次使用# LangGraph 智能体开发实战用图结构编排可控的 Agent 工作流一、为什么 Agent 需要图而不是链很多开发者第一次接触 LangGraph 时都会困惑LangChain 不是已经有 Chain链了吗为什么还要引入图Graph的概念答案在于控制流的表达能力。Chain 是线性的——A 完成后执行 BB 完成后执行 C像一条流水线。但真实世界的任务很少是纯线性的有些步骤可以并行有些步骤需要条件分支有些步骤失败后要重试有些步骤需要循环直到满足条件。这些复杂的控制流用线性 Chain 表达起来非常别扭甚至无法表达。LangGraph 的核心思想就是把 Agent 的工作流建模成一张有向图节点Node是具体的处理步骤边Edge是步骤之间的流转关系。图结构天然支持分支、循环、并行、条件跳转这让开发者能够精确控制 Agent 的执行路径而不是把一切都交给模型自由发挥。用一句话概括LangGraph 让模型负责推理图负责控制流两者各司其职Agent 才真正变得可控。二、核心概念State、Node、Edge 与条件边LangGraph 有四个核心概念理解它们就掌握了框架的骨架。State状态整个工作流共享的数据结构是节点之间传递信息的载体。可以是一个字典、一个 TypedDict也可以是一个 Pydantic 模型。State 贯穿整个图的生命周期每个节点读取 State、修改 State修改后的 State 传给下一个节点。Node节点一个具体的处理步骤通常是一个 Python 函数。函数接收当前的 State执行逻辑比如调用模型、调用工具返回更新后的 State 片段。Edge边节点之间的连接定义执行顺序。普通边表示上一个节点完成后执行下一个节点。条件边Conditional EdgeLangGraph 最强大的特性。它允许根据当前 State 的内容动态决定下一步走向哪个节点。比如如果模型判断任务完成就走向结束节点否则回到工具调用节点。这正是 Agent 循环Loop的实现基础。下面是一个最小示例展示如何用 LangGraph 构建一个调用工具-判断结果的循环fromtypingimportTypedDict,Literalfromlanggraph.graphimportStateGraph,ENDclassAgentState(TypedDict):messages:listfinished:booldefcall_model(state:AgentState):# 调用模型决定下一步动作responsellm.invoke(state[messages])return{messages:state[messages][response]}defcall_tool(state:AgentState):# 执行模型请求的工具tool_resultexecute_tool(state[messages][-1].tool_calls)return{messages:state[messages][tool_result]}defshould_continue(state:AgentState)-Literal[tools,end]:# 条件边根据模型是否请求工具决定走向laststate[messages][-1]returntoolsiflast.tool_callselseend# 构建图graphStateGraph(AgentState)graph.add_node(model,call_model)graph.add_node(tools,call_tool)graph.add_edge(model,tools)# 普通边graph.add_conditional_edges(model,should_continue,{tools:tools,end:END})graph.set_entry_point(model)appgraph.compile()这个例子虽然简单但已经包含了 Agent 循环的全部要素模型节点、工具节点、条件判断、循环回边。真实项目在此基础上扩展即可。三、状态持久化让 Agent 具备记忆和断点续跑LangGraph 的另一个杀手级特性是状态持久化Persistence。默认情况下State 只存在于内存中图执行完就消失了。但 LangGraph 支持将 State 持久化到存储后端如 SQLite、PostgreSQL这让两个高级能力成为可能记忆能力把 State 存下来下次执行时恢复Agent 就能记住之前的对话和中间状态。这比单纯把历史消息塞进上下文要优雅得多——State 里可以存结构化数据比如用户已确认订单号而不仅仅是文本。断点续跑Checkpointing图执行到一半可以暂停并保存状态之后从断点恢复。这为人工介入Human-in-the-loop提供了基础设施——Agent 执行到需要人工审批的节点时暂停等人工确认后再继续。在工程实践中断点续跑的价值怎么强调都不过分。它意味着 Agent 系统可以像传统工作流引擎一样支持暂停、恢复、重试、审计而不是要么一次跑完、要么全部重来。四、并行与扇出让 Agent 学会多线程真实任务中很多子步骤是相互独立的可以并行执行。LangGraph 通过扇出-汇聚Fan-out / Fan-in模式支持并行。扇出Fan-out一个节点把任务分发给多个并行节点。比如市场分析任务可以同时启动行业数据收集、“竞品分析”、用户调研三个并行节点。汇聚Fan-in多个并行节点的结果汇合到一个节点。比如三个并行节点完成后由一个汇总节点整合所有结果。实现上LangGraph 支持在 State 中定义列表字段多个节点可以同时向列表字段追加内容最后统一汇聚。这种模式特别适合多路检索、多角色评审等场景能显著缩短整体执行时间。五、实战案例自动化数据分析 Agent下面用一个完整的案例展示 LangGraph 在真实场景中的应用。需求构建一个能自动完成数据分析任务的 Agent——用户提出分析需求Agent 自动查询数据、执行分析、生成报告。工作流设计如下用户需求 → 需求理解节点 → 数据查询节点 → 分析执行节点 → 报告生成节点 → 质量检查节点 ↑ ↓ └──── 条件边数据不足则重新查询 ────┘ 各节点的职责 **需求理解节点**把用户的自然语言需求解析为结构化的分析任务包括数据范围、分析维度、输出格式。 **数据查询节点**根据分析任务生成 SQL 或调用数据 API获取数据。这里要处理一个常见问题——模型生成的 SQL 可能出错需要加入SQL 校验-重试逻辑。 **分析执行节点**对数据做统计分析、生成图表。可以用 Python 代码执行器运行分析代码。 **报告生成节点**基于分析结果生成结构化报告包含结论、数据支撑、图表。 **质量检查节点**检查报告是否完整、数据是否有明显错误。如果发现数据不足或分析有误通过条件边回到数据查询节点重新执行。 这个案例展示了 LangGraph 的核心价值把模型自由发挥变成受控的工程流程。每个节点都有明确的职责和输入输出出了问题可以定位到具体节点而不是面对一个黑盒。 ## 六、工程实践要点与避坑指南 最后分享几个 LangGraph 工程实践中的经验。 第一节点函数要小而纯。每个节点只做一件事输入输出通过 State 传递不要在一个节点里塞太多逻辑。这样既好调试也方便复用。 第二State 设计要克制。State 是共享的塞太多无关字段会导致上下文膨胀、调试困难。只放节点之间需要传递的信息。 第三条件边是灵魂。Agent 的智能很大程度体现在条件边的设计上——什么情况下继续、什么情况下停止、什么情况下重试。把条件判断逻辑写清楚Agent 行为就可预测。 第四重视超时与重试。模型调用可能超时、工具可能报错每个节点都要考虑失败处理。LangGraph 支持在节点层面配置重试建议对关键节点开启。 第五善用持久化做审计。开启状态持久化后每次执行的状态变化都可以追溯这对排查问题和满足合规要求都很有价值。 LangGraph 的价值不在于又一个 Agent 框架而在于它把 Agent 从提示词的黑盒变成了可编排的工程系统。掌握图结构思维你构建的 Agent 才能真正从演示级走向生产级。 **Markdown编辑器** 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章了解一下Markdown的基本语法知识。 ## 新的改变 我们对Markdown编辑器进行了一些功能拓展与语法支持除了标准的Markdown编辑器功能我们增加了如下几点新功能帮助你用它写博客 1. **全新的界面设计** 将会带来全新的写作体验 2. 在创作中心设置你喜爱的代码高亮样式Markdown **将代码片显示选择的高亮样式** 进行展示 3. 增加了 **图片拖拽** 功能你可以将本地的图片直接拖拽到编辑区域直接展示 4. 全新的 **KaTeX数学公式** 语法 5. 增加了支持**甘特图的mermaid语法[^1]** 功能 6. 增加了 **多屏幕编辑** Markdown文章功能 7. 增加了 **焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置** 等功能功能按钮位于编辑区域与预览区域中间 8. 增加了 **检查列表** 功能。 [^1]: [mermaid语法说明](https://mermaid.js.org/intro/) ## 功能快捷键 撤销kbdCtrl/Command/kbd kbdZ/kbd 重做kbdCtrl/Command/kbd kbdY/kbd 加粗kbdCtrl/Command/kbd kbdB/kbd 斜体kbdCtrl/Command/kbd kbdI/kbd 标题kbdCtrl/Command/kbd kbdShift/kbd kbdH/kbd 无序列表kbdCtrl/Command/kbd kbdShift/kbd kbdU/kbd 有序列表kbdCtrl/Command/kbd kbdShift/kbd kbdO/kbd 检查列表kbdCtrl/Command/kbd kbdShift/kbd kbdC/kbd 插入代码kbdCtrl/Command/kbd kbdShift/kbd kbdK/kbd 插入链接kbdCtrl/Command/kbd kbdShift/kbd kbdL/kbd 插入图片kbdCtrl/Command/kbd kbdShift/kbd kbdG/kbd 查找kbdCtrl/Command/kbd kbdF/kbd 替换kbdCtrl/Command/kbd kbdG/kbd ## 合理的创建标题有助于目录的生成 直接输入1次kbd#/kbd并按下kbdspace/kbd后将生成1级标题。 输入2次kbd#/kbd并按下kbdspace/kbd后将生成2级标题。 以此类推我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。 ## 如何改变文本的样式 *强调文本* _强调文本_ **加粗文本** __加粗文本__ 标记文本 ~~删除文本~~ 引用文本 H~2~O is是液体。 2^10^ 运算结果是 1024. ## 插入链接与图片 链接: [link](https://www.csdn.net/). 图片: ![Alt](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw) 带尺寸的图片: ![Alt](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw 30x30) 居中的图片: ![Alt](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw#pic_center) 居中并且带尺寸的图片: ![Alt](https://imgconvert.csdnimg.cn/aHR0cHM6Ly9hdmF0YXIuY3Nkbi5uZXQvNy83L0IvMV9yYWxmX2h4MTYzY29tLmpwZw#pic_center 30x30) 当然我们为了让用户更加便捷我们增加了图片拖拽功能。 ## 如何插入一段漂亮的代码片 去[博客设置](https://mp.csdn.net/console/configBlog)页面选择一款你喜欢的代码片高亮样式下面展示同样高亮的 代码片. javascript // An highlighted block var foo bar;生成一个适合你的列表项目项目项目项目1项目2项目3计划任务完成任务创建一个表格一个简单的表格是这么创建的项目Value电脑$1600手机$12导管$1设定内容居中、居左、居右使用:---------:居中使用:----------居左使用----------:居右第一列第二列第三列第一列文本居中第二列文本居右第三列文本居左SmartyPantsSmartyPants 是一个文本转换工具主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如原始符号转换后说明引号“引号”直引号变弯引号单引号‘单引号’直单引号变弯单引号--–两个连字符变短破折号---—三个连字符变长破折号...…三个点变省略号创建一个自定义列表MarkdownText-to-HTMLconversion toolAuthorsJohnLuke如何创建一个注脚一个具有注脚的文本。1注释也是必不可少的Markdown将文本转换为HTML。KaTeX数学公式您可以使用渲染LaTeX数学表达式 KaTeX:Gamma公式展示Γ ( n ) ( n − 1 ) ! ∀ n ∈ N \Gamma(n) (n-1)!\quad\forall n\in\mathbb NΓ(n)(n−1)!∀n∈N是通过欧拉积分Γ ( z ) ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) \int_0^\infty t^{z-1}e^{-t}dt\,.Γ(z)∫0∞​tz−1e−tdt.你可以找到更多关于的信息LaTeX数学表达式here.新的甘特图功能丰富你的文章2014-01-072014-01-092014-01-112014-01-132014-01-152014-01-172014-01-192014-01-21已完成进行中计划一计划二现有任务Adding GANTT diagram functionality to mermaid关于甘特图语法参考 这儿,UML图表可以使用UML图表进行渲染例如下面产生的一个序列图王五李四张三王五李四张三李四想了很长时间, 文字太长了不适合放在一行.你好李四, 最近怎么样?你最近怎么样王五我很好谢谢!我很好谢谢!打量着王五...很好... 王五, 你怎么样?关于UML图表语法参考 这儿,流程图链接长方形圆圆角长方形菱形关于Mermaid语法参考 这儿,FLowchart流程图我们依旧会支持flowchart.js的流程图语法Created with Raphaël 2.3.0开始我的操作确认结束yesno关于Flowchart流程图语法参考 这儿.导出与导入导出如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到文章导出生成一个.md文件或者.html文件进行本地保存。导入如果你想加载一篇你写过的.md文件在上方工具栏可以选择导入功能进行对应扩展名的文件导入继续你的创作。注脚的解释 ↩︎
返回列表