AI Agent从无到有17：LangChain 框架入门与核心概念解析

纲要

• LangChain 是什么
  • 定义与定位：大模型与 AI 应用的“粘合剂”
  • 核心设计理念：React（Reason + Action）范式
  • 发展历程与版本现状（v0.1 至 v0.3 的演变）
• LangChain 能做什么
  • 统一的多模型调用接口
  • 提示词管理与优化
  • 链式调用（Chains）
  • 检索增强生成（RAG）
  • Agent 与工具调用
  • Memory 持久化状态
  • 评估与质量保障
• 核心组件速览
  • 模型 I/O：Prompt、LLM、Output Parser
  • Chains：端到端流程封装
  • RAG 与外部知识库
  • Agent 智能体
• 优劣势分析
  • 优势：多模型无缝切换、轻量级 SDK、多模态与推理模型支持、生态丰富
  • 劣势：学习曲线陡峭、文档与版本变化问题
• 开发环境搭建与第一个示例
  • 项目目录结构
  • 环境准备与依赖安装
  • 最小可运行链：翻译助手
• 总结与展望

LangChain 是什么

大型语言模型（LLM）具备强大的文本生成与推理能力，但其原生交互形式局限于对话式文本回复，难以直接嵌入自动化流程、串联多个模型或调用外部工具。LangChain 是一个开源框架，旨在为大语言模型提供标准化的外部能力扩展接口，将提示词、模型调用、结果解析、外部工具、知识库等组件以模块化方式组合，从而构建出可复用、可维护的智能应用。其官方定位为大模型与 AI 应用的粘合剂。

LangChain 的核心设计理念源自 React（Reason + Action） 范式。其中，Reason 代表推理，即让 AI 系统进行逻辑分析与决策；Action 代表行动，即基于推理结果执行具体操作，例如调用搜索引擎、查询数据库或运行代码。这种“思考-行动-观察-再思考”的循环机制，模拟了人类解决复杂问题的认知过程，是 LangChain 中 Agent 智能体工作的基础。

LangChain 于 2022 年 10 月开源，目前 GitHub Star 数量增长迅速，项目主要维护 Python 和 TypeScript 两个语言版本，社区亦涌现出 Go、Java 等第三方实现。当前最新大版本为 v0.3，但需注意整个框架尚未发布 1.0 稳定版，版本迭代频繁，API 存在较大变动。

LangChain 能做什么

LangChain 提供了从底层模型调用到上层智能体应用的完整能力栈，主要包括以下七个方面：

1. 统一的模型调用：支持 OpenAI、DeepSeek、Claude、Gemini、通义千问等主流大模型。无论底层 API 差异多大，开发者均使用同一套接口进行调用，模型切换仅需修改一行配置代码。
2. 提示词工程：将提示词模板化、参数化，支持动态构造提示，并提供提示词版本管理与优化工具，使提示词具备可编程性和可复用性。
3. 链式调用（Chains）：将“提示词 → 模型 → 输出解析”封装为一个链，允许多个链串联或并行执行，形成更复杂的处理流程。例如，一个翻译链可组合“文件读取链 → 批量翻译链 → 格式转换链”。
4. 检索增强生成（RAG）：大模型的预训练数据存在截止日期，无法回答私域或实时信息。RAG 模式先到外部知识源（如向量数据库、文档库）检索相关信息，再与用户问题一同提交给模型，从而显著降低幻觉，获得最新且领域专属的答案。
5. Agent 智能体：Agent 是更高级的封装，能够自动拆分任务、决定调用哪些工具、观察结果并调整行动，直至完成目标。LangChain 内置了标准 Agent 开发范式，并提供与 LangGraph（图驱动工作流）的结合路径。
6. Memory 状态记忆：为对话添加持久化的上下文记忆，支持内存、数据库等多种存储后端，使智能应用具备多轮对话的记忆能力。
7. 评估（Evaluation）：提供自动化评估工具，支持用一个大模型评测另一个模型的输出质量与正确性，便于生产环境下的持续监测。

以下流程图展示了 LangChain 应用中一次典型的交互过程：

核心组件速览

LangChain 的设计高度模块化，核心组件可按以下层级划分：

组件	作用	示例
Prompt	定义与模型的交互方式、角色和指令	"你是一个专业翻译，将以下中文翻译为英文：{text}"
LLM / ChatModel	调用具体大模型	ChatOpenAI(model="gpt-4")、ChatDeepSeek(model="deepseek-chat")
Output Parser	将模型原始输出解析为结构化数据	解析出 JSON、Python 对象、列表等
Chain	组合上述组件形成端到端流程	翻译链、问答链、多步推理链
Retriever	从外部知识源检索相关文档	向量数据库相似度搜索
Agent	动态决策，调用工具，循环执行	自主分析任务、决定用计算器还是搜索引擎
Memory	会话上下文持久化	对话历史存储

优劣势分析

LangChain 能力强大，但在实际生产中也需客观评估其优劣。

优势

• 多模型无缝切换：一套代码适配不同模型，甚至可实现故障自动切换，例如 OpenAI 额度耗尽时自动切换至 DeepSeek。
• 轻量级 SDK：Python 和 TypeScript 的原生集成，学习成本相对较低，前端与后端开发者均可快速上手。
• 多模态与推理模型支持：提供文字、图像、音视频的统一处理接口，同时支持 DeepSeek-R1、OpenAI o 系列等新近推理型模型。
• 活跃的社区与生态：大量现成模板、工具集成和第三方应用，显著加速开发进度。

劣势

• 学习曲线较陡峭：涉及提示工程、链组合、记忆管理、Agent 决策等众多概念，新手容易迷失方向。
• 文档不完善且变化快：官方文档仍在快速迭代，v0.1 与 v0.3 的 API 存在较大断裂，旧代码可能需要重构。
• 架构演化剧烈：从单一包 langchain 拆分为多个子包（langchain-core、langchain-community 等），又新推出 langgraph，增加了技术选型难度。

对于简单应用（单链、多步提示），推荐直接使用 langchain 基础模块；对于复杂工作流或生产级 Agent，建议探索 langgraph。

开发环境搭建与第一个示例

本节基于 Python 搭建一个最小可运行的 LangChain 应用——自动翻译链。用户输入一段中文，链自动翻译为英文并返回。

项目结构

langchain-demo/
├── main.py
├── requirements.txt
└── .env

环境准备

确保 Python 版本 >= 3.9，新建虚拟环境后安装依赖。

python -m venv venv
source venv/bin/activate    # Windows 使用 venv\Scripts\activate
pip install langchain langchain-openai python-dotenv

若使用 DeepSeek 模型，可额外安装 langchain-deepseek。本示例采用 DeepSeek 的 deepseek-chat 模型，需注册并获取 API Key（有免费额度）。在项目根目录创建 .env 文件：

DEEPSEEK_API_KEY=你的API密钥

完整代码

新建 main.py，写入以下内容：

import os
from dotenv import load_dotenv
from langchain_core.prompts import ChatPromptTemplate
from langchain_deepseek import ChatDeepSeek
from langchain_core.output_parsers import StrOutputParser

# 加载环境变量
load_dotenv()
api_key = os.getenv("DEEPSEEK_API_KEY")
if not api_key:
    raise ValueError("请在 .env 文件中设置 DEEPSEEK_API_KEY")

# 初始化模型
llm = ChatDeepSeek(
    model="deepseek-chat",
    temperature=0.3,          # 控制生成随机性，越低越确定
    api_key=api_key
)

# 构造提示词模板：翻译任务
prompt = ChatPromptTemplate.from_messages([
    ("system", "你是一个专业的翻译助手，请将用户输入的中文准确翻译为英文。"),
    ("human", "{text}")
])

# 输出解析器：直接取出字符串
output_parser = StrOutputParser()

# 构建链：prompt -> llm -> output_parser
chain = prompt | llm | output_parser

# 测试运行
if __name__ == "__main__":
    chinese_text = "人工智能正在改变我们的工作和生活方式。"
    print("原文：", chinese_text)
    result = chain.invoke({"text": chinese_text})
    print("翻译：", result)

运行

python main.py

预期输出类似：

原文： 人工智能正在改变我们的工作和生活方式。
翻译： Artificial intelligence is changing the way we work and live.

代码解析

• ChatDeepSeek：封装了对 DeepSeek 聊天模型的调用，可替换为 ChatOpenAI 等其他实现。
• ChatPromptTemplate：通过 system 和 human 消息定义对话角色和占位符。
• StrOutputParser：将模型的 AIMessage 对象直接转为字符串。
• 链式操作符 |：LangChain 使用 LCEL（LangChain Expression Language）构建链，清晰表达数据流向。

此示例完整展示了 LangChain 的基本骨架。开发者可轻松扩展该链，例如在翻译前增加语言检测步骤，或翻译后调用 TTS 服务朗读结果。

参考文档

官方文档

• LangChain 官方文档
• LangChain GitHub 仓库
• LangChain Python API 参考

参考链接

• LangChain 快速入门指南
• LCEL 表达式语言说明
• LangGraph 官方文档

总结

本文从 LangChain 的诞生背景、核心能力、组件构成到实际编码，完整梳理了 AI Agent 开发工程师需要掌握的基础知识。尽管 LangChain 的学习曲线和版本变化带来一定挑战，但其多模型统一调用、组件化设计以及丰富的工具生态，仍然使其成为当前构建大模型应用的主流选择。

建议初学者从简单的链开始，逐步增加记忆、RAG、Agent 等高级功能，稳扎稳打地进入 AI 应用开发领域。