OpenAI Agents SDK v0.24.0-alpha.7 于 2026-11-08T07:05:11Z 发布,调整了三项配置。该版本标记为预发布版,改动涉及环境执行、MCP 授权模式值和内置推理默认值。发行说明介绍的是配置变更,并非正式发布,也不代表已有采用证据。
OpenAI Agents SDK 调整环境执行默认设置
对于新建的环境,默认值变为 write_policy="strict",这要求使用兼容的 Linux 或 macOS 执行器。工作目录仍可写,发行说明指出可通过 writable_roots 配置其他目录。
若构建者希望保留之前的远程策略,可设置 write_policy="legacy" 并将 writable_roots=None。本地执行要求使用 strict 模式。恢复旧版远程检查点或配置文件时,发行说明表示应显式选择 legacy;仅仅重新打开并不会升级其策略。发行说明没有表示现有环境会被自动改写。
OpenAI Agents SDK 替换两个 MCP 授权模式值
旧的 approval_mode 值 "auto" 和 "approve" 不再接受。它们分别替换为 "native" 和 "preapproved",发行说明称新名称保留了各自对应的授权行为。文档所述变更涉及重命名及其对校验的影响;发行说明并未描述授权行为的重新设计。
OpenAI Agents SDK 为三个模型设置中等推理默认值
对于 gpt-6-astra、gpt-6.1-sol 和 gpt-5.6-sol,默认推理力度从 low 改为 medium。需要沿用旧力度的开发者可以显式设置 model_settings={"reasoning_effort": "low"}。提供商的模型元数据可以选择其他值。发行说明明确的是默认值变更,并未表明模型质量或输出发生了经测量的变化。
OpenAI Agents SDK Alpha 版说明配置范围
发行说明区分了新建环境使用的 strict 模式,以及旧远程策略和恢复行为使用的 legacy 设置;本地执行则另行要求 strict 模式。发行说明还将文档所述的 MCP 映射限定为两个授权模式值,并将推理调整限定为三个指定模型。发行说明没有说明 MCP 行为或其他模型默认值有更广泛的变化。
OpenAI Agents SDK Alpha 版配置详情
- 该版本为 OpenAI Agents SDK v0.24.0-alpha.7,标记为预发布版。
- GitHub 发行版 API 记录显示,发布时间为 2026-11-08T07:05:11Z。
- 新建的环境默认使用 write_policy="strict",这要求使用兼容的 Linux 或 macOS 执行器。
- 工作目录仍可写,其他可写目录通过 writable_roots 配置。
- 可通过 write_policy="legacy" 和 writable_roots=None 保留之前的远程策略;本地执行要求使用 strict 模式。
- 被拒绝的 MCP approval_mode 值为 "auto" 和 "approve";它们分别替换为 "native" 和 "preapproved"。
- 对于 gpt-6-astra、gpt-6.1-sol 和 gpt-5.6-sol,默认推理力度从 low 改为 medium。
- 可通过 model_settings={"reasoning_effort": "low"} 设置之前的推理力度。
常见问题
OpenAI Agents SDK v0.24.0-alpha.7 有哪些变化?
该预发布版调整了环境执行默认设置、MCP 授权值和内置推理默认值。新建环境的默认值为 write_policy="strict";两个旧的 MCP 授权值不再接受并被替换;三个指定模型的默认推理力度从 low 改为 medium。
哪些模型的默认推理力度为 medium?
文档所述模型为 gpt-6-astra、gpt-6.1-sol 和 gpt-5.6-sol。需要沿用之前 low 设置的开发者可以显式设置 model_settings={"reasoning_effort": "low"}。
旧的 MCP 授权值由什么替代?
该版本将 "auto" 替换为 "native",将 "approve" 替换为 "preapproved"。发行说明称,新名称保留了各自对应的授权行为。