OpenAI Python SDK发布v3.20.0，新增Agents凭据与WebSocket快照选项
该版本于 2026-09-28 发布，新增Agents凭据和会话选项、Responses的Cyber访问程序，并允许通过opt-in方式获取增量WebSocket文本与工具快照，同时修复多项实时与WebSocket相关问题。
AI解读：OpenAI Python SDK 3.20.0已发布，日期是 2026-09-28。改动集中在两个方向：Agents相关的凭据和会话配置，以及Responses接口的WebSocket流式能力。
对直接调用Responses WebSocket的开发者来说，这版让增量文本与工具快照可以按需开启，并让累加器快照保留更细的信息；同时修掉了一批连接、队列和重放问题。
如果你只用普通同步或异步HTTP调用，不影响日常使用；真正需要关注的是依赖WebSocket实时流、且对快照粒度和重连行为敏感的场景。
Live相关修复针对的是挂起、查询参数被带进端点路径、调用方队列被破坏等具体故障，说明此前这些边界情况确实会造成实际影响，但官方未给出修复前后的对比数据。
OpenAI Python SDK发布 3.20.0 版本，发布日期为 2026-09-28，上一个版本是 3.19.2。版本说明列出了Features与Bug Fixes两类改动。
Features：Agents凭据、Cyber访问程序与WebSocket快照
新增功能包括：api增加Agents credential and session options（#3967），以及为Responses增加Cyber access programs（#3956）。
Responses相关新增两项：通过opt-in方式启用增量WebSocket文本和工具快照（#3973），以及保留详细的WebSocket accumulator快照（#3981）。
- api：新增Agents凭据与会话选项（#3967）
- api：为Responses新增Cyber访问程序（#3956）
- responses：可选择启用增量WebSocket文本与工具快照（#3973）
- responses：保留详细的WebSocket累加器快照（#3981）
Bug Fixes：TLS重试、Live挂起与WebSocket队列
客户端侧修复了未被映射的TLS传输错误的重试问题（#3982）。
live模块修复三类问题：在分数化转写分组截止时间上避免挂起（#3970）、避免把查询参数放进WebSocket端点路径（#3972）、保留调用方队列并阻止不确定的WebSocket重放（#3980）。
realtime模块修复两类问题：在WebSocket升级时保留基础URL的查询参数（#3971），以及在不重放已尝试发送内容的前提下保留配置的队列（#3978）。
- client：重试未映射的TLS传输错误（#3982）
- live：避免分数化转写分组截止时间处的挂起（#3970）
- live：不把查询参数放进WebSocket端点路径（#3972）
- live：保留调用方队列并防止不确定的WebSocket重放（#3980）
- realtime：WebSocket升级时保留基础URL查询参数（#3971）
- realtime：保留已配置队列，不重放已尝试的发送（#3978）
Chores：补充API错误响应文档
该版本还包含一组文档整理工作，主要澄清和补充API错误响应说明，涉及批次、文件与上传、微调与模型、Responses未找到错误，以及已存储的聊天补全错误。
- 澄清已文档化的API错误响应（#3965）
- 补充批次错误响应文档（#3961）
- 补充文件与上传错误响应文档（#3960）
- 补充微调与模型错误文档（#3964）
- 补充Responses未找到错误文档（#3959）
- 补充已存储聊天补全错误文档（#3963）