Skip to article frontmatterSkip to article content

LangGraph 1.0 完全指南

LangGraph 是由 LangChain 团队开发的开源 Agent 框架。它功能强大,尤其是 v1.0 之后,框架能力进一步升级。v1.0 是开发团队承诺的稳定版,预计未来接口不会大改,因此现在正是学习它的好时机。

根据 PyPI 的记录,LangGraph 1.0.0 发布于 2025 年 10 月 18 日。距今不过一个多月。当今市面上的代码大多基于 v0.6,本教程希望弥合这一差距。

1)LangGrpah 的优势

LangGrpah 很强大。你要的记忆、MCP、护栏、状态管理、多智能体 ...... 它全都有。我们知道,智能体承接的需求是极其复杂的,很容易造成框架代码膨胀、复杂度失控等问题。LangGrpah 1.0 是如何解决这个问题的呢?它引入了 中间件(Middleware)这个新特性。中间件是一种钩子函数,通过向工作流中预埋中间件,可以实现工作流的高效拓展和可定制化。

2)本教程的优势

那你会说了,有官方文档还看你干嘛?

但是本教程是一款基于 Jupyter Notebook 的可交互教程,每个章节均可独立运行。而官方文档代码不全,只展示需要讲解的部分代码。也就是说,官方文档注重概念讲解,而本教程更关注具体实践。

承诺:本教程完全基于 LangGraph v1.0 编写,不含任何 v0.6 的历史残留。

一、章节目录

本教程的内容速览:

序号章节
1快速入门
2状态图
3中间件
4人机交互
5记忆
6上下文工程
7MCP Server
8监督者模式
9并行
10Deep Agents
11调试界面

未出现在上述章节但比较重要的代码,我放在仓库的 tests 目录下:

代码说明
test_rag.py使用 RAG 将本地文档片段注入智能体
test_langmem.py使用 LangMeM 管理智能体长期记忆
test_store.py使用 RedisStore 快速读写长期记忆
test_router.py实现一个简单的智能体路由

二、调试界面

langgraph-cli 提供了一个可快速启动的调试界面。

langgraph dev

详见 第11章

三、拓展阅读

✨ 如果你觉得这个项目对你有帮助,欢迎 Star 本仓库:luochang212/dive-into-langgraph