第七章：LangChain 与 LlamaIndex 的分工¶

7.1 为什么容易混淆¶

两个框架都支持模型调用、Tools、RAG、Agent 和 Workflow。只看功能清单，很容易得出「它们差不多」的结论。

更有区分度的是设计重心：

LangChain 更关心如何统一模型与工具，并快速组装通用 Agent；

LlamaIndex 更关心如何把私有数据加工成高质量上下文，再交给模型或 Agent 使用。

7.2 核心区别¶

维度	LangChain	LlamaIndex
设计重心	通用 Agent 组装和工具集成	数据接入与上下文增强
主要优势	模型、Tools、中间件和第三方集成	文档处理、索引、检索和重排
常见场景	工具型 Agent、SQL Agent、业务助手	企业知识库、文档 Agent、复杂 RAG
复杂流程	通过 LangGraph 管理状态、恢复和人工介入	使用 Workflows，或与 LangGraph 组合

这张表比较的是优势重心，不是能力边界。 LangChain 也有完整的 RAG 组件，LlamaIndex 也能创建 Agent；区别在于哪一套抽象更贴近项目的主要问题。

7.3 LangChain 强在哪里¶

如果项目需要接入多个模型、搜索、数据库、浏览器、MCP Server 和公司内部 API，最大的工程成本往往是不同接口之间的适配。

flowchart TB
    A["统一 Model / Message / Tool / Structured Output 接口<br/>屏蔽厂商差异"] --> B["create_agent 组装模型与工具"]
    B --> C["Middleware 统一加入<br/>权限、重试、摘要、动态模型选择、人工审批"]
    C --> D["流程复杂到需要精细控制分支、并行和恢复时<br/>继续下沉到 LangGraph<br/>不必推翻已定义好的模型与工具"]

    style D fill:#e6f4ea

它的主要难点：让模型选对工具、填对参数，并把权限、重试和审批统一接入调用过程。

LangGraph 是 LangChain Agent 的底层运行时。 简单的模型与工具循环用 create_agent 即可；出现复杂分支、并行、暂停恢复和人工审批时，才显式编写状态图。

7.4 LlamaIndex 强在哪里¶

真实 RAG 项目的困难通常不止是把文档放进向量数据库。

阶段	真实困难
数据刚进来	PDF 表格、跨页内容、切分方式、元数据；同一制度多个版本，要判断哪一份仍然有效
查询阶段	决定走向量检索、关键词检索还是结构化数据库
多路结果回来后	过滤、重排、处理冲突

难点沿着「数据进入 → 建立索引 → 发起检索 → 组织上下文」一路传递，而不是某一个向量库能单独解决。

flowchart LR
    A["数据接入"] --> B["解析与切分"] --> C["索引"] --> D["检索与重排"] --> E["Query Engine"] --> F["Agent"]

    style B fill:#e8f0fe
    style D fill:#e8f0fe

LlamaIndex 把「如何得到高质量上下文」当作主要工程问题。

企业文档、多数据源路由和复杂检索是它更自然的应用入口。

更准确地说，LlamaIndex 的优势重心在数据，而不是「只能做 RAG」——它同样提供 Agent 和事件驱动 Workflow。

7.5 应该如何选型¶

选型时先看项目最怕哪类风险。

项目主要风险	优先评估	原因
模型和业务工具太多，集成复杂	LangChain	通用组件和工具接口更自然
文档解析、切分和检索质量差	LlamaIndex	数据与上下文链路抽象更细
流程需要暂停恢复和人工审批	LangGraph，可搭配 LangChain	状态与执行控制是核心能力
同时需要复杂检索和复杂流程	LlamaIndex + LangChain/LangGraph	数据层与编排层分别选合适组件

如果只是简单知识库或单工具 Agent，没有必要为了架构完整同时引入两套框架。

组合会增加依赖、追踪和调试成本，只有当两边确实解决独立难题时才值得。

7.6 两者如何组合¶

最常见的组合边界是 Tool。

# LlamaIndex Query Engine 被包装成 LangChain 可以调用的 Tool
@tool
def search_company_knowledge(question: str) -> str:
    """查询企业知识库。"""
    return str(query_engine.query(question))

# LangChain Agent 负责判断何时查询知识库，何时调用订单工具
agent = create_agent(
    model=chat_model,
    tools=[search_company_knowledge, lookup_order],
)

层	谁负责
数据加载、构建索引、Query Engine	LlamaIndex
判断什么时候调用、工具选择	LangChain Agent
审批、重试、恢复	LangGraph

这段代码表达的重点是职责边界。 生产环境还需要补充租户权限、引用来源、超时和可观测性。

7.7 常见错误¶

7.7.1 用「LangChain 做 Chain，LlamaIndex 做 RAG」这个过时标签¶

两者都能做 Agent、工具调用和 RAG，区别是设计重心。

7.7.2 以为 LangChain 只会把 Prompt 串成 Chain¶

当前主线已经转向 Agent，固定流程才由 Runnable 和 LCEL 承担。

7.7.3 以为 LlamaIndex 是向量数据库¶

它能连接向量库，但本身是数据处理、索引、检索与上下文组织的抽象。

7.7.4 按功能清单比框架¶

功能重叠不代表设计重心相同，要看哪套抽象更贴近你的主要难题。

7.7.5 认为必须二选一¶

可以通过 Tool 或服务接口组合。

7.7.6 为了架构完整同时引入两套¶

简单知识库或单工具 Agent 不需要，多一套依赖只增加调试成本。

7.7.7 把 RAG 难点简化成「选个向量库」¶

难点沿数据进入 → 索引 → 检索 → 组上下文一路传递。

7.7.8 组合时忘了生产要素¶

租户权限、引用来源、超时、可观测性都不会自动来。

7.8 本章总结¶

不要再用过时标签，两者都能做 Agent、工具调用和 RAG；
真正的区别是设计重心：LangChain 偏通用 Agent 组装与工具集成，LlamaIndex 偏数据接入与上下文增强；
LangChain 的价值在屏蔽接口差异：统一 Model / Message / Tool / 结构化输出，再用 create_agent 组装，Middleware 统一横切；
复杂流程可以从 LangChain 下沉到 LangGraph，不必推翻已有模型与工具定义；
LlamaIndex 的价值在把「如何得到高质量上下文」当成核心工程问题，链路拆得更细；
RAG 的困难是链式传递的，不是某个向量库能单独解决；
选型先看项目最怕哪类风险，再决定优先评估谁；
最常见的组合边界是 Tool：LlamaIndex 管数据与检索，LangChain 管模型和工具选择，LangGraph 管状态与恢复；
组合有成本，只有两边各自存在独立难题时才值得。

可以把分界记成这样：LangChain 先解决模型与工具怎么统一和调度，LlamaIndex 先解决私有数据怎么变成高质量上下文；两类问题同时存在时，再用 Tool 把它们接起来。