OpenAI Python SDK 3.20.0：Agents 凭据/会话选项、Responses Cyber 访问计划，WebSocket 增量文本与工具快照可观测

核心背景与行业痛点

面向 Agents 与 Responses/Realtime 的 Python 客户端正成为长会话编排的默认入口。痛点集中在三处：凭据轮换时被迫整包替换鉴权；合规场景需要声明 Cyber 访问计划却缺少类型字段；WebSocket 流若省略 HTTP/SSE 脚手架，调用方难以拿到累计文本与工具输入的中间态，排障只能拼原始事件。

架构亮点与底层机制

v3.20.0 在 Agents 侧为 vault 凭据增加 metadata，并允许在不替换鉴权材料的情况下更新凭据；会话选项纳入 ultrafast 服务档，错误码补充 misalignment_policy_violation（#3967）。Responses 创建参数支持 access_programs.cyber，枚举 standard / daybreak_blue / daybreak_red，响应对象回传已解析计划（#3956）。流式侧新增可选 ResponsesWebSocketAccumulator：由调用方喂入事件，产出不可变的增量文本/工具快照与精确终态响应，不接管 socket、不代跑工具（#3973）。Live/Realtime 同步修复路径查询串泄漏、队列重放不确定性与未映射 TLS 传输错误重试。

权威 Benchmark 与实测跑分对比

本版未公布 SWE-bench 或端到端延迟对比表。发行说明给出工程验收信号：#3973 称在 Pydantic v1/v2 上各跑通 190 项 WebSocket/accumulator 与 23 项 Responses 测试。请在自有链路验证：Cyber 字段是否按租户策略落库；Accumulator 快照是否与终态一致；Live 长连接在分数秒转录分组截止时是否不再挂起。勿把测试计数外推为线上吞吐基准。

开发者实战落地与开箱指南

升级：pip install -U "openai>=3.20.0"。Agents 自建 Credential 模型时需提供 metadata（可为 {}）；接入 Responses 时按合规要求设置 access_programs.cyber。需要流式可观测时显式启用 Accumulator，而不是依赖默认 SSE 累积路径。完整字段见 api.md 与 平台 API 文档；变更清单见 发行说明。