OpenAI Python SDK发布v3.23.0:Agents流支持类型化回答,新增会话追踪与实时翻译接口
v3.23.0于 2026 年 10 月 1 日发布,Agents相关功能集中在流式返回类型化答案、文件暂存与下载轮次产物;API侧新增session traces和Realtime translations,并修复Chat Completions图片详情、eval取消端点等六处问题。
AI解读:这是一次偏向Agents开发者的功能版本。最直接的变化是session流开始返回类型化答案,以及可以把文件暂存、下载每一轮的产物,写agent循环时少做一层手工解析和文件搬运。
API侧新增session traces和Realtime translations,前者关注会话过程可追踪,后者指向实时翻译场景;beta里的类型化application actions可以作为agent工具暴露出来,等于把已在SDK中定义好的动作直接接进工具调用。
修bug的部分同样值得看:Chat Completions允许original级别的图片细节,eval运行取消端点被纠正,WebSocket路径和查询参数在重连后保留。最后一条对长连接应用更实际——断线重连不该把URL上的参数弄丢。
整体上这是常规迭代,没有模型或定价变化。已经用beta Agents接口的项目可以从升级中受益;只用基础Chat Completions的项目,需要留意的只有图片detail参数这一项修正。
OpenAI的官方Python SDK openai-python发布v3.23.0,版本日期为 2026 年 10 月 1 日。该版本由openai-sdks[bot] 在GitHub Releases上发布,列出 5 项Features、6 项Bug Fixes和 4 项Chores。
Features中与Agents直接相关的有三项:从session流返回类型化答案(#4007)、暂存文件并下载每轮产物(#4009)、从beta Agents流中收集最终输出(commit 157ac4c)。API侧新增session traces和Realtime translations(#4001),beta侧把类型化application actions暴露为agent工具(#4006)。
Bug Fixes涉及:Chat Completions允许original图片细节(#4005)、修正eval运行取消端点(#4003)、在WebSocket重连时保留端点路径与查询参数(#3999)、在主分支推进时保持Castiron预算结果有效(#4012)、重连时避免重放不确定的类型化发送(#4011)、重连时遵守发送队列限制(#4000),以及文件处理超时改用单调时钟(#3748)。
Chores包括保留WebRTC Live session传输类型(#4002),以及三项依赖升级:pyright从 1.1.413 升到 1.1.414(#3902)、astral-sh/setup-uv从 10.0.1 升到 10.1.0(#3976)、CodeQL actions升到 4.38.1(#3974)。