LangChain 百日进阶 shixingxingai/agent-100day

LangChain / LangGraph 系统学习教程

本项目是一套面向实践的 LangChain 与 LangGraph 中文学习教程，覆盖从模型调用、提示词和工具，到 RAG、Agent、评测与生产部署的完整学习路径。每个阶段包含学习目标、核心概念、示例、练习和自测内容，并配有记忆卡片与复习材料。

学习路径

建议按阶段顺序学习：

1. 基础与应用主线（01–09）：ChatModel、Prompt 与输出解析、工具、RAG、LCEL、LangGraph、Agent、LangSmith 追踪和多代理。
2. 评测与生产化（10–19）：评测、上下文工程、记忆、人工审批、MCP、进阶 RAG、流式服务、部署、安全和成本治理。
3. 复习资料（20–23）：速查与面试追问（含术语表与新旧 API 迁移对照表）、核心概念地图、记忆口诀与类比、闪卡与间隔重复计划。
4. 补充篇（24–27）：异步与并发、测试策略、生产监控与告警、端到端实战项目——按需插入主线（24 配合阶段 05/16、25 配合阶段 17、26 配合阶段 08/17、27 在全部学完后做）。
5. 进阶 / 前瞻篇（28–32）：LangGraph 进阶（Send/重试/缓存）、语音与实时 Agent、浏览器与 Computer-use、私有化部署与自托管推理、模型微调与 SLM 路由——按目标岗位选修，不必全做，但至少要有一项能讲透。

从总览与学习路线开始，查看各阶段的目标、预计耗时和 90 天学习计划。迷路时参考核心概念地图；遇到陌生名词查术语表；照抄老教程报错先对新旧 API 迁移对照表；复习时使用闪卡与间隔重复计划和 flashcards-anki.csv。

版本前提：本教程基于 LangChain 1.x 与 LangGraph 1.x 编写（定稿 2026-09），建议 Python ≥ 3.10。1.x 有破坏性变更（导入路径重组、组件拆包、部分能力迁至 langchain-classic），详见 00 总览开头的说明与附录 20 的迁移对照表。

目录

| 阶段 | 内容 |
| 01–03 | ChatModel、Prompt 与输出解析、Tool 工具系统 |
| 04–07 | RAG 流水线、LCEL、LangGraph 基础、create_agent |
| 08–10 | LangSmith 追踪、多代理架构、评测 Evals |
| 11–14 | 上下文工程、记忆系统、Human-in-the-loop、MCP |
| 15–19 | RAG 进阶、流式与服务化、部署与工程化、安全与 Guardrails、成本与多模型路由 |
| 20–23 | 附录：速查与面试追问（含术语表 + 迁移对照表）、核心概念地图、记忆口诀与类比大全、闪卡与间隔重复计划 |
| 24–27 | 补充：异步与并发、补充：测试策略、补充：生产监控与告警、实战：端到端 Agent 项目 |
| 28–32 | 进阶：LangGraph 进阶、前瞻：语音与实时 Agent、前瞻：浏览器与 Computer-use、前瞻：私有化部署与自托管推理、前瞻：模型微调与 SLM 路由 |

环境准备

教程示例使用 Python。按需安装各章节所需依赖；以下是总览中给出的常用环境示例：

python -m venv .venv

Windows PowerShell
.venv\Scripts\Activate.ps1

macOS / Linux
source .venv/bin/activate

pip install -U langchain langchain-openai langchain-community
pip install -U langchain-text-splitters langchain-chroma pypdf
pip install -U langgraph langsmith pydantic python-dotenv

按阶段追加依赖（用到哪章装哪个，各章"步骤 1：安装依赖"有说明）：

pip install -U langchain-classic rank-bm25 langchain-postgres langgraph-checkpoint-postgres
pip install -U 'langchain[mcp]' ragas fastapi uvicorn
pip install -U "langgraph-cli[inmem]"

部分示例需要模型提供方的 API 密钥或 LangSmith 配置。请按照相应章节的说明，通过环境变量或本地环境文件配置；不要把密钥提交到版本控制中。

使用建议

- 每章先读学习目标，再运行示例并完成练习和自测。
- 建议从阶段 01 开始按顺序推进；阶段 04、07、10、17 可作为 RAG、智能体、评测和部署的实践关卡。
- 学习时尽早接入追踪和评测，持续记录问题并把典型错误加入自己的评测样本。
- 使用第 23 阶段的 1/3/7/14/30 天复习节奏巩固知识。

更多学习说明和完整路线见总览与学习路线。