OpenAI Python SDK 3.55.0 更新解读:Live MCP 参数与预算类型兼容性

小林子
小林子
发布时间:2026-11-18| 7人浏览过
原创

OpenAI Python SDK 3.55.0 更新解读:Live MCP 参数与预算类型兼容性。说明已核实的更新范围、类型兼容性和本地版本确认方法。

3.55.0 版 Python 客户端增加了实时会话的工具服务配置,同时调整托管代理预算相关公开类型。对 Python 项目而言,升级前最需要确认的是:现有代码是否使用这些配置,是否直接依赖被隐藏的预算事件类型。

OpenAI Python SDK v3.55.0 官方发行页面

先看正式版本的变化范围

OpenAI Python SDK v3.55.0 于 2026 年 11 月 18 日发布。发行说明只有两项功能条目:Live MCP server configuration,以及隐藏 Managed Agents 会话预算控制和事件。这里的 Live 是具体接口范围,不宜把这次变化直接扩大成所有 Responses 或聊天调用的新行为。

3.55.0 官方功能条目:Live MCP 配置与预算控制和事件类型调整

新增字段解决什么配置问题

对应源码在 Live Responses 委派配置的 ToolMcp 类型中补充了 MCP 服务相关参数。server_label 标识服务,server_url 指向服务地址;allowed_tools 约束可使用的工具,require_approval 表达审批要求,authorization 则属于授权配置。参数能够被 SDK 表达,与远端服务已成功授权,是两个不同阶段。

tunnel_id 也是这次配置中的字段,用于通过 Secure MCP Tunnel 连接本地 MCP 服务。它并不是让 SDK 自动启动一个本地 MCP 服务器。实际连接的服务、工具能力和权限设置,仍需与部署环境一致。

直接导入预算事件类的项目要留意

版本差异删除了公开的 AgentSessionBudgetReachedEvent,并收窄了相关公开会话状态、事件类型和错误枚举。若程序通过这一类做导入或类型判断,就存在需要适配的接口差异。不能仅凭安装命令执行成功便认定业务代码完全兼容。

运行器源码仍然能处理私有预算事件。这说明发行说明中的 hide 描述的是公开接口的可见范围,不能据此宣布预算限制取消,也不能推断实际账单或服务器限制发生改变。对旧状态集合进行严格穷举的逻辑,同样需要关注这一边界。

在正确的解释器环境中确认版本

下面两行在项目虚拟环境中执行,依次安装固定版本并输出实际导入的 SDK 版本。预期版本字符串为 3.55.0;如果输出不同,说明当前解释器导入的依赖还不是目标版本。这一检查不会发送 API 请求,也不需要配置密钥。

python -m pip install --upgrade "openai==3.55.0"
python -c "import openai; print(openai.__version__)"

依赖版本检查与真实业务回归承担不同作用。使用 Live MCP 的项目需要评估连接与审批配置,使用 Managed Agents 的项目需要关注事件处理兼容性。只使用其他客户端功能的程序,也应依据自身依赖管理方式安排升级,而不是把这两项更新当作必须改写全部调用代码的信号。

相关专题:

免责声明:本文内容仅供参考,不代表本站观点。转载或引用请注明出处。

Python 相关产品和应用

全部下载
Selenium

Selenium

4.51.0 · Windows

用于浏览器自动化和 Web 测试的 Python 工具。

scikit-learn

scikit-learn

1.9.1 · Windows

常用 Python 机器学习算法与模型评估工具库。

Black

Black

26.10.1 · Windows

强调一致性的 Python 自动代码格式化工具。

Ruff

Ruff

0.17.1 · macOS

由 Rust 编写的高速 Python 代码检查和格式化工具。

pytest

pytest

9.1.1 · Windows

简洁而强大的 Python 自动化测试框架。

FastAPI

FastAPI

0.146.0 · Windows

高性能 Python API 框架,支持类型提示和自动接口文档。

Flask

Flask

3.1.3 · Windows

轻量灵活的 Python Web 应用框架。

Django

Django

6.1.2 · Windows

成熟的 Python Web 框架,适合构建内容站点和业务系统。

Spyder

Spyder

6.1.7 · Windows

面向科学计算与数据分析的 Python 集成开发环境。

SciPy

SciPy

1.18.1 · Windows

面向科学、工程和技术计算的 Python 算法库。