极简LangChain智能体开发入门指南 原创

引言：LangChain 的背景与意义

在人工智能快速发展的时代，大型语言模型（LLM）如 OpenAI 的 GPT 系列，已成为生成自然语言文本的核心技术。然而，将这些模型应用于实际应用（如聊天机器人或虚拟助手）时，开发者常常面临提示管理、外部数据集成和上下文保持的挑战。LangChain 作为一个开源框架，旨在简化这些复杂性，提供模块化工具，帮助开发者高效构建 LLM 驱动的应用。

LangChain 于 2022 年 10 月由 Harrison Chase 在 Robust Intelligence 启动，迅速获得社区支持，GitHub 上有数百位贡献者，活跃的 Discord 服务器和 YouTube 教程也为其普及提供了助力 (LangChain - Wikipedia)。截至 2025 年 2 月，它仍是 LLM 应用开发的热门选择，支持 Python 和 JavaScript，拥有超过 100 万开发者使用 (LangChain Official Website)。

本文将深入探讨 LangChain 的核心模块及其作用，并通过一个详细的天气查询智能体示例，展示如何将这些模块应用于实际开发，特别适合初学者快速上手。

LangChain 的模块详解

LangChain 的功能通过多个模块实现，每个模块负责特定任务。以下是关键模块的详细说明，基于 GitHub 仓库 (LangChain GitHub Repository) 和官方文档 (LangChain Python Documentation) 的信息。

关键模块

1. LLMs（大型语言模型）

• 作用：提供与不同 LLM 的统一接口，支持 OpenAI、Hugging Face 等多种模型。
• 细节：通过标准化 API，开发者可以轻松切换模型，减少代码改动。例如，使用 OpenAI 的 GPT-3.5 或 Hugging Face 的模型只需调整参数 (LangChain Python Documentation)。
• 重要性：为实验和部署提供灵活性，适合初学者快速测试不同模型效果。

2. Chains（链）

• 作用：构建 LLM 或工具的序列调用，组合成复杂工作流。
• 细节：包括 SimpleSequentialChain（简单顺序链）、LLMChain（单一 LLM 调用链）等。开发者可嵌套链，处理如文档摘要后回答问题等任务 (LangChain Python Documentation)。
• 重要性：模块化设计让任务分解更清晰，适合构建多步骤应用。

3. Agents（智能体）

• 作用：动态决策并使用工具，适合需要适应性任务，如网页搜索或 API 调用。
• 细节：智能体根据 LLM 输出选择工具，如使用搜索工具查询实时数据。ZeroShotAgent 是常见类型，无需预训练示例 (LangChain Python Documentation)。
• 重要性：增强应用灵活性，特别适合交互式任务。

4. Memory（记忆）

• 作用：存储和检索信息，保持对话或任务上下文。
• 细节：提供多种记忆类型，如 ConversationBufferMemory（存储所有消息）、ConversationSummaryMemory（存储摘要）。例如，聊天机器人可记住用户偏好 (LangChain Python Documentation)。
• 重要性：确保连续性，适合需要上下文的场景。

5. Retrievers（检索器）

• 作用：从外部来源获取相关数据，支持知识增强生成（RAG）。
• 细节：可配置为关键词搜索或语义搜索，使用嵌入模型和向量存储。适合从文档库中提取信息 (LangChain Python Documentation)。
• 重要性：提升回答准确性，特别在需要实时数据时。

6. Embeddings 和 Vector Stores（嵌入与向量存储）

• 作用：将文本转为向量，支持语义搜索；向量存储管理这些向量。
• 细节：嵌入模块支持多种模型，如 OpenAI 的嵌入 API；向量存储如 FAISS 或 Pinecone，用于高效相似性搜索 (LangChain Python Documentation 和 LangChain Python Documentation)。
• 重要性：基础 RAG 功能，适合处理大规模文本数据。

7. Tools（工具）

• 作用：为智能体提供外部功能，如 API 调用、搜索或计算。
• 细节：工具定义为函数，智能体可根据需要调用。例如，天气查询工具可调用 OpenWeatherMap API (LangChain Python Documentation)。
• 重要性：扩展智能体能力，适合交互式任务。

附加模块

除了上述关键模块，LangChain 还有以下辅助模块，适合高级开发或特定需求：

• Callbacks：用于链或智能体执行时的日志和监控，适合调试 (LangChain Python Documentation)。
• Output Parsers：解析 LLM 输出为结构化格式，增强数据处理 (LangChain Python Documentation)。
• Pydantic Integration：使用 Pydantic 验证和序列化数据，确保输入输出格式正确 (LangChain GitHub Repository)。
• Chat：处理聊天交互，管理对话历史，适合聊天机器人 (LangChain Python Documentation)。
• Utilities：通用辅助函数，如文本处理，简化开发 (LangChain GitHub Repository)。
• Index：管理文档索引，优化向量存储同步，适合 RAG 应用 (Indexes — 🦜🔗 LangChain 0.0.107)。
• Experimental：测试新功能，未稳定，适合探索 (LangChain GitHub Repository)。
• Schema：定义数据结构，辅助模块间通信 (LangChain GitHub Repository)。

详细示例：构建天气查询智能体

为了展示 LangChain 的实际应用，我们将构建一个天气查询智能体，能回答天气问题并记住对话历史。以下是逐步实现过程，基于 2025 年 2 月的最新文档。

环境设置

首先，安装 LangChain 和相关依赖，并设置 API 密钥：

pip install langchain openai

设置环境变量：

import os
os.environ["OPENAI_API_KEY"] = "your_openai_api_key"
os.environ["OPENWEATHERMAP_API_KEY"] = "your_openweathermap_api_key"

定义天气工具

使用 OpenWeatherMap API 创建工具：

from langchain.agents import Tool
from langchain.utilities import OpenWeatherMapWrapper

weather_api = OpenWeatherMapWrapper()
weather_tool = Tool(
    name="Weather API",
    func=weather_api.get_current_weather,
    description="Useful for when you need to get the current weather for a specific city",
)

设置 LLM 和记忆

使用 OpenAI 的 GPT-3.5-turbo 模型，并添加对话记忆：

from langchain.chatmodels import ChatOpenAI
from langchain.memory import ConversationBufferMemory

llm = ChatOpenAI(model_name="gpt-3.5-turbo")
memory = ConversationBufferMemory()

定义智能体

使用 ZeroShotAgent 创建智能体，包含记忆功能：

from langchain.agents import ZeroShotAgent, AgentExecutor

agent_prompt = ZeroShotAgent.create_prompt(
    tools=[weather_tool],
    prefix="You are an assistant that helps with weather information. You can remember previous queries and their responses to provide context for current questions.",
    suffix="Assistant",
    input_variables=["input", "agent_scratchpad", "chat_history"],
)

agent = ZeroShotAgent(llm=llm, prompt=agent_prompt, tools=[weather_tool], memory=memory)
agent_chain = AgentExecutor.from_agent_and_tools(
    agent=agent, tools=[weather_tool], memory=memory, verbose=True
)

交互测试

运行智能体，测试对话记忆：

response = agent_chain.run("What's the weather like in New York?")
print(response)  # 例如：New York has a temperature of 20°C and it's currently raining.

response = agent_chain.run("What's the weather like in Los Angeles?")
print(response)  # 例如：Los Angeles has a temperature of 25°C and it's sunny.

response = agent_chain.run("Is it colder in New York or Los Angeles?")
print(response)  # 例如：New York is colder, with a temperature of 20°C compared to Los Angeles at 25°C.

示例分析

• 工具使用：天气工具调用 OpenWeatherMap API，获取实时数据 (OpenWeatherMap API)。
• 记忆功能：ConversationBufferMemory 存储对话历史，智能体可参考前文回答比较问题。
• 智能体决策：ZeroShotAgent 根据工具描述和用户输入动态选择工具，适合初学者快速构建交互式应用。

结论与展望

LangChain 的模块化设计极大降低了 LLM 应用开发的门槛。通过理解 LLMs、Chains、Agents 等核心模块，开发者可构建如天气查询机器人等智能体，并利用记忆功能保持上下文。令人惊讶的是，即使初学者也能通过简单代码实现复杂功能，如对话记忆和工具调用。

LangChain 的文档和社区支持（如 GitHub 贡献和 Discord 讨论）为进一步学习提供了丰富资源 (LangChain GitHub Repository, LangChain - Wikipedia)。未来，开发者可探索更多模块如 Index（文档索引）或 Experimental（实验功能），优化应用性能。

关键引用

• LangChain 官方网站
• LangChain GitHub 仓库
• LangChain Python 文档
• LangChain Indexes 文档
• OpenWeatherMap API
• LangChain Wikipedia 页面

本文转载自公众号九歌AI大模型  作者：九歌AI

原文链接：​​https://mp.weixin.qq.com/s/9BPHEH1rP-ONGvyV1iPx_A​​