langchain-openai
LangChain 生态中连接 OpenAI 模型的核心集成包,为开发者提供基于 OpenAI API 构建 LLM 应用的标准化接口,支持流式调用、工具调用等能力
核心事实
时间轴 (近 90 天)
langchain-openai 1.7.2 修复了 OpenAI Responses API 在流式场景下 output_index 发生漂移时,流式返回条目被错误拆分到多个 block 中的问题(PR #41121)。
修复后,langchain-openai 会识别 output_index 漂移并主动归并,使下游看到的 block 数量与语义边界保持一致。
langchain-openai 1.7.2 自 1.7.1 以来的变更包括 release(openai): 1.7.2(PR #41245)和 fix(openai): keep Responses stream items on one block when output_index drifts(PR #41121)。
langchain-openai 是 LangChain 与 OpenAI 模型之间的适配层,其版本节奏通常跟随上游 API 的变化。
对于已经锁定 1.7.1 的项目,升级到 1.7.2 的风险较低,变更范围小且主要围绕一个已知缺陷的修复。
对于使用 langchain-openai 版本低于 1.7.1 且涉及流式输出场景的项目,建议评估升级到 1.7.2,升级命令为 pip install -U langchain-openai==1.7.2。
output_index 漂移导致的问题在表象上可能是输出内容被截断、消息块拼接错乱,或者在某些情况下触发解析异常。
本次中间对话支持的声明同时涉及 core、anthropic 和 openai 三个包
PR #41180 的标题是 "declare mid-conversation support in model profiles",即在模型配置档案中声明对话中途支持能力。
本次 1.7.1 发布说明中未附带对话中途支持能力的详细行为文档,实际项目启用前建议针对目标模型做验证。
还有 24 条时间轴事件
全部知识事实 (20)
可通过 pip install -U langchain-core==1.6.6 命令完成升级
90%已验证即便是补丁更新,也建议在 CI 流程中运行完整测试套件以确保升级后应用行为一致
75%待验证修复后,langchain-openai 会识别 output_index 漂移并主动归并,使下游看到的 block 数量与语义边界保持一致。
50%待验证langchain-openai 1.7.2 修复了 OpenAI Responses API 在流式场景下 output_index 发生漂移时,流式返回条目被错误拆分到多个 block 中的问题(PR #41121)。
50%待验证output_index 漂移导致的问题在表象上可能是输出内容被截断、消息块拼接错乱,或者在某些情况下触发解析异常。
50%待验证对于使用 langchain-openai 版本低于 1.7.1 且涉及流式输出场景的项目,建议评估升级到 1.7.2,升级命令为 pip install -U langchain-openai==1.7.2。
50%待验证对于已经锁定 1.7.1 的项目,升级到 1.7.2 的风险较低,变更范围小且主要围绕一个已知缺陷的修复。
50%待验证langchain-openai 是 LangChain 与 OpenAI 模型之间的适配层,其版本节奏通常跟随上游 API 的变化。
50%待验证langchain-openai 1.7.2 自 1.7.1 以来的变更包括 release(openai): 1.7.2(PR #41245)和 fix(openai): keep Responses stream items on one block when output_index drifts(PR #41121)。
50%待验证如果项目同时安装 langchain-core、langchain-openai、langchain-anthropic 等包,建议一并升级到相互兼容的版本,避免能力声明与实际实现不一致。
50%待验证如果只升级 langchain-openai 而未同步升级 core,可能出现上层读取 profile 的逻辑不认识新字段,或声明被忽略但不报错的情况。
50%待验证langchain-openai 1.7.0 通过 PR #41125 新增了对 Decisions API 的支持
50%待验证依赖升级主要集中在 /libs/partners/openai 目录下
50%待验证1.6.5 版本的对话中途工具变更特性可简化开发者此前为实现动态工具集编写的 workaround 代码
50%待验证在此前版本中,流式调用 OpenAI 接口时服务端返回的错误事件可能无法正确作为异常抛出,导致错误被静默吞掉
50%待验证1.6.6 包含常规发布提交 PR #40800 'release(openai): 1.6.6'
50%待验证1.6.6 是补丁级版本,仅涉及错误处理逻辑修复而非 API 变更,向后兼容
50%待验证作者建议使用 langchain-openai 流式能力的团队评估升级到 1.6.6 以获得更可预测的异常行为
50%待验证langchain-openai 是 LangChain 生态中连接 OpenAI 模型的核心集成组件
50%待验证1.6.6 的核心修复为 PR #40791 'fix(openai): raise on error events in stream path'
50%