LangGraph Agent 开发学习路线

  • 目标:从最小 demo 起步,按 langgraph.com.cn 官方导航逐级展开,覆盖 agent 开发全部知识点。
  • 模型:DeepSeek(OpenAI 兼容接口),key 放 .env
  • 配套:每课一个 demo 文件,概念记进 学习记录.md(用自己的话)。
  • 参照:https://langgraph.com.cn/

官方导航 ↔ 本路线 对照表(回答"规划全不全")

官方导航章节 覆盖课程 说明
开始使用 / 快速入门 L0 ✅ 已跑通
LangGraph基础 / 概述 L0–L1 跟做教程线
LangGraph基础 / 构建基本聊天机器人 L1 手搓图
LangGraph基础 / 添加工具 L2 ReAct 循环
LangGraph基础 / 添加记忆 L3 checkpointer
LangGraph基础 / 添加人工干预 L4 interrupt
LangGraph基础 / 自定义状态 L5 Reducer
LangGraph基础 / 时光旅行 L6 重放
预构建代理 / 概述 + 运行代理 L0 ✅ create_agent
预构建代理 / 流式传输 L7 stream
模型 L5、各课 init_chat_model / DeepSeek 差异
工具 L2、L8 ToolNode / MCP
MCP 集成 L8 补上
上下文 L5 configurable 补上
UI L12 生产化里带 补上
记忆 L3、L11 短期 + 长期
人工干预 L4
断点 L4 与人工干预同源 补上
多代理 L10 supervisor / handoff
评估 L12 LangSmith 补上
部署 L12 LangGraph Platform
LangGraph框架 / 代理架构 L1 概念深挖
LangGraph框架 / 图 L1、L5
LangGraph框架 / 流式传输 L7
LangGraph框架 / 持久化 L3
LangGraph框架 / 记忆 L3、L11
LangGraph框架 / 人工干预 + 断点 L4
LangGraph框架 / 时光旅行 L6
LangGraph框架 / 工具 L2、L8
LangGraph框架 / 子图 L9
LangGraph框架 / 多代理 L10

核心发现:官方导航同一主题出现两次(基础教程 vs 框架概念),是同一知识的两层深度——先跟教程"会用",再在概念章节"懂原理"。本路线每课都按这个套路来。

三阶段总览

阶段 定位 课程
一、地基 懂概念、跑通最小 demo L0 ✅
二、核心 跟官方"LangGraph基础"教程线:聊天机器人→工具→记忆→人工干预→状态→时光旅行 L1–L6
三、进阶 框架概念深挖 + 生产化:流式、MCP、子图、多代理、长期记忆、评估、部署 L7–L12

课程规划(13 课)

# 课程 文件 覆盖官方章节 核心概念
0 ✅ 快速入门 demo.py 快速入门、预构建代理 agent = 模型+工具+循环
1 构建基本聊天机器人 lesson01_chatbot.py 基础/构建聊天机器人、框架/代理架构+图 State / Node / Edge
2 ⭐ 添加工具(ReAct 循环) lesson02_tools.py 基础/添加工具、框架/工具 bind_tools / ToolNode / 条件边
3 添加记忆 lesson03_memory.py 基础/添加记忆、框架/持久化+记忆 checkpointer / thread_id
4 添加人工干预与断点 lesson04_human_loop.py 基础/添加人工干预、框架/人工干预+断点 interrupt / Command / breakpoint
5 自定义状态与上下文 lesson05_state.py 基础/自定义状态、框架/图、上下文、模型 Reducer / configurable / 模型配置
6 时光旅行 lesson06_timetravel.py 基础/时光旅行、框架/时光旅行 get_state / update_state / 重放
7 流式传输 lesson07_streaming.py 预构建代理/流式传输、框架/流式传输 stream_mode、token 流
8 工具进阶 + MCP 集成 lesson08_mcp.py 工具、MCP 集成 多工具、错误处理、接外部 MCP server
9 子图 lesson09_subgraph.py 框架/子图 嵌套图、状态隔离
10 多代理 lesson10_multiagent.py 多代理、框架/多代理 supervisor / handoff
11 长期记忆 lesson11_store.py 记忆、框架/记忆 Store / namespace
12 评估 + 部署 + UI lesson12_deploy.py 评估、部署、UI LangSmith、LangGraph Platform

学习路线图

graph LR
    L0[L0 快速入门 ✅] --> L1[L1 聊天机器人]
    L1 --> L2[L2 添加工具 ⭐]
    L2 --> L3[L3 添加记忆]
    L3 --> L4[L4 人工干预]
    L4 --> L5[L5 自定义状态]
    L5 --> L6[L6 时光旅行]
    L6 --> L7[L7 流式传输]
    L7 --> L8[L8 工具进阶+MCP]
    L8 --> L9[L9 子图]
    L9 --> L10[L10 多代理]
    L10 --> L11[L11 长期记忆]
    L11 --> L12[L12 评估+部署+UI]

每课固定套路

  1. 读 langgraph.com.cn 对应章节(先"基础"后"框架概念",两层深度)
  2. 我写 / 改 demo 文件
  3. 你跑通、看输出、提问
  4. 我用 course-wiki 模板生成 8 段式 wiki,存 wiki/
  5. 学习记录.md 记下概念(用自己的话)

时间规划(一个月学习 + 一个月项目)

现实判断

  • "一个月学完 13 课 + 一个月做项目" —— 来得及,前提是学习期每课写变体(跑通后自己改一个地方;光跑 demo 会高估掌握度)。
  • 目标定为「能独立做一个像样的 agent 项目」而不是「掌握全部知识」——前者一个月够,后者永远不够(框架在迭代)。

学习月 · 每周拆解(每天 1–2 小时)

课程 备注
W1 L1 聊天机器人 + L2 工具/ReAct ⭐ 最核心,占一半时间,不怕慢
W2 L3 记忆 + L4 人工干预 + L5 自定义状态 L5 的 Reducer 最难,卡住先跳过
W3 L6 时光旅行 + L7 流式 + L8 MCP + L9 子图 技能清单,每个 1 天
W4 L10 多代理 + L11 长期记忆 + L12 评估/部署 + 复习 周末定下项目题目

项目月 · 选题三原则

  1. 用得到核心三角:工具 + 记忆 + 人工干预(多数生产 agent 的真实形态)。
  2. 用熟悉领域:有股票工具 / 管理后台 / 数据开发经验 → 金融分析、数据报告 agent 是好方向。
  3. 两周出 MVP:前两周最小可用,后两周打磨 + 查漏补缺。

卡点预案

  • L4 interrupt 和 L5 Reducer 是公认两个难点:卡住别恋战,先往后走通流程,回头再补(不阻塞后面的课)。
  • 概念没懂就回炉,别带夹生饭进项目期——项目期返工成本远高于学习期补一遍。

注意事项

  • 每课只加一个新概念,先跑通再讲原理。
  • DeepSeek vs Claude:tool calling 支持良好;结构化输出弱会降级;token 便宜适合多跑。
  • 概念以"自己能讲出来"为准,讲不出来就回炉。
  • 对照表里标"补上"的章节是我第一版漏掉的,现在全覆盖了。