本索引对应 02.开发-16.Agent-Langgraph 目录下的 LangGraph 图编排教程专篇。
与 LangGraph-00.概述与安装 配合：概述讲安装与最小图；本表用于按主题跳转与规划写作。
边界：ChatModel、Prompt、Tool schema 见 02.开发-16.Agent-langchain/；Agent 通用原理见 02.开发-16.Agent开发/。
段末注释：HITL（human-in-the-loop，人在回路）= 关键步骤暂停，等待人类确认后再继续执行图。
1. 如何使用本索引
| 符号 | 含义 |
|---|---|
| ✅ | 已发布 |
| 📝 | 规划中文稿，尚未发布 |
| 🔗 外延 | 相关但不在本目录 |
专篇文件名：LangGraph-{模块}-{主题}.md。
2. 推荐阅读顺序（总表）
| 序号 | 专篇 | 状态 | 核心问题 |
|---|---|---|---|
| 00 | 概述与安装 | ✅ | 装什么？最小 StateGraph 怎么跑？ |
| 01 | 图基础-StateGraph与节点 | ✅ | 如何 add_node、固定边、invoke？ |
| 02 | 状态-TypedDict与Reducer | ✅ | 为何需要 add_messages？并行写入如何合并？ |
| 03 | 路由-conditional-edges | ✅ | router 与 path_map 如何配合？ |
| 04 | 持久化-checkpoint与thread_id | ✅ | 检查点存什么？如何多轮续跑？ |
| 05 | 中断-interrupt与HITL | ✅ | 如何在节点前暂停、如何 resume？ |
| 06 | 流式-stream与stream_mode | ✅ | updates / values / messages 事件有何不同？ |
| 07 | 预构建-create_react_agent（弃用） | ✅ | 旧 ReAct 预构建；新代码用 create_agent |
| 08 | 子图-Subgraph与组合 | ✅ | 多 Agent 如何复用子图？ |
| 09 | 调试-时间旅行与状态回溯 | ✅ | get_state / get_state_history 怎么用？ |
| 10 | 存储-Store与长期记忆 | ✅ | 跨 thread 的长期记忆如何存？ |
| 11 | 持久化-Sqlite与Postgres | ✅ | 生产 checkpointer 如何配置？ |
| 12 | 异步-ainvoke与并发 | ✅ | 异步图 API 与 FastAPI 集成 |
3. 按模块分组
3.1 图基础（Graph）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-01-图基础-StateGraph与节点 | ✅ | StateGraph、START、END、add_node |
| LangGraph-01-图基础-START与END | ✅ | 入口、终止条件 |
| LangGraph-01-图基础-并行与Send | ✅ | Send、动态扇出（进阶） |
3.2 状态（State）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-02-状态-TypedDict与Reducer | ✅ | Annotated、add_messages |
| LangGraph-02-状态-PydanticState | ✅ | BaseModel、Field、Annotated 双通道 |
| LangGraph-02-状态-自定义Reducer | ✅ | add_messages、Overwrite、自定义 (left, right) |
3.3 路由（Routing）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-03-路由-conditional-edges | ✅ | add_conditional_edges、path_map |
| LangGraph-03-路由-Command与动态跳转 | ✅ | Command、goto（进阶 API） |
3.4 持久化（Persistence）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-04-持久化-checkpoint与thread_id | ✅ | InMemorySaver、configurable |
| LangGraph-11-持久化-Sqlite与Postgres | ✅ | SqliteSaver、PostgresSaver |
| LangGraph-04-持久化-checkpoint_ns | ✅ | 多租户 namespace（进阶） |
3.5 人机协同（HITL）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-05-中断-interrupt与HITL | ✅ | interrupt_before、interrupt_after |
| LangGraph-05-中断-update_state与resume | ✅ | 人工输入写回 state |
3.6 流式与观测（Stream & Debug）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-06-流式-stream与stream_mode | ✅ | stream_mode="updates" |
| LangGraph-09-调试-时间旅行与状态回溯 | ✅ | get_state_history |
| LangGraph-09-调试-LangSmith追踪 | ✅ | trace 图节点 |
3.7 预构建与组合（Prebuilt & Composition）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-07-预构建-create_react_agent（弃用） | ✅ | 改用 langchain.agents.create_agent |
| LangGraph-08-子图-Subgraph与组合 | ✅ | 嵌套 compile、多 Agent |
| LangGraph-10-存储-Store与长期记忆 | ✅ | LangGraph Store API |
3.8 生产与集成（Production）
| 专篇 | 状态 | 关键词 |
|---|---|---|
| LangGraph-12-异步-ainvoke与并发 | ✅ | ainvoke、astream |
| LangGraph-13-集成-FastAPI与SSE | ✅ | 与 Agent-10-05 对照 |
| LangGraph-14-集成-Temporal外层编排 | ✅ | 长任务边界（外延 Agent-10-10） |
4. 与 Agent-10 / Agent-编排 的对照
| 外延文档 | 本目录建议专篇 |
|---|---|
| Agent-编排-主流框架综述与选型 | 跨框架选型；LangGraph API 见本目录 |
| Agent-10-09 本仓库 orchestrator | 工程落地案例，非 API 教程 |
| Agent-10-08 HITL | 05 interrupt、04 checkpoint |
| Agent-10-09 多 Agent 编排 | 01～03 图基础 + 08 Subgraph |
| Agent-10-05 FastAPI 流式 | 06 stream、13 FastAPI 集成 |
5. 与 LangChain 目录的衔接
| LangChain 能力 | LangGraph 专篇 |
|---|---|
| Messages、Tool | create_agent 或 01 节点内自写 model+tool（07 create_react_agent 已弃用） |
| LCEL 线性链 | 简单场景不必上图；见 LangChain 索引 |
| Structured Output | 作为图中某一节点职责 |
推荐路径：LangChain 00 → 03 Tool → LangGraph 00 → 01 → 04 → 05。
6. 学习路径速查（按痛点）
| 痛点 | 优先专篇 |
|---|---|
| 工具失败要重试 | 01 图基础 + 03 条件边（环回 LLM 节点） |
| 多轮对话要记住上下文 | 04 checkpoint + thread_id |
| 删库/发信前要人工点确认 | 05 interrupt + HITL |
| 前端要流式进度 | 06 stream |
| 不想从零画全图 | LangChain create_agent（07 create_react_agent 已弃用，仅对照拓扑） |
| 多角色分工 | 08 Subgraph |
| 上线要 Postgres 存状态 | 11 持久化 |
7. 专篇结构约定（读者可见）
每篇默认包含：
- 节点表 + 边表（先于代码）
- 场景切入与定位表
- invoke 生命周期（手算 state）
- 原理说明（底层执行链路：channels / reducer / checkpoint 读写时机；对象挂步骤，禁止只列功能）
- 最小可运行示例（优先 mock 节点）
- 重要配置参数表（含功能说明列）
- 执行追踪（≥2 步 state 变化；含环时 ≥2 轮）
- 易踩坑（≥2 条）
- 小结与官方链接；弃用主题的
title带「（弃用）」
8. 维护说明（作者）
发布新专篇后更新本表状态与链接。
结构与命名以 00.范式-LangGraph教程介绍.md 为准（读者正文不引用）。