LangChain

🎯 为什么需要它

LLM 生态极度碎片化 — OpenAI、Anthropic、Google、本地模型各有一套 API；Chroma、FAISS、Pinecone 等向量库接口各异；搜索、数据库、文件系统等工具需要逐一对接。如果你直接写原生 SDK 调用，换模型或换向量库时需要重写大量胶水代码。

LangChain 的价值主张：提供一套标准抽象（Runnable、ChatModel、Tool、Retriever），让你用统一的接口对接 700+ 集成，核心业务逻辑不随底层更换而改变。

📦 包生态全景

LangChain 已从早期的单体包拆分为模块化体系，按需安装：

关键关系：langchain-core 是地基；langchain 和 langgraph 建在其上；集成包提供具体实现。新项目建议同时安装 langchain + langgraph。

✅ 核心优势

1. 生态覆盖最广 — 700+ 集成

从 LLM 提供商（OpenAI、Anthropic、Google、Ollama、AWS Bedrock）到向量库（Chroma、FAISS、Pinecone、Qdrant、pgvector 等 40+）到工具（搜索、SQL、文件系统、Slack、GitHub 等数百个），覆盖面远超任何竞品。换提供商只需改一行 import。

2. LangGraph — 最成熟的有状态 Agent 编排

LangGraph 提供基于图的工作流引擎，支持循环（Agent 自循环调用工具）、分支、持久化检查点、人机协同（human-in-the-loop）、时间旅行调试。这是目前开源生态中最完整的有状态 Agent 运行时。

3. LCEL — 优雅的链组合语法

LangChain Expression Language 用 | 管道符组合组件，支持并行、重试、fallback、流式输出、批量处理：

chain = prompt | model | parser
result = chain.invoke({"topic": "LangChain"})

4. v1.0 稳定性承诺

2025 年 10 月发布 v1.0，承诺到 v2.0 之前不引入破坏性变更。API 趋于稳定，历史遗留的频繁 breaking changes 问题基本解决。

5. LangSmith 可观测性

配套的 LangSmith 平台提供 Agent 决策追踪、Token 用量统计、延迟分析、Prompt 评估对比。对生产环境调试 Agent 至关重要。

⚡ 性能表现

LangChain 的性能问题不在模型推理（那是提供商的事），而在框架开销：

实测数据：移除 LangChain 的收益

流式场景的内存问题

LangGraph 的 stream_mode: ['messages', 'updates'] 在多 Agent 场景下，每个 token 生成一个 AIMessageChunk 对象（含完整元数据），单次运行可产生 10,000+ chunk 对象，触发 1–1.5 GB 内存尖峰。

建议

• 生产环境关闭不用的计算（token 计数、复杂度评分等默认启用的功能）
• 流式输出只用 stream_mode="messages"，避免多模式叠加
• Memory 用 LangGraph 的状态图管理，别用 ConversationBufferMemory
• 对延迟敏感的场景，考虑核心路径用原生 SDK，LangChain 只做外围编排

🚀 快速上手

1. 安装

# 最小安装（含 OpenAI 集成）
pip install -qU langchain "langchain[openai]"

# 如果用 Claude
pip install langchain langchain-anthropic

# 完整安装（含 LangGraph）
pip install langchain langgraph langchain-openai

2. 现代写法：create_agent（v1.x 推荐）

from langchain.agents import create_agent

def get_weather(city: str) -> str:
    """Get weather for a given city."""
    return f"It's always sunny in {city}!"

agent = create_agent(
    model="openai:gpt-4o",
    tools=[get_weather],
    system_prompt="You are a helpful assistant",
)

result = agent.invoke(
    {"messages": [{"role": "user", "content": "What's the weather in SF?"}]}
)
print(result["messages"][-1].content_blocks)

3. LCEL 链组合（经典管道写法）

from langchain_openai import ChatOpenAI
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.output_parsers import StrOutputParser

chain = (
    ChatPromptTemplate.from_template("Tell me about {topic}")
    | ChatOpenAI()
    | StrOutputParser()
)
result = chain.invoke({"topic": "LangChain"})
print(result)

4. RAG 基础示例

from langchain_openai import ChatOpenAI, OpenAIEmbeddings
from langchain_community.vectorstores import FAISS
from langchain_core.prompts import ChatPromptTemplate
from langchain_core.runnables import RunnablePassthrough

# 准备文档和向量库
docs = ["LangChain is a framework for LLM apps.",
        "LangGraph handles stateful agent workflows."]
vectorstore = FAISS.from_texts(docs, OpenAIEmbeddings())
retriever = vectorstore.as_retriever()

# 构造 RAG 链
template = "Answer based on context: {context}\n\nQuestion: {question}"
prompt = ChatPromptTemplate.from_template(template)

rag_chain = (
    {"context": retriever, "question": RunnablePassthrough()}
    | prompt
    | ChatOpenAI()
)

result = rag_chain.invoke("What is LangGraph for?")
print(result.content)

5. LangGraph 状态图 Agent（复杂工作流）

from langgraph.prebuilt import create_react_agent
from langchain_openai import ChatOpenAI

model = ChatOpenAI(model="gpt-4o")
agent = create_react_agent(model, tools=[get_weather])

# 流式输出
for event in agent.stream(
    {"messages": [{"role": "user", "content": "Weather in Tokyo?"}]},
    stream_mode="messages",
):
    print(event)

langchain==1.3.0
langchain-core==1.4.0
langchain-openai==0.3.x  # provider 包版本独立

📦 适用场景

✅ 最佳场景

❌ 不推荐场景

⚠️ 已知坑

版本迁移时间线

🚗️ 竞品对比

🌎 生态社区

社区情绪走势

被广泛引用的数据："45% 的 AI 团队使用 LangChain，但只有 12% 保留在生产中"。虽然精确度存疑，但反映了核心叙事 — LangChain 在原型阶段很强大，但迁移到生产需要投入额外精力。

💡 引入评估

🔗 相关链接

• GitHub 仓库— 源码和 Issues
• 官方文档— API 参考、教程、迁移指南
• LangGraph— 有状态 Agent 编排引擎
• LangSmith— 可观测性和评估平台
• 社区讨论— GitHub Discussions
• r/LangChain— Reddit 社区
• v1.0 迁移指南— 从旧版本升级

📝 个人备注