OpenAI SDK v3.35.0 更新：Agents 新增极速服务层级

OpenAI 官方 SDK 发布 v3.35.0 版本，这次更新聚焦在实时 API 能力与 Agents 性能层级的扩展。对于正在构建语音、实时对话或代理型应用的开发者来说，几个改动值得关注。

实时 API：新增带类型的 Live sideband 事件

本次发布为实时 API 增加了带类型的 Live sideband 事件（PR #4099）。

在此之前，sideband 事件往往需要开发者自行解析原始结构，类型信息不够明确。新增类型化事件后，开发者可以在代码中获得更准确的类型提示，减少手动解析和运行时错误。Sideband 连接主要用于在实时会话之外接收事件流，例如转写结果、工具调用状态等，类型化之后会更适合 TypeScript 等强类型语言项目。

对于已经在使用 Realtime API 做语音助手的团队，这个改动属于渐进式增强：不需要重写业务逻辑，但能明显改善开发体验与代码可维护性。

Sideband 连接是 Realtime API 中一条独立于主 WebSocket 会话的事件通道：主会话负责承载音频流的双向传输，sideband 则用于把转写文本、工具调用状态、会话更新等控制类事件外送到另一个连接上。这种设计让服务端可以在不干扰音频链路的前提下观察会话状态，也便于后端进程独立消费事件。在类型化之前，这些事件通常以未标注的原始对象形式暴露，TypeScript 开发者需要自行比对事件名与字段结构。类型化后，SDK 会为每类事件生成对应的判别联合类型，编辑器可直接给出字段补全与收窄提示，编译期即可发现字段拼写或结构误用。

Agents 新增 ultrafast 服务层级

另一个特性是为 Agents 增加了 ultrafast 服务层级（PR #4101）。

服务层级本质上是请求调度优先级的控制手段。Agents 场景通常涉及多轮工具调用和较长的推理链路，端到端延迟会直接影响用户体验。新增的 ultrafast 层级意味着开发者可以选择一个更低延迟的调度选项，适合对响应速度敏感的代理工作流。

说个细节，原文并未披露 ultrafast 的具体延迟指标、计费方式或可用范围，因此实际效果仍需结合官方文档和真实负载测试来评估。

**服务层级（service tier）**在 OpenAI API 中通常以请求参数形式传入，用于在标准调度与更高优先级调度之间做选择，其代价一般体现在计费单价或配额消耗上，而非接口形态的变化。Agents 工作流的多轮工具调用意味着单次用户请求可能串行触发多次模型调用，每一跳的网络与排队延迟都会累加，因此调度优先级对端到端时延的影响比单轮对话更明显。ultrafast 属于新增的档位，与既有的 priority 等层级并列，开发者需在请求中显式指定才会生效，未指定时仍走默认层级。由于官方尚未公布该层级的速率限制与价格，建议先用小流量灰度对比 P95 延迟再决定是否全量切换。

WebSocket 字节接收的修复

Bug 修复方面，实时模块修复了在 websockets 13 下字节接收被破坏的问题（PR #4098）。

对于通过 WebSocket 传输二进制音频或自定义二进制协议的实时应用，这类问题往往表现为数据截断或解析失败，排查成本较高。此次修复针对 websockets 13 版本的兼容性，说明 SDK 在跟进底层依赖版本变化时保持同步。使用实时音频流或二进制帧的开发者建议升级并回归测试。

websockets 是 Python 生态中主流的 WebSocket 客户端/服务端实现库，其 13 版本对底层接收逻辑做了调整，部分依赖方因此出现二进制帧处理异常。当 SDK 通过该库接收音频分片时，若字节对象在传递过程中被错误地按文本解码或截断，上层拿到的就是长度不符的缓冲区，表现为音频卡顿、帧边界错乱或 JSON 解析报错。这类问题的难点在于症状出现在业务层，根因却埋在传输层依赖里。此次修复说明 SDK 已针对 websockets 13 的接收路径做了适配，锁定旧版本的项目也应确认自身的依赖解析结果，避免因间接依赖升级而被动触发同类问题。

升级建议

从版本号看，3.35.0 属于次版本迭代，没有破坏性变更提示。依赖实时 API 的团队优先升级以获取 WebSocket 修复；使用 Agents 且对延迟敏感的项目可以评估 ultrafast 层级是否符合自身需求。

版本发布于 10 月 17 日，提交带有 GitHub 验证签名，可通过官方 changelog 核对完整差异。

总体来看，这次更新延续了 OpenAI SDK 在实时能力上的投入节奏：一边补齐类型系统，一边给代理场景增加性能调节手段，同时修复底层传输兼容性问题。