跳转到主要内容

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 兼容服务、模型参数
04Models 与 Messages统一调用各家模型,消息对象与角色
05LCEL 与 Runnable组链、invoke/batch/stream、fallback
06Prompt 模板模板、partial、消息插槽
07输出解析器拿到结构化数据的三条路线

第二阶段 · RAG

节标题学到什么
08RAG 原理为什么要检索增强,工程六步
09文档加载器txt、PDF、目录、GitHub、网页、搜索
10文本切分chunk_size 与 chunk_overlap 怎么设
11向量存储embedding、InMemoryVectorStore、FAISS
12检索与优化检索失效场景与两种优化手段
13完整 RAG 链从加载到回答的全链路代码

第三阶段 · 进阶

节标题学到什么
14记忆系统checkpointer 与 middleware
15Function Calling让模型调用你的函数
16LangGraph 基础StateGraph、条件边、checkpointer
17Agentcreate_agent、@tool、路由式多 agent
18流式 API 与部署带记忆的 RAG 与 FastAPI

综合项目

节标题学到什么
19综合项目:完整 RAG 系统建库与问答分离、混合检索、溯源角标、阈值拒答、多轮记忆、FastAPI 三端点,全部实测

随手查

  • 教学案例:给学生上课的 5 个演示
  • FAQ:常见报错与坑,按「现象 → 原因 → 处理」整理
  • 术语表:是什么、有什么用、在哪一节讲

约定与版本基线

  • 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。