3.55.0 版官方 python 客户端已经发布,这次更新集中在实时会话的工具服务配置,以及托管代理的会话预算类型。使用相关接口的项目应重点核对这两处差异;普通调用是否需要修改,仍取决于项目是否依赖这些功能。

这次更新包含什么
OpenAI Python SDK 在 2026 年 11 月 18 日发布 v3.55.0。官方发行说明列出两项功能变化:增加 Live MCP server configuration,以及隐藏 Managed Agents session budget controls and events。它们分别涉及 MCP 服务配置和托管代理预算控制、事件的公开类型范围,不能合并理解成所有 API 的通用行为变化。

Live MCP 的配置更完整了
在 Live 的 Responses 委派配置类型中,ToolMcp 增加了服务地址、工具筛选和审批等相关字段。例如 server_url 对应 MCP 服务地址,allowed_tools 限定可用工具,require_approval 控制工具调用的审批要求。server_label 用于标识服务,authorization 对应授权信息;这些字段的作用不同,配置时需要分别考虑。
立即学习“Python免费学习笔记(深入)”;
Camoufox 是一个基于 Firefox 构建的开源反检测浏览器,为 Python 自动化工作流程提供强大的指纹注入和反机器人检测规避功能。它与 Playwright 集成,以提供能够绕过现代机器人检测系统的隐身浏览能力。
源码还包含 tunnel_id,用于通过 Secure MCP Tunnel 连接本地 MCP 服务。此次 SDK 类型变化不等于替项目部署好了服务器,也不意味着任何地址都能连通。工具名称、连接权限和实际服务能力仍然由所连接的 MCP 服务决定。
预算事件的变化影响哪些代码
3.55.0 的差异中移除了公开的 AgentSessionBudgetReachedEvent 类型,并调整了会话状态、事件联合类型及相关错误枚举。直接导入这一事件类,或者用公开类型穷举预算状态的程序,需要评估升级后的兼容性。
与此同时,代理运行器仍保留对私有预算事件的处理分支。因此,隐藏公开类型不能推导为取消预算上限、停止计费,或保证再也不会触发预算相关停止条件。项目需要区分公开接口约定与运行器内部处理,避免把旧枚举当作完整的服务器行为列表。
怎样确认实际安装版本
在项目所用的 Python 虚拟环境中执行下面这组命令。第一行将客户端固定到本次版本,第二行读取当前解释器实际导入的版本;正常情况下应输出 3.55.0。该检查不调用模型,也不需要 API 密钥。
python -m pip install --upgrade "openai==3.55.0" python -c "import openai; print(openai.__version__)"
版本确认只证明依赖已切换,不代表 MCP 连接或代理业务已经通过验证。对于依赖上述类型的项目,升级评估应覆盖原有事件处理和工具审批逻辑;没有使用这些接口的应用,则可以先按照自身依赖更新流程安排测试。

















