LangChain v1 是一个专注的、生产就绪的构建智能体的基础框架。 我们围绕三个核心改进精简了框架:

create_agent

在 LangChain 中构建智能体的新标准,取代了 langgraph.prebuilt.create_react_agent。

标准内容块

一个全新的 content_blocks 属性,提供跨供应商的现代 LLM 功能统一访问方式。

简化的命名空间

langchain 命名空间已精简,专注于智能体的核心构建模块,遗留功能已移至 langchain-classic。
要升级,
有关变更的完整列表,请参阅迁移指南。

create_agent

create_agent 是在 LangChain 1.0 中构建智能体的标准方式。它提供了比 langgraph.prebuilt.create_react_agent 更简单的接口,并通过使用中间件提供了更大的定制潜力。
在底层,create_agent 基于基本的智能体循环构建——调用模型,让其选择要执行的工具,然后在不再调用工具时结束:
核心智能体循环图
更多信息,请参阅智能体。

中间件

中间件是 create_agent 的标志性特性。它提供了高度可定制的入口点,提升了你能构建的应用上限。 优秀的智能体需要上下文工程:在正确的时间向模型提供正确的信息。中间件帮助你通过可组合的抽象来控制动态提示、对话摘要、选择性工具访问、状态管理和防护栏。

预构建中间件

LangChain 提供了一些针对常见模式的预构建中间件,包括:

自定义中间件

你也可以构建自定义中间件以适应你的需求。中间件在智能体执行的每个步骤都暴露了钩子:
中间件流程图
通过实现 AgentMiddleware 类的任何钩子来构建自定义中间件: 自定义中间件示例:
更多信息,请参阅完整的中间件指南。

基于 LangGraph 构建

因为 create_agent 基于 LangGraph 构建,所以你自动获得了对长时间运行和可靠智能体的内置支持,通过:

持久化

通过内置检查点机制,对话自动跨会话持久化

流式传输

实时流式传输 token、工具调用和推理轨迹

人机协同

在敏感操作前暂停智能体执行以供人类批准

时间旅行

将对话回溯到任何时间点,探索替代路径和提示
你无需学习 LangGraph 即可使用这些功能——它们开箱即用。

结构化输出

create_agent 改进了结构化输出生成:
  • 主循环集成:结构化输出现在在主循环中生成,无需额外的 LLM 调用
  • 结构化输出策略:模型可以选择调用工具或使用供应商端的结构化输出生成
  • 成本降低:消除了额外 LLM 调用带来的开销
错误处理:通过 ToolStrategy 的 handle_errors 参数控制错误处理:
  • 解析错误:模型生成的数据与所需结构不匹配
  • 多次工具调用:模型为结构化输出模式生成 2 次以上的工具调用

标准内容块

内容块支持目前仅适用于以下集成:对更多供应商的内容块支持将逐步推出。
全新的 content_blocks 属性引入了跨供应商通用的消息内容标准表示形式:

优点

  • 供应商无关:无论供应商如何,使用相同的 API 访问推理轨迹、引用、内置工具(网络搜索、代码解释器等)和其他功能
  • 类型安全:所有内容块类型都有完整的类型提示
  • 向后兼容:标准内容可以延迟加载,因此没有相关的破坏性变更
更多信息,请参阅关于内容块的指南。

简化的包

LangChain v1 精简了 langchain 包命名空间,专注于智能体的核心构建模块。优化后的命名空间提供了最有用和相关的功能:

命名空间

这些大多数为了方便从 langchain-core 重新导出,这为你提供了一个专注于构建智能体的 API 界面。

langchain-classic

遗留功能已移至 langchain-classic,以保持核心包的精简和专注。 langchain-classic 中包含的内容:
  • 遗留链和链实现
  • 检索器(例如 MultiQueryRetriever 或之前 langchain.retrievers 模块中的任何内容)
  • 索引 API
  • 中心模块(用于以编程方式管理提示)
  • langchain-community 的导出内容
  • 其他已弃用的功能
如果你使用这些功能中的任何一项,请安装 langchain-classic:
然后更新你的导入:

迁移指南

请参阅我们的迁移指南,以获取将你的代码更新到 LangChain v1 的帮助。

报告问题

请在 GitHub 上使用 'v1' 标签报告在 1.0 中发现的任何问题。

附加资源

LangChain 1.0

阅读发布公告

中间件指南

深入了解中间件

智能体文档

完整的智能体文档

消息内容

新的内容块 API

迁移指南

如何迁移到 LangChain v1

GitHub

报告问题或贡献代码

另请参阅