01WHAT IT SOLVES
这个项目解决什么问题？
LangChain 是一个面向大语言模型应用的开发框架，定位为智能体工程平台，提供从高层链式调用到低层组件的多层抽象，支持模型、嵌入、向量库、工具与检索器等模块的可互换拼装。它围绕 LangChain 主框架、LangGraph 编排、Deep Agents 高级封装以及 LangSmith 调试部署构成完整生态。在同类方案中，LangChain 角色更偏通用底层与生态聚合，强调多模型厂商兼容与组件互操作，让开发者能随前沿技术演进快速替换底层实现而不重写上层逻辑。
02CORE CAPABILITIES
核心能力
模型与嵌入统一接口
通过标准接口接入多家模型与嵌入服务，便于在不同供应商间切换
链式调用与组件拼装
模块化架构支持快速组合提示、检索、工具调用等环节以构建复合应用
智能体与子代理封装
通过 Deep Agents 等高层包提供规划、子代理与文件系统等常见能力
LangGraph 编排框架
以低层框架构建可控、可中断、可恢复的智能体工作流
数据增强与集成生态
连接外部数据源、向量库与第三方工具，支撑检索增强生成
03适合谁
- 使用 Python 或 TypeScript 构建 LLM 应用的开发者
- 需要将多个模型、数据源与工具集成的应用架构师
- 探索智能体编排与多步推理的 AI 工程团队
- 寻求统一抽象以适配多模型供应商的技术负责人
04典型使用场景
- 构建检索增强生成知识问答系统
- 搭建具备工具调用能力的对话式智能体
- 在多模型厂商间迁移或对比不同 LLM 后端
- 通过 LangSmith 进行应用评估、可观测性与上线部署
05为什么值得关注
- 主框架加上 LangGraph、Deep Agents、LangSmith 形成完整智能体工程生态
- 抽象层设计允许随模型前沿变化灵活替换底层实现
- 社区活跃、文档与课程资源持续更新
06采用前要注意
- 抽象层较多且迭代较快，存在版本兼容与概念更替的适应成本
- 框架本身不直接提供模型推理或托管服务，依赖外部供应商
- 高层封装的功能可能不完全覆盖定制化场景，需下沉到低层组件
07RELEASE INTELLIGENCE
近期版本变化
langchain langchain-core==1.6.3：版本变化解读
langchain-core 1.6.3 新增基于网关响应的模型名与提供商追踪元数据覆盖能力，并补回对已废弃 .text() 访问路径的测试覆盖，同时清理了部分文档遗留条目。影响所有使用 langchain-core 的开发者，建议关注网关追踪字段的兼容性变化。官方说明未提供更多细节。
- 新增网关响应驱动的模型名与提供商追踪元数据覆盖
- 补回已废弃 .text() 访问路径的测试覆盖
- 清理 FileCallbackHandler 与 ChatGeneration 文档遗留条目
langchain langchain-anthropic==1.7.2：版本变化解读
langchain-anthropic 1.7.2 修复了保留无效工具使用块的问题，确保在 Anthropic 模型响应中即使工具调用被判定无效也能正确传递完整块内容。影响依赖 Anthropic 工具调用的开发者，建议升级验证。官方说明未提供更多细节。
- 修复 Anthropic 集成中无效工具使用块被丢弃的问题
- 适用于使用 Anthropic 工具调用的链式与智能体场景
langchain langchain-openai==1.6.2：版本变化解读
langchain-openai 1.6.2 为 GPT-6 Astra 增加新的推理 effort 配置，并将 httpx2 依赖从 2.10.0 升级到 2.12.0。影响使用 OpenAI 新推理模型档位的开发者，需注意依赖变更。官方说明未提供更多细节。
- 新增 GPT-6 Astra 推理 effort 配置支持
- httpx2 依赖升级到 2.12.0
langchain langchain-openai==1.6.1：版本变化解读
langchain-openai 1.6.1 新增异步工具调用与 configuration_update 支持，修复 Azure AD 鉴权兼容 OpenAI 3.8 的问题，调整 GPT-5 与 GPT-5.1 推理档位配置并将 gpt-5.6-sol 路由到 responses API，同时刷新模型档案数据。影响所有 OpenAI 集成用户，建议升级。官方说明未提供更多细节。
- 新增异步工具调用与 configuration_update 支持
- 修复 Azure AD 鉴权与 OpenAI 3.8 兼容问题
- 调整 GPT-5 与 GPT-5.1 推理档位并刷新模型档案数据
- 将 gpt-5.6-sol 路由到 responses API
langchain langchain-core==1.6.2：版本变化解读
langchain-core 1.6.2 修复 google-genai 与 bedrock converse 标准内容中可能的变更问题，并将 mistune 与 tornado 等依赖升级到最新补丁版本。影响依赖这些集成的开发者，建议升级验证。官方说明未提供更多细节。
- 修复 google-genai 与 bedrock converse 标准内容的变更问题
- mistune 升级到 3.3.3、tornado 升级到 6.5.8
langchain langchain==1.4.0：引入 langchain.mcp 命名空间与 MCPAdapter
本版本发布 langchain 1.4.0，引入 langchain.mcp 命名空间与 MCPAdapter，优化 Anthropic 中间件追踪输入，修复代理工具路由未带模型目标的问题，并提升 vcrpy 测试依赖最低版本。影响需要集成 MCP 协议或调试多工具代理路由的开发者，属于值得关注的功能性版本。
- 新增 langchain.mcp 命名空间与 MCPAdapter
- 优化 Anthropic 中间件追踪输入性能
- 修复代理工具路由缺失模型目标的问题
langchain langchain-anthropic==1.7.1：版本变化解读
该版本新增 Claude Fable 5.1 模型支持，并跟随主仓库对中间件 trace 输入进行精简以提升性能。影响使用 Anthropic Claude Fable 5.1 或关心 trace 性能的开发者，属于小版本增量更新。
- 新增 Claude Fable 5.1 模型支持
- 中间件 trace 输入精简以提升性能
langchain langchain==1.4.0a4：版本变化解读
此为 1.4.0 系列第四个 alpha 版本，核心围绕 langchain.mcp 命名空间与 MCPAdapter 进行大规模重构，包括按协议时代区分客户端、收敛请求与响应类型、引入 ClientGroup 支持多服务器场景，并以中断路由替代轮询式的续轮处理。官方说明未提供更多细节，适合关注 MCP 接入演进的高级用户提前验证，正式版本前不建议生产使用。
- MCPAdapter 引入 ClientGroup 以支持多服务器舰队
- 按协议时代区分请求与响应类型并优化 elicitation 流程
- 以中断路由替代 MCP 续轮轮询
- 收敛 MCP 命名空间并提升 fastmcp 依赖基线
langchain langchain==1.4.0a3：版本变化解读
这是 1.4.0 系列的第三个 alpha，正式公开 langchain.mcp 命名空间与 MCPAdapter，把任意 fastmcp.Client 支持的目标适配为 LangChain 工具：URL、本地脚本、内存服务器、MCPConfig 以及 ClientGroup 都可作为接入来源。新增 list_tools 的客户端缓存模式（use/refresh/bypass），并支持把 MCP elicitation 路由为 LangGraph 中断。需要通过 pip install "langchain[mcp]" 安装，并要求 fastmcp 版本不低于 4.0.0。影响希望在 Lang
- 引入 MCPAdapter 与 langchain.mcp 命名空间
- 新增 list_tools 的客户端缓存模式（use / refresh / bypass）
- 支持将 MCP elicitation 路由为 LangGraph 中断
- 要求 fastmcp 不低于 4.0.0 并将该命名空间标记为 beta
langchain langchain==1.4.0a2：版本变化解读
1.4.0 系列的第二个 alpha，首次官方预览 langchain.mcp 命名空间，提供 MCPAdapter 把任意 MCP 服务器转成可直接交给 create_agent 的工具。连接复用 FastMCP 客户端，支持 URL、本地 stdio 脚本、内存服务器、多服务器配置与自定义 fastmcp.Client；认证、缓存、超时等高级能力通过自建客户端透传，多服务器场景下工具按服务器名做命名空间区分，并兼容新旧 MCP 协议服务器共存于同一代理。影响希望把外部 MCP 服务接入 LangChain 代理的开发者。
- 首发 langchain.mcp 与 MCPAdapter 适配器
- 支持多服务器配置与按服务器命名的工具命名空间
- 兼容新旧 MCP 协议服务器共存于同一代理
- 认证、缓存等高级能力通过自建 fastmcp.Client 透传