Agent实战教程：LangGraph相关概念介绍以及快速入门

最近在搭建Agent，包括之前也写过一些智能体编排的流程，不过在构建项目的时候以及调研相关资源，当前发现Agent框架中LangGprah的资源是较多的，文档也比较完善，感觉又回到了之前Langchain流行的感觉。笔者花了几个小时大致把LangGraph一些基础概念包括调用快速过了一遍，后续会使用LangGraph搭建一些有趣的应用。主要参考流程来自LangGraph官方教程

另外之前发过不少关于Agent的理论文章，不懂相关概念的大家也可以查看历史文章

LangGraph官方链接：https://langchain-ai.github.io/langgraph/

前序准备

在使用LangGraph之前，我们先提前准备一些基础知识以及相关概念的了解，方便我们了解后续代码

Langchain的ChatModel

我们清楚Agent的主要通过设计提示语，然后调用模型，完成对应流程与目标输出，所以在构建智能体之前，我们首先搞明白如何调用大模型，langchain框架提供了很多厂商的调用方式，使用文档在这里：

https://python.langchain.com/api_reference/langchain/chat_models.html

虽然聊天模型在底层使用了语言模型，但它们暴露的接口略有不同。它们并没有暴露“文本输入、文本输出”的 API，而是暴露了一个以“聊天消息”作为输入和输出的接口。下面支持的模型厂商列表

langchain有个方法init_chat_model，可以初始化各种厂商的模型，同时也提供了不同大模型的调用sdk,下面是deepseek的例子：

from langgraph.prebuilt import create_react_agent
from langchain_deepseek import ChatDeepSeek
from dotenv import load_dotenv

load_dotenv(verbose=True)

model=ChatDeepSeek(
    model="deepseek-chat",
    temperature=0,
    max_tokens=None,
    timeout=None,
    max_retries=2,
)

response=model.invoke("你好,请帮我生成一首儿歌")
print(response)

模型输出如下：

{
  "content": "当然！这里有一首温馨可爱的儿歌，适合小朋友传唱：\n\n---\n\n**《小星星的梦》**  \n✨🌙🎵  \n\n小星星，眨眼睛，  \n躲在云端放光明。  \n月亮船，摇啊摇，  \n载着梦儿轻轻飘。  \n\n萤火虫，提灯笼，  \n照亮花园小草丛。  \n风儿唱，树叶响，  \n伴我进入甜梦乡。  \n\n——  \n希望这首简单又充满画面感的儿歌能让宝贝喜欢！如果需要主题调整（比如动物、季节等），可以告诉我哦 😊",
  "additional_kwargs": {
    "refusal": null
  },
  "response_metadata": {
    "token_usage": {
      "completion_tokens": 120,
      "prompt_tokens": 12,
      "total_tokens": 132,
      "completion_tokens_details": null,
      "prompt_tokens_details": {
        "audio_tokens": null,
        "cached_tokens": 0
      },
      "prompt_cache_hit_tokens": 0,
      "prompt_cache_miss_tokens": 12
    },
    "model_name": "deepseek-chat",
    "system_fingerprint": "fp_feb633d1f5_prod0820_fp8_kvcache",
    "id": "866e04cd-5b1c-41cd-a7c6-a4140f4bcd05",
    "service_tier": null,
    "finish_reason": "stop",
    "logprobs": null
  },
  "id": "run--d3ffbc2a-d62b-49e5-8daa-981205501093-0",
  "usage_metadata": {
    "input_tokens": 12,
    "output_tokens": 120,
    "total_tokens": 132,
    "input_token_details": {
      "cache_read": 0
    },
    "output_token_details": {}
  }
}

这个JSON输出代表了一次完整的AI生成过程的结果，整个结构可以分为两大部分：核心内容和元数据。

核心内容

这是用户直接收到的、最有价值的部分：

元数据 (系统信息)

这些字段提供了关于此次生成过程的背景技术信息，对开发者非常有用：

ReAct框架

《REACT: SYNERGIZING REASONING AND ACTING IN LANGUAGE MODELS》，由Shunyu Yao等人撰写，发表在2023年的ICLR会议上。论文探讨了如何在大型语言模型（LLMs）中结合推理（reasoning）和行动（acting）的能力，以提高模型在语言理解和交互式决策制定任务中的性能。

其中ReAct Agent就是核心动作就是推理+行动

主要观点：

ReAct（Reasoning and Acting）是一种结合了推理（reasoning）和行动（acting）的方法，旨在提高大型语言模型（LLMs）在解决复杂任务时的性能和可解释性。ReAct的具体步骤如下：

下面是一个 ReAct 提示的示例(摘自论文，为简单起见缩短为一个示例):

问题 科罗拉多造山带东部区域延伸到的区域的海拔范围是多少? 思考 1 我需要搜索科罗拉多造山带，找到科罗拉多造山带东段延伸的区域，然后找到该区域的海拔范围。 操作 1 搜索 [科罗拉多造山带] 观察 1 科罗拉多造山带是科罗拉多及其周边地区造山运动的一段。 思考 2 它没有提到东部地区。所以我需要查一下东部地区。 操作 2 查找 [东部地区] 观察 2 (结果 1 / 1) 东部区域延伸至高平原，称为中原造山带。 思考 3 科罗拉多造山运动的东部区域延伸到高平原。所以我需要搜索高平原，找到它的海拔范围。 操作 3 搜索 [高平原] 观察 3 高平原指的是两个截然不同的陆地区域之一。 思考 4 我需要搜索高平原（美国） 操作 4 搜索 [高平原（美国）] 观察 4 高平原是大平原的一个分区。从东到西，高平原的海拔从 1800 到 7000 英尺 (550 到 2130 米) 不等。[3] 思考 5 高平原海拔高度从 1800 到 7000 英尺，所以答案是 1800 到 7000 英尺。 操作 5 结束 [1800 到 7000 英尺] ...

ReAct的核心在于通过交错的推理和行动步骤，使模型能够在执行任务时动态地进行推理和行动，从而提高任务解决的准确性和效率。这种方法特别适用于需要与外部环境交互并从中获取信息以支持决策的任务。

LangGraph快速入门

构建ReactAgent

为了避免缺少环境，我们可以提前安装langchain套件：

pip install langchain langchain-core 

安装 LangGraph：

pip install -U langgraph

然后，使用预构建的组件（这里指的react_agent模板）创建智能体：

from langgraph.prebuilt import create_react_agent
from langchain_deepseek import ChatDeepSeek
from dotenv import load_dotenv

load_dotenv(verbose=True)

model=ChatDeepSeek(
    model="deepseek-chat",
    temperature=0,
    max_tokens=None,
    timeout=None,
    max_retries=2,
)

# response=model.invoke("你好,请帮我生成一首儿歌")
# print(response)
def get_weather(city: str) -> str:
    """Get weather for a given city."""
    return f" {city}的天气是晴朗的!"

agent = create_react_agent(
    model=model,
    tools=[get_weather],
    prompt="你是一个有用的助手"
)

# Run the agent
response=agent.invoke(
    {"messages": [{"role": "user", "content": "请问北京的天气怎么样"}]}
)

print(response)

我们可以答应下输出，这里为了方便查看，我整理成json了：

{
  "messages": [
    {
      "type": "human",
      "content": "请问北京的天气怎么样",
      "additional_kwargs": {},
      "response_metadata": {},
      "id": "72b50e8e-e20f-4d2e-8add-4993747de54e"
    },
    {
      "type": "ai",
      "content": "我来帮您查询北京的天气情况。",
      "additional_kwargs": {
        "tool_calls": [
          {
            "id": "call_0_4e1e8263-3930-4052-b272-26d618f4301d",
            "function": {
              "arguments": "{\"city\": \"\\u5317\\u4eac\"}",
              "name": "get_weather"
            },
            "type": "function",
            "index": 0
          }
        ],
        "refusal": null
      },
      "response_metadata": {
        "token_usage": {
          "completion_tokens": 28,
          "prompt_tokens": 155,
          "total_tokens": 183,
          "completion_tokens_details": null,
          "prompt_tokens_details": {
            "audio_tokens": null,
            "cached_tokens": 0
          },
          "prompt_cache_hit_tokens": 0,
          "prompt_cache_miss_tokens": 155
        },
        "model_name": "deepseek-chat",
        "system_fingerprint": "fp_feb633d1f5_prod0820_fp8_kvcache",
        "id": "41400771-a017-484c-970c-d697720af00b",
        "service_tier": null,
        "finish_reason": "tool_calls",
        "logprobs": null
      },
      "id": "run--09d15b9b-e85f-4ec2-968a-ca1051321606-0",
      "tool_calls": [
        {
          "name": "get_weather",
          "args": {
            "city": "北京"
          },
          "id": "call_0_4e1e8263-3930-4052-b272-26d618f4301d",
          "type": "tool_call"
        }
      ],
      "usage_metadata": {
        "input_tokens": 155,
        "output_tokens": 28,
        "total_tokens": 183,
        "input_token_details": {
          "cache_read": 0
        },
        "output_token_details": {}
      }
    },
    {
      "type": "tool",
      "content": "北京的天气是晴朗的!",
      "name": "get_weather",
      "id": "f47a51d0-9b26-4eb4-8d3b-f1e4f02520bb",
      "tool_call_id": "call_0_4e1e8263-3930-4052-b272-26d618f4301d"
    },
    {
      "type": "ai",
      "content": "根据查询结果，北京目前的天气是晴朗的！天气状况很好，适合外出活动。如果您需要更详细的天气信息（如温度、湿度、风力等），请告诉我，我可以为您提供更全面的天气情况。",
      "additional_kwargs": {
        "refusal": null
      },
      "response_metadata": {
        "token_usage": {
          "completion_tokens": 45,
          "prompt_tokens": 187,
          "total_tokens": 232,
          "completion_tokens_details": null,
          "prompt_tokens_details": {
            "audio_tokens": null,
            "cached_tokens": 128
          },
          "prompt_cache_hit_tokens": 128,
          "prompt_cache_miss_tokens": 59
        },
        "model_name": "deepseek-chat",
        "system_fingerprint": "fp_feb633d1f5_prod0820_fp8_kvcache",
        "id": "63d43631-9171-4fb0-98c0-6470313d7798",
        "service_tier": null,
        "finish_reason": "stop",
        "logprobs": null
      },
      "id": "run--47611254-733a-4d55-b002-96a17b131a02-0",
      "usage_metadata": {
        "input_tokens": 187,
        "output_tokens": 45,
        "total_tokens": 232,
        "input_token_details": {
          "cache_read": 128
        },
        "output_token_details": {}
      }
    }
  ]
}

这是一个多轮对话的完整记录，描述了用户查询北京天气后，AI调用工具并返回结果的整个过程。对话包含4条消息：

记忆持久化

为了允许与智能体进行多轮对话，我们需要在创建智能体时提供检查点来启用持久性thread_id。在运行时，LangGraph需要提供一个配置，其中包含对话（会话）的唯一标识符，下面是一个例子：

from langgraph.prebuilt import create_react_agent
from langchain_deepseek import ChatDeepSeek
from dotenv import load_dotenv
from langgraph.checkpoint.memory import InMemorySaver
load_dotenv()
model=ChatDeepSeek(
    model="deepseek-chat",
    temperature=0,
    max_retries=2,
)
# 定义一个简单的工具函数
def get_weather(city: str) -> str:
    """获取天气信息"""
    weather_data = {
        "北京": "晴天，25°C",
        "上海": "多云，28°C",
        "深圳": "小雨，26°C"
    }
    return weather_data.get(city, f"{city}天气暂无数据")

# 创建内存检查点
checkpointer = InMemorySaver()

# 创建带记忆的代理
agent = create_react_agent(
    model=model,
    tools=[get_weather],
    checkpointer=checkpointer
)

# 配置会话ID
config = {"configurable": {"thread_id": "chat-001"}}

# 第一轮对话
print("=== 第一轮对话 ===")
response1 = agent.invoke(
    {"messages": [{"role": "user", "content": "你好，我叫张三，请查询北京天气"}]},
    config
)
print("用户: 你好，我叫张三，请查询北京天气")
print("助手:", response1['messages'][-1].content)

# 第二轮对话 - 测试记忆功能
print("\n=== 第二轮对话 ===")
response2 = agent.invoke(
    {"messages": [{"role": "user", "content": "我叫什么名字？"}]},
    config
)
print("用户: 我叫什么名字？")
print("助手:", response2['messages'][-1].content)

# 第三轮对话 - 继续使用记忆
print("\n=== 第三轮对话 ===")
response3 = agent.invoke(
    {"messages": [{"role": "user", "content": "上海天气怎么样？"}]},
    config
)
print("用户: 上海天气怎么样？")
print("助手:", response3['messages'][-1].content)

下面是输出：

=== 第一轮对话 === 用户: 你好，我叫张三，请查询北京天气 助手: 根据查询结果，北京目前的天气情况是： - 天气状况：晴天 - 温度：25°C  今天北京的天气很不错呢，是个晴朗的好天气，温度也很舒适！  === 第二轮对话 === 用户: 我叫什么名字？ 助手: 你刚才告诉我你叫张三！很高兴认识你，张三！  === 第三轮对话 === 用户: 上海天气怎么样？ 助手: 根据查询结果，上海目前的天气情况是： - 天气状况：多云 - 温度：28°C  上海今天是多云天气，温度比北京稍高一些，28°C，也是比较舒适的天气呢！

结构化输出

要生成符合特定模式的结构化响应，我们可以使用response_format参数。该模式可以使用Pydantic模型或定义TypedDict。结果可通过structured_response字段访问。

我们设置好调用大模型：

from langgraph.prebuilt import create_react_agent
from langchain_deepseek import ChatDeepSeek
from dotenv import load_dotenv
from pydantic import BaseModel
from typing import List, Optional
load_dotenv()
model=ChatDeepSeek(
    model="deepseek-chat",
    temperature=0,
    max_retries=2,
)

下面是一个例子：

# 定义工具函数
def get_weather(city: str) -> str:
    """获取城市天气信息"""
    weather_data = {
        "北京": "晴天，气温25°C，空气质量良好",
        "上海": "多云转阴，气温28°C，湿度80%",
        "深圳": "小雨，气温26°C，风力3级",
        "广州": "阴天，气温30°C，空气质量中等"
    }
    return weather_data.get(city, f"{city}暂无天气数据")

def search_restaurant(city: str, cuisine: str = "") -> str:
    """搜索餐厅信息"""
    restaurants = {
        "北京": "老北京炸酱面馆、全聚德烤鸭店、海底捞火锅",
        "上海": "小笼包店、本帮菜馆、外滩西餐厅",
        "深圳": "潮汕牛肉火锅、茶餐厅、海鲜大排档"
    }
    return restaurants.get(city, f"{city}暂无餐厅推荐")

# 示例1: 天气查询结构化响应
class WeatherResponse(BaseModel):
    """天气查询响应格式"""
    city: str                    # 城市名称
    conditions: str              # 天气状况
    temperature: Optional[str]   # 温度信息
    additional_info: Optional[str]  # 附加信息

# 创建天气查询代理
weather_agent = create_react_agent(
    model=model,
    tools=[get_weather],
    response_format=WeatherResponse
)

print("=== 示例1: 天气查询结构化输出 ===")
weather_response = weather_agent.invoke(
    {"messages": [{"role": "user", "content": "查询北京的天气情况"}]}
)

然后我们可以通过字典属性来获取对应的输出值：

print("用户: 查询北京的天气情况")
print("结构化响应:")
print(f"  城市: {weather_response['structured_response'].city}")
print(f"  天气状况: {weather_response['structured_response'].conditions}")
print(f"  温度: {weather_response['structured_response'].temperature}")
print(f"  附加信息: {weather_response['structured_response'].additional_info}")

输出如下：

=== 示例1: 天气查询结构化输出 ===
用户: 查询北京的天气情况
结构化响应:
  城市: 北京
  天气状况: 晴天
  温度: 25°C
  附加信息: 空气质量良好

我们定义一个餐厅推荐结构化输出：

# 示例2: 餐厅推荐结构化响应
class RestaurantRecommendation(BaseModel):
    """餐厅推荐响应格式"""
    city: str                           # 城市
    restaurants: List[str]              # 餐厅列表
    cuisine_type: Optional[str]         # 菜系类型
    recommendation_reason: str          # 推荐理由

# 创建餐厅推荐代理
restaurant_agent = create_react_agent(
    model=model,
    tools=[search_restaurant],
    response_format=RestaurantRecommendation
)

print("\n=== 示例2: 餐厅推荐结构化输出 ===")
restaurant_response = restaurant_agent.invoke(
    {"messages": [{"role": "user", "content": "推荐上海的好餐厅"}]}
)

print("用户: 推荐上海的好餐厅")
print("结构化响应:")
print(f"  城市: {restaurant_response['structured_response'].city}")
print(f"  餐厅列表: {restaurant_response['structured_response'].restaurants}")
print(f"  菜系类型: {restaurant_response['structured_response'].cuisine_type}")
print(f"  推荐理由: {restaurant_response['structured_response'].recommendation_reason}")

输出如下：

=== 示例2: 餐厅推荐结构化输出 ===
用户: 推荐上海的好餐厅
结构化响应:
  城市: 上海
  餐厅列表: ['小笼包店', '本帮菜馆', '外滩西餐厅']
  菜系类型: None
  推荐理由: 上海作为国际化大都市，既有传统本帮菜和小笼包等特色美食，也有高档西餐厅，能够满足不同口味需求

最后我们可以将这两个例子整合成一个旅行的综合查询结构化输出样例：

# 示例3: 综合查询结构化响应
class TravelInfo(BaseModel):
    """旅行信息响应格式"""
    destination: str                    # 目的地
    weather_info: str                   # 天气信息
    restaurant_suggestions: List[str]   # 餐厅建议
    travel_tips: List[str]              # 旅行建议
    overall_rating: str                 # 总体评价

# 创建旅行助手代理
travel_agent = create_react_agent(
    model=model,
    tools=[get_weather, search_restaurant],
    response_format=TravelInfo
)

print("\n=== 示例3: 旅行信息结构化输出 ===")
travel_response = travel_agent.invoke(
    {"messages": [{"role": "user", "content": "我想去深圳旅游，给我一些建议"}]}
)

print("用户: 我想去深圳旅游，给我一些建议")
print("结构化响应:")
print(f"  目的地: {travel_response['structured_response'].destination}")
print(f"  天气信息: {travel_response['structured_response'].weather_info}")
print(f"  餐厅建议: {travel_response['structured_response'].restaurant_suggestions}")
print(f"  旅行建议: {travel_response['structured_response'].travel_tips}")
print(f"  总体评价: {travel_response['structured_response'].overall_rating}")

我们可以看到输出如下:

=== 示例3: 旅行信息结构化输出 ===
用户: 我想去深圳旅游，给我一些建议
结构化响应:
  目的地: 深圳
  天气信息: 小雨，气温26°C，风力3级
  餐厅建议: ['潮汕牛肉火锅', '茶餐厅', '海鲜大排档']
  旅行建议: ['携带雨具出行，准备轻便夏装和薄外套', '使用深圳地铁系统出行，下载"深圳通"APP', '参观世界之窗、欢乐谷、深圳湾公园等景点', '考虑去香港一日游（需提前办理港澳通行证）']
  总体评价: 现代化大都市，购物和美食天堂，交通便利，适合城市旅游和商务出行

LangGraph教程合集

LangGraph 官方教程站（持续更新）
https://langchain-ai.github.io/langgraph/

LangGraph 官方文档翻译 1：快速入门
https://blog.csdn.net/lovechris00/article/details/148014663 

构建数学 Agent：工具调用 + 结果验证 + 流程总结
文章：https://blog.csdn.net/sjxgghg/article/details/147250916
源码：https://github.com/JieShenAI/csdn/tree/main/25/04/math_agent 

《2025 吃透 LangGraph 全套教程》47 集合集
https://www.bilibili.com/video/BV1wsoiYQENQ/

GitHub 官方示例仓库
https://github.com/langchain-ai/langgraph-example 
Awesome LangGraph 精选项目列表
https://github.com/von-development/awesome-LangGraph 
Tools_and_Agents：多工具 Agent 实战代码
https://github.com/anmolaman20/Tools_and_Agents

参考资料

https://www.promptingguide.ai/zh/techniques/react

https://www.promptingguide.ai/zh/techniques/react

未完待续，后面还有连载