OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化
Air Explorer Pro是一款跨平台多网盘管理工具,可实现一站式完成不同网盘间文件的互传、搜索和同步等操作。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。
OpenAI Python SDK 3.55.0 升级看点:Live MCP 服务配置与预算接口变化。说明已核实的更新范围、类型兼容性和本地版本确认方法。
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 服务会自动完成连接。

Live MCP 服务可以怎样配置
与发行说明对应的源码在 Live Responses 委派配置中扩展了 ToolMcp。server_label 用于标识 MCP 服务,server_url 用于指定地址;allowed_tools 表达允许使用的工具,require_approval 表达审批要求,authorization 负责授权信息。将这些配置分开理解,有助于避免把地址填写、授权完成和工具可用当作同一个结果。
其中还出现了 tunnel_id,用于通过 Secure MCP Tunnel 连接本地 MCP 服务。它不意味着安装 Python 包就自动具备一台工具服务器。真正的工具能力、访问许可和运行环境,需要与所连接的服务匹配。
旧预算事件类型可能需要适配
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__)"
确认版本后,升级工作的重点取决于项目:使用 Live MCP 时关注服务配置和审批要求,使用 Managed Agents 时关注公开事件类型的兼容性。没有使用上述接口的项目,也应沿用自身依赖测试流程,不宜从更新标题推断所有调用方式都已改变。
































