零基础玩转LangGraph！手把手教你创建多代理AI智能体（超详细教程），从入门到精通一篇通吃！

前言

在 AI 领域，检索增强生成（RAG） 系统已成为处理简单查询、生成上下文相关回答的常见工具。然而，随着对更复杂 AI 应用的需求增长，我们需要超越仅“检索+生成”的能力。于是出现了 AI 智能体（Agents）——它们能执行复杂的多步任务、在多轮交互中维护状态，并能动态适应新信息。

LangGraph 是 LangChain 的强力扩展，专为帮助开发者构建这类高级 AI 智能体而设计。它支持有状态（stateful）、多角色（multi-actor）、**可循环计算（cyclic computation）**的应用，让智能体在执行中不断“感知—决策—行动—反思—再行动”。

本文将介绍 LangGraph 如何改变 AI 开发方式，并通过一个太阳能板节能计算示例，手把手展示如何构建你自己的 AI 智能体。你将看到 LangGraph 的特性如何让系统更智能、更可适应、更贴近真实场景。

什么是 LangGraph？

LangGraph 是构建在 LangChain 之上的高级库，用于为大模型应用引入循环计算能力。

•在 LangChain 中，你通常构建有向无环图（DAG）来描述线性流程；•LangGraph 则更进一步：它支持循环（cycles），这对实现复杂、类似智能体的行为至关重要——模型可以在流程中反复迭代，根据不断变化的条件动态决定下一步动作。

LangGraph 的节点、状态与边

LangGraph 的核心概念：有状态图（Stateful Graph）

•State（状态）
表示在计算推进过程中被持续维护与更新的上下文/记忆。
它确保每一步都能访问之前步骤的相关信息，从而基于累计数据进行动态决策。•Nodes（节点）
工作流的基本构件，代表某个计算步骤或函数。
每个节点执行特定任务，如处理输入、做出决策、调用外部系统等；
节点可自定义，以满足多种操作需求。•Edges（边）
连接节点、定义计算从一步到下一步的流向； 支持条件逻辑，可根据当前状态改变执行路径；
负责数据与控制在节点间的传递，从而实现复杂的多步流程。

为什么选择 LangGraph？

LangGraph 通过对图结构、状态与协调的无缝管理，重塑了 AI 应用的开发方式：

•自动状态管理：在多轮交互中保留上下文，让 AI 能对变化的输入做出更聪明的响应；•精简的智能体协调：保障精确执行与高效信息交换，开发者可以把精力放在设计创新工作流上；•极高的灵活性：支持打造定制化、高性能应用；•可扩展与容错：即便在企业级场景下，也能保持系统稳健与可靠。

接下来你将学到什么？

•如何用 LangGraph 搭建有状态、可循环的智能体流程；•如何让智能体分步规划—执行—评估—再规划；•以“太阳能板节能计算”为例，如何将 LangGraph 的特性落地，构建智能、可适应且可生产的 AI 系统。

分步指南

在了解了 LangGraph 的核心概念与优势之后，下面通过一个可落地的实战示例来动手实现：
我们将构建一个用于根据用户输入计算太阳能板潜在节能收益的 AI 智能体。该智能体可作为光伏销售网站上的潜在客户收集（lead generation）工具，与访客交互、给出个性化节省估算。通过收集诸如每月电费等关键数据，智能体既能帮助用户理解光伏的经济价值，也能为销售团队筛选高意向线索。此示例将展示 LangGraph 如何打造智能、动态的系统，实现复杂任务自动化并创造业务价值。

第 1 步：导入必要库

首先，导入项目所需的 Python 库与模块。这些依赖为我们使用 LangChain、LangGraph 以及 AWS 服务构建 AI 助手打下基础。

from langchain_core.toolsimport tool

第 2 步：定义太阳能节省计算工具

接下来，我们定义一个工具（tool），用于根据用户提供的 月度电费 来估算使用太阳能后可能带来的节省。
这个工具将被智能体调用，以实现 数据驱动的交互。

from langchain_core.tools import tool

这段函数会处理用户的月度电费并返回一份太阳能系统收益的详细估算，包括：所需面板数量、安装成本以及 10 年期净节省。为简化演示，计算里使用了若干默认假设（如平均电价、平均日照时长）。在更高级的版本里，可以从用户处收集这些参数，从而更贴合其具体情况地给出个性化估算。

第 3 步：状态管理与错误处理

稳健的 AI 系统离不开有效的状态管理与错误处理。下面定义两个实用工具：

•handle_tool_error：在工具执行出错时，生成与具体 tool call 关联的错误消息；•create_tool_node_with_fallback：创建带兜底回退能力的工具节点，出错时自动调用错误处理逻辑。

from langchain_core.messages importToolMessage

这些函数可确保在工具执行过程中一旦出现错误，系统能优雅降级并向用户提供有用的反馈。

第 4 步：定义 State（状态）与 Assistant 类

在这一步，我们将定义智能体如何管理会话状态（对话的持续上下文），并保证其能正确响应用户输入与工具输出。

为此，先用 Python 的 TypedDict 来定义状态结构 State——它描述在 LangGraph 中节点之间传递的消息格式。状态中会保存整段对话的消息列表，其中既包括用户输入，也包括智能体回复和工具输出。

from typing importAnnotated

在有了 State 之后，我们需要定义一个 Assistant 类 来驱动智能体的运行。
这个类的职责是：

•执行智能体的主循环；•调用工具（如 compute_savings）；•管理对话流转（处理用户输入与工具结果）；•兜底错误与无效输出（re-prompt 用户或请求澄清）。

核心逻辑基于一个 Runnable（可运行单元），它定义了调用 LLM 和工具的具体流程。

from langchain_core.runnables importRunnable

这些配置对于维持对话流程并确保助手基于上下文做出恰当响应至关重要。

第 5 步：使用 AWS Bedrock 配置 LLM

本步骤我们为智能体接入 AWS Bedrock 上的 LLM（如 Anthropic Claude），作为语言能力引擎。
要调用 AWS 服务，你必须先正确配置 AWS 凭据，否则无法连接 Bedrock 并运行模型。

常见凭据配置方式包括：

•通过 AWS CLI 登录并写入本地凭据（aws configure）•设置环境变量：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_SESSION_TOKEN（可选）、AWS_DEFAULT_REGION•使用可被 AWS SDK 访问的 credentials 文件（通常位于 ~/.aws/credentials）

完成凭据与区域设置后，即可创建 Bedrock Runtime 客户端，并实例化 LangChain 的 ChatBedrock：

import boto3

这一步的集成保证了助手能够有效理解并响应用户输入。

第 6 步：定义 Assistant 的工作流（Workflow）

在配置好 LLM 和 工具 之后，我们需要定义智能体的工作流。 工作流决定了智能体如何：

•与用户沟通；•何时收集所需信息（如月度电费）；•何时调用工具（如 compute_savings）；•如何将结果返回给用户。

核心部分是创建一个提示模板（Prompt Template），明确智能体的身份、对话目标与交互规则。

from langchain_core.prompts importChatPromptTemplate

•system 消息：作为智能体的“行为守则”，引导其向用户询问月度电费，若信息不明确就不要猜测，并持续追问直至收集到必要数据。•placeholder：用于动态注入对话历史，让助手能基于上下文持续对话，并让用户的上一轮输入影响下一步动作。

接下来，定义智能体交互中会用到的工具；主要工具是 compute_savings，它会基于用户的月度电费计算潜在节省。将工具列在清单里后，通过 llm.bind_tools() 绑定到助手工作流，使智能体在对话中按需触发工具，实现人与工具的无缝衔接。

# 定义助手在本阶段将使用的工具

第 7 步：构建图结构

本步骤使用 LangGraph 搭建智能体的状态图，控制助手如何处理用户输入、何时触发工具、以及各阶段之间的流转。
图中包含用于核心动作的节点（nodes），以及决定节点间走向的边（edges）。

用于计算太阳能节省的 AI 智能体流程图

在 LangGraph 中，每个 节点 代表一个操作步骤（如与用户交互或执行工具）。本示例定义两个关键节点：

•Assistant 节点：管理对话流程，向用户询问月度电费并处理响应；•Tool 节点：执行工具（如 compute_savings）来计算节省结果。

from langgraph.graph importStateGraph

边用于定义节点之间的流向。在本例中：

•助手（assistant）先发起对话；•当收集到所需输入后，转入工具节点；•工具执行完成后，返回助手节点继续对话或收尾。

builder.add_edge(START,"assistant")# 从起点进入 assistant

为确保对话在多步交互中能记住上下文，我们使用 MemorySaver 持久化图的会话状态（State）：

from langgraph.checkpoint.memory importMemorySaver

第 8 步：运行助手

最后，通过初始化图工作流并开始对话来运行助手。

# import shutil

结论

通过以上步骤，你已经成功构建了一个基于 LangGraph 的 AI 助手，它能够根据用户输入计算太阳能板节能效益。

本教程展示了 LangGraph 在管理复杂的多步骤流程中的强大能力，并突出了如何结合先进的 AI 工具来高效解决现实问题。

无论是开发用于 客户支持、能源管理 还是其他应用场景的 AI 智能体，LangGraph 都提供了你所需的：

•灵活性（Flexibility）：可定制复杂工作流；•可扩展性（Scalability）：支持从小规模实验到企业级部署；•稳健性（Robustness）：保证系统在长时运行与多轮交互中的可靠表现。

👉 借助 LangGraph，你可以更快地将 AI 创意转化为实用的智能系统，并让它们在真实世界中创造价值。

如何学习大模型 AI ？

我国在AI大模型领域面临人才短缺，数量与质量均落后于发达国家。2023年，人才缺口已超百万，凸显培养不足。随着Al技术飞速发展，预计到2025年，这一缺口将急剧扩大至400万，严重制约我国Al产业的创新步伐。加强人才培养，优化教育体系，国际合作并进，是破解困局、推动AI发展的关键。

但是具体到个人，只能说是：

“最先掌握AI的人，将会比较晚掌握AI的人有竞争优势”。

这句话，放在计算机、互联网、移动互联网的开局时期，都是一样的道理。

我在一线互联网企业工作十余年里，指导过不少同行后辈。帮助很多人得到了学习和成长。

我意识到有很多经验和知识值得分享给大家，也可以通过我们的能力和经验解答大家在人工智能学习中的很多困惑，所以在工作繁忙的情况下还是坚持各种整理和分享。但苦于知识传播途径有限，很多互联网行业朋友无法获得正确的资料得到学习提升，故此将重要的AI大模型资料包括AI大模型入门学习思维导图、精品AI大模型学习书籍手册、视频教程、实战学习等录播视频免费分享出来。

2025最新大模型学习路线

明确的学习路线至关重要。它能指引新人起点、规划学习顺序、明确核心知识点。大模型领域涉及的知识点非常广泛，没有明确的学习路线可能会导致新人感到迷茫，不知道应该专注于哪些内容。

对于从来没有接触过AI大模型的同学，我帮大家准备了从零基础到精通学习成长路线图以及学习规划。可以说是最科学最系统的学习路线。

针对以上大模型的学习路线我们也整理了对应的学习视频教程，和配套的学习资料。

大模型经典PDF书籍

新手必备的大模型学习PDF书单来了！全是硬核知识，帮你少走弯路！

配套大模型项目实战

所有视频教程所涉及的实战项目和项目源码等

博主介绍＋AI项目案例集锦

MoPaaS专注于Al技术能力建设与应用场景开发，与智学优课联合孵化，培养适合未来发展需求的技术性人才和应用型领袖。

这份完整版的大模型 AI 学习资料已经上传优快云，朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】

为什么要学习大模型？

2025人工智能大模型的技术岗位与能力培养随着人工智能技术的迅速发展和应用 ， 大模型作为其中的重要组成部分 ， 正逐渐成为推动人工智能发展的重要引擎 。大模型以其强大的数据处理和模式识别能力， 广泛应用于自然语言处理 、计算机视觉 、 智能推荐等领域 ，为各行各业带来了革命性的改变和机遇 。

适合人群

• 在校学生：包括专科、本科、硕士和博士研究生。学生应具备扎实的编程基础和一定的数学基础，有志于深入AGI大模型行业，希望开展相关的研究和开发工作。
• IT行业从业人员：包括在职或失业者，涵盖开发、测试、运维、产品经理等职务。拥有一定的IT从业经验，至少1年以上的编程工作经验，对大模型技术感兴趣或有业务需求，希望通过课程提升自身在IT领域的竞争力。
• IT管理及技术研究领域人员：包括技术经理、技术负责人、CTO、架构师、研究员等角色。这些人员需要跟随技术发展趋势，主导技术创新，推动大模型技术在企业业务中的应用与改造。
• 传统AI从业人员：包括算法工程师、机器视觉工程师、深度学习工程师等。这些AI技术人才原先从事机器视觉、自然语言处理、推荐系统等领域工作，现需要快速补充大模型技术能力，获得大模型训练微调的实操技能，以适应新的技术发展趋势。
  

课程精彩瞬间

大模型核心原理与Prompt：掌握大语言模型的核心知识，了解行业应用与趋势；熟练Python编程，提升提示工程技能，为Al应用开发打下坚实基础。

RAG应用开发工程：掌握RAG应用开发全流程，理解前沿技术，提升商业化分析与优化能力，通过实战项目加深理解与应用。

Agent应用架构进阶实践：掌握大模型Agent技术的核心原理与实践应用，能够独立完成Agent系统的设计与开发，提升多智能体协同与复杂任务处理的能力，为AI产品的创新与优化提供有力支持。

模型微调与私有化大模型：掌握大模型微调与私有化部署技能，提升模型优化与部署能力，为大模型项目落地打下坚实基础。

顶尖师资，深耕AI大模型前沿技术

实战专家亲授，让你少走弯路

一对一学习规划，职业生涯指导

• 真实商业项目实训
• 大厂绿色直通车

人才库优秀学员参与真实商业项目实训

以商业交付标准作为学习标准，具备真实大模型项目实践操作经验可写入简历，支持项目背调

大厂绿色直通车，冲击行业高薪岗位

文中涉及到的完整版的大模型 AI 学习资料已经上传优快云，朋友们如果需要可以微信扫描下方优快云官方认证二维码免费领取【保证100%免费】