LangChain 系统学习技术路线图
LangChain 系统学习技术路线图
以下是基于2026年最新版本(LangChain v0.3+ / v1.0生态)设计的系统学习路线图,预估总耗时2-3个月,采用四阶段递进式学习策略。
阶段一:快速过河(1-2周)——建立“编程集成”直觉
核心目标:完成从“AI使用者”到“AI应用构建者”的思维转换,理解概率性输出的编程范式。
学习内容
1. 原生API调用(不依赖LangChain)
抛开框架,直接用 openai 库的ChatCompletion API实现:
- 连续多轮对话并保持上下文
- 理解
messages列表结构(system / user / assistant 角色) - 手动管理对话历史
2. Function Calling完整流程
这是所有Agent的基石,需要掌握完整的数据流:
用户输入 → LLM请求 → [模型返回function_call]
↓
解析函数名和参数 → 执行本地函数
↓
将结果返回给LLM → [模型生成最终回复] → 返回用户
3. 环境搭建
- Python 3.10+ 环境配置
- 安装LangChain核心包:
pip install langchain langchain-openai python-dotenv - 获取API Key(OpenAI / Anthropic / DeepSeek等)
阶段成果
- 能画出Function Calling数据流图
- 能独立完成一次自定义函数的调用(如天气查询)
- 理解为何需要多轮交互才能完成完整工具调用
阶段二:夯实核心(3-4周)——掌握LangChain核心范式
核心目标:系统学习官方概念,用架构思维理解LangChain的组件体系。
2.1 LangChain Core与LCEL(1.5周)
LCEL(LangChain Expression Language) 是LangChain的核心抽象,通过管道操作符 | 将组件串联为链:
- Runnable协议:所有组件的统一接口,提供
invoke/stream/batch方法 - 核心链式写法:
prompt | model | parser - bind()方法:运行时动态绑定参数
- RunnableLambda:将任意Python函数提升为Runnable,融入LCEL管道
重点精读概念:
| 概念 | 核心理解 |
|---|---|
| LCEL | 用管道连接组件,类似Unix管道 |
| Runnable | 统一接口,所有组件均可invoke/stream/batch |
| bind() | 动态注入工具、配置 |
2.2 模型 I/O与提示词模板(1周)
- Chat Models:使用
init_chat_model统一初始化不同提供商的模型(OpenAI、Anthropic、Google等) - PromptTemplate:支持f-string、jinja2、mustache三种语法的模板引擎,通过变量占位符动态生成提示词
- ChatPromptTemplate:面向聊天模型的结构化提示词模板,支持system/human/ai消息角色
- FewShotPromptTemplate:少样本学习模板,通过示例引导模型输出
- 输出解析器:PydanticOutputParser、JSONOutputParser等结构化输出方案
2.3 工具与Agent基础(1周)
Tools(工具) 是Agent与外部世界交互的桥梁:
- 使用
@tool装饰器定义工具 Tool.from_function简化定义方式,支持自动从函数注释提取描述- 将工具绑定到模型:
model.bind_tools(tools)
Agent创建:
from langchain.agents import create_agent
agent = create_agent("gpt-4o", tools=tools)
Agent的本质是模型在循环中调用工具直到任务完成。
2.4 Memory与上下文管理
LangChain v0.3+ 已废弃传统Memory API(如ConversationBufferMemory),推荐迁移到LangGraph持久化方案:
- 短期记忆:线程范围内维持对话历史,由图状态管理,通过checkpointer持久化
- 长期记忆:跨会话持久化用户偏好和上下文,使用
InMemoryStore等方案
阶段成果
- 能用LCEL构建包含提示词、模型调用和输出解析的完整链
- 能创建带工具调用能力的Agent
- 理解Memory在LangGraph中的管理方式
阶段三:原理深入(2-3周)——RAG、LangGraph与可观测性
核心目标:掌握生产级应用的核心组件,理解设计哲学。
3.1 RAG(检索增强生成)
RAG是LangChain最核心的应用模式之一,完整流程包括:
数据摄入管道:
- Document Loaders:加载PDF、网页、数据库等文档
- Text Splitters:文档切分(按字符、Token或语义切分)
- Embedding Models:将文本转换为向量表示
- Vector Stores:Chroma、Pinecone、FAISS等向量数据库存储嵌入
检索与生成:
- 构建Retriever检索相关文档
- 将检索结果注入提示词,增强LLM生成质量
- Agentic RAG:构建能自主决定何时检索、何时直接回答的智能体
3.2 LangGraph —— 有状态工作流编排
LangGraph是LangChain生态中面向复杂工作流的核心框架:
- 图结构:以节点(Node)和边(Edge)建模工作流,支持循环、条件路由和持久状态
- 状态管理:通过TypedDict定义状态,节点间自动传递和更新
- 条件路由:根据Agent决策动态选择执行路径
- 多Agent协作:支持子代理委派、Agent间交接等模式
- Checkpointer:自动持久化状态,支持断点续跑
与LangChain的关系:LangChain的Agent实现底层使用了LangGraph原语,需要更深度的定制时可直接用LangGraph实现。
3.3 LangSmith —— 可观测性与评估
LangSmith是LangChain团队推出的独立可观测性平台,可与任何LLM框架配合使用:
- Tracing:追踪每次调用的完整链路,可视化Agent决策过程
- Evaluation:对ChatBot和Agent进行系统化评估,支持多种评估类型
- 监控:生产环境的性能监控和问题诊断
阶段成果
- 能构建完整的RAG管道(加载→切分→嵌入→存储→检索→生成)
- 能用LangGraph编排有状态的多步骤工作流
- 能用LangSmith追踪和调试Agent行为
阶段四:复杂实战(3-4周+)——面向“复杂决策Agent”的架构设计
核心目标:综合运用所有技能,完成生产级项目实战。
4.1 推荐实战项目
项目一:智能客服Agent
- 结合RAG知识库 + 工具调用 + 多轮对话记忆
- 使用LangGraph实现人在回路(human-in-the-loop)审查
- 集成LangSmith进行评估和监控
项目二:深度研究Agent
- 多步骤网页研究,支持子智能体委派和策略反思
- 集成Tavily搜索工具 + 持久记忆 + 定时调度
项目三:SQL数据库Agent
- 通过自然语言与数据库交互
- 人在回路审查SQL执行计划
- 完整的错误处理和重试机制
4.2 生产级架构考量
- 模块化设计:LangChain v0.3+ 已将框架拆分为
langchain-core、langchain-{partner}和langchain-community三个独立模块,通过依赖解耦提升扩展性 - Pydantic v2:数据模型强类型校验,序列化和验证速度提升数倍
- 流式输出:支持流式思考过程输出,提升用户体验
- 性能优化:AgentExecutorV2 性能提升30%-50%,大幅降低内存占用
- 多Agent协作:支持子代理委派、路由分发等企业级模式
4.3 部署与运维
- 使用
langgraph-cli的Deploy CLI一键部署Agent到LangSmith Deployment - 配置生产环境的环境变量和密钥管理
- 建立评估基准和持续监控流程
学习资源推荐
官方资源
- LangChain官方文档:https://python.langchain.com/docs/introduction/
- LangChain学习教程:https://docs.langchain.org.cn/oss/python/learn
- LangChain Academy:官方系统化课程与练习
中文教程
- 尚硅谷LangChain 1.2教程(2026版) :涵盖从入门到Agent/RAG综合项目,共120个视频分P,配套完整课件和代码
- JetBrains LangChain Python教程:https://blog.jetbrains.com/pycharm/2026/02/langchain-tutorial-2026/
开源项目参考
- GitHub上搜索
ai-agent-langchain和langchain-learn,有大量可运行的实战项目
生态工具
- LangGraph:复杂工作流编排引擎
- LangSmith:可观测性与评估平台
- Deep Agents:长运行工作流的智能体框架
学习建议与避坑指南
-
务必从原生API开始:不要一上来就用LangChain,先用原生
openai库理解LLM调用的本质,否则容易“只会调包不懂原理” -
LCEL是核心:花足够时间理解Runnable协议和管道操作,这是LangChain所有组件的统一接口,掌握后学习其他组件会事半功倍
-
避免过时API:LangChain v0.3+ 已废弃传统Memory API和ConversationChain,学习时请以最新文档为准,避免学习已过时的写法
-
LangGraph优先级高于Chain:2026年官方推荐架构中,复杂Agent用LangGraph而非传统Chain,建议尽早熟悉图编排思维
-
从第一天就用LangSmith:尽早接入LangSmith进行追踪和调试,能极大加速问题定位和迭代效率
-
重视评估环节:生产级Agent的评估能力至关重要,建议在学习RAG和Agent时同步学习LangSmith的评估功能

浙公网安备 33010602011771号