OpenAI SDK 新增 Browser/Computer 工具集（1/4）：BrowserToolset 把驱动方法变成 Responses 函数工具

2026-10-14，两包官方 SDK 同日落下四个稳定版：openai-python v3.30.0、v3.31.0 与 openai-node v7.33.0、v7.34.0（四节版本日期均出自两包 CHANGELOG，本站于 2026-10-15 抓取核对）。头条是一条两包逐字相同的 feature——"add browser and computer toolsets (1/4)"。本文按惯例只写 CHANGELOG 与 v3.31.0 tag 源码/文档里能指出的东西；官方文档域（openai.com / developers.openai.com）对本站持续 403，SDK 层之外不断言。

BrowserToolset：函数工具，不是新原生类型

v3.31.0 tag 的 docs/browser.md 开篇即划定形态：

BrowserToolset turns a supplied driver's methods into Responses function tools. It does not add a native browser tool type to the Responses API. The model must support function tools.

也就是说，模型侧不出现新的原生浏览器工具类型——驱动实现什么方法，工具集就暴露什么函数工具。截图走原生 input_image 部件送进 function_call_output，同时附一份 input_text 状态报告。

browser.py 模块 docstring 进一步写明职责边界：

Drivers own the browser and may implement any subset of the documented members. Only direct URLs are checked here; network isolation belongs to the driver.

直连 URL 在工具集层做检查，网络隔离整体划给驱动侧。构造签名 BrowserToolset(driver, members=..., additional_members=..., confirm_reads=...) 显示工具暴露可按成员选择，还带读取确认开关（confirm_reads）。配套文档四篇随版本入库：browser.md、browser-forms.md、browser-navigation.md、browser-providers.md。

ComputerToolset：走 computer 工具面

computer 侧对应 ComputerToolset，模块 docstring 一句话："Run the Responses computer tool with a caller-owned browser or desktop driver."——与 browser 侧的差异在工具面：一个把动作包装成普通函数工具，一个复用 Responses 的 computer 工具，且驱动既可以是浏览器也可以是桌面。

官方快速上手用 Playwright 演示（pip install openai playwright==1.63.0 + playwright install chromium，要求 Python 3.10+）：一个本地只读浏览器 reader 示例，另有一个名为 Fieldwork 的预约表单演示（examples/browser-use-demo）。

(1/4)：标注存在，其余未释

两包 CHANGELOG 都把这条 feature 标为 "(1/4)"。截至 2026-10-15（本站核对两包 CHANGELOG 当日版本），第 2-4 段的内容与投放时间均未见说明——本文不对其做任何推断，只记录该标注存在。

同日其余特性：治理与合规向

openai-python v3.30.0 的 feature 面几乎全是治理向：beta 会话消费限额（#4058）、OCI 外部存储 provider（#4060）、组织级 Decisions 用量上报（#4062）、图片工具错误与审核细节（#4072）、图片 URL 与详细安全告警解释（#4061）、项目 API key 过期更新（#4066）；外加一条流式修复——async HTTP/1.1 连接复用恢复（#4041）。

openai-node v7.33.0 除工具集外，还补齐了 python 3.29.0（2026-10-11）已有的几个面：billing_not_active 会话错误码（#2911）、Live 命名声音 shida（#2912）、vault 更新与元数据过滤（#2906）、beta 分页限制与非空参数对齐（#2915）。两包版本号不对应是既定事实——同一 API 面落在不同版本号，跨语言对照按特性名与 PR 对齐，不要按版本号对齐。

openai-node v7.34.0 是单特性版本："add regional processing residency options"（#2942，区域处理数据驻留选项）。python 侧同期（截至 2026-10-15）没有对应版本发布。

对谁有用

• 做 agent 浏览器自动化的开发者：结构化动作 + 函数工具的组合意味着无需自研工具Schema——写驱动、选成员即可；网络隔离与浏览器生命周期仍归你管。
• 关注成本治理的团队：会话消费限额 + 项目 key 过期 + Decisions 用量上报，三条都在同一天落进稳定 SDK。
• 有数据驻留需求的组织：node 7.34.0 的 residency options 值得单独评估（python 侧暂无对应，跨语言栈需等齐）。

下一步

• 想了解这两包 SDK 此前的 agent 环境资源线，见《OpenAI SDK 出现托管 Agent 环境资源：prewarmed 预热创建、闲置挂起与过期事件》。
• 长会话上下文管理见《Responses API 压缩进度事件解读：response.compaction.compacting、compaction_trigger 与长会话上下文压缩》。
• 官方文档域恢复可达后，本站会补一轮工具集的端到端实测（lastTestedAt 届时更新）。