LangChain
LangChain 使用文档
LangChain(Python 版)使用文档总览:19 节正课分入门、RAG、进阶三阶段外加综合项目,每节解决一类使用问题——先讲组件是什么,再给可运行代码,最后列参数与常见坑。基于 LangChain 1.x。
- LangChain
本目录是 LangChain(Python 版)的使用文档,基于 LangChain 1.x 重写。每节解决一类使用问题:先讲清楚组件是什么,再给可运行代码,最后列参数与常见坑。
怎么学
19 节正课按序号顺序学,每节 15~30 分钟:读一节,跑一节里的代码,改几个参数看输出变化。分三个阶段外加一个综合项目,每个阶段结束都能做出一个能用的东西:
- 第一阶段(01~07):入门。学完能拼链、做结构化输出。
- 第二阶段(08~13):RAG。学完能搭一个私域知识问答。
- 第三阶段(14~18):进阶。学完能做多轮对话、工具调用、LangGraph 和流式 API 服务。
- 综合项目(19):把前面所有组件焊成一套完整 RAG 系统,建库、混合检索、溯源、记忆、部署、测试全程实测。
零基础从 01 顺序读;写过 LangChain 可以直接跳到对应阶段。每节文末有「上一节 · 下一节」导航,卡住了查 FAQ,名词不懂查 术语表。要给学生上课,直接看 教学案例。
Python 基础不牢?本仓库 python-base/ 是配套课程:01–12 零基础、13–22 进阶(类型注解、装饰器、生成器、异步、pydantic 都有专章)。各节的 Python 门槛逐级抬升,第 18 节重度使用异步,建议先读它的 20 章异步编程入门;pydantic 模型看不懂先补 21 章。
核心抽象速查
LangChain 的八个核心抽象:Models、Messages、Prompts、Tools、Output Parsers / Structured Output、Retrievers、Agents、Callbacks / Tracing。每个抽象解决什么问题、核心 API 是什么、在哪一节讲,总览表见第 01 节。
第一阶段 · 入门
| 节 | 标题 | 学到什么 |
|---|---|---|
| 01 | 简介 | 定位、八大抽象总览、0.x 迁移对照、10 分钟跑通第一次调用 |
| 02 | 环境与安装 | 按用途装包、版本锁定 |
| 03 | 配置 | API Key、OpenAI 兼容服务、模型参数 |
| 04 | Models 与 Messages | 统一调用各家模型,消息对象与角色 |
| 05 | LCEL 与 Runnable | 组链、invoke/batch/stream、fallback |
| 06 | Prompt 模板 | 模板、partial、消息插槽 |
| 07 | 输出解析器 | 拿到结构化数据的三条路线 |
第二阶段 · RAG
| 节 | 标题 | 学到什么 |
|---|---|---|
| 08 | RAG 原理 | 为什么要检索增强,工程六步 |
| 09 | 文档加载器 | txt、PDF、目录、GitHub、网页、搜索 |
| 10 | 文本切分 | chunk_size 与 chunk_overlap 怎么设 |
| 11 | 向量存储 | embedding、InMemoryVectorStore、FAISS |
| 12 | 检索与优化 | 检索失效场景与两种优化手段 |
| 13 | 完整 RAG 链 | 从加载到回答的全链路代码 |
第三阶段 · 进阶
| 节 | 标题 | 学到什么 |
|---|---|---|
| 14 | 记忆系统 | checkpointer 与 middleware |
| 15 | Function Calling | 让模型调用你的函数 |
| 16 | LangGraph 基础 | StateGraph、条件边、checkpointer |
| 17 | Agent | create_agent、@tool、路由式多 agent |
| 18 | 流式 API 与部署 | 带记忆的 RAG 与 FastAPI |
综合项目
| 节 | 标题 | 学到什么 |
|---|---|---|
| 19 | 综合项目:完整 RAG 系统 | 建库与问答分离、混合检索、溯源角标、阈值拒答、多轮记忆、FastAPI 三端点,全部实测 |
随手查
约定与版本基线
- Python 3.10 以上(第 16 节的
Literal[*列表]示例需 3.11+),包管理用 pip。 - API Key 放项目根目录的
.env,代码用python-dotenv加载,不硬编码。 - 模型示例用
ChatOpenAI。任何 OpenAI 兼容服务(DeepSeek、Kimi、GLM 等)都能直接替换,见第 03 节。 - 基于 LangChain 1.x(
langchain>=1.0,<2.0)。0.x 旧写法(AgentExecutor、Memory 类家族等)已废弃,迁移对照见第 01 节和 FAQ。