OpenAI Agents SDK v0.24.0-alpha.8升级前为何要备份状态?
OpenAI Agents SDK v0.24.0-alpha.8预览版新增执行前审批、自有模型客户端、Realtime与预算检查点恢复,说明alpha.7回退、Linux运行及工具认证边界。
OpenAI Agents SDK v0.24.0-alpha.8预览版扩展工具审批、模型客户端和预算状态恢复;其中新的预算检查点格式不能由alpha.7读取。它适合评估原生Session的新能力;升级涉及状态格式、网络规则和工具授权边界,不能把alpha.7的环境与配置直接视为完全兼容。

工具审批检查的是实际调用参数
这个版本的managed approvals允许应用在Python工具运行前检查参数,并批准或拒绝本次调用。决定可以在当前Session的剩余生命周期内记住。它处理的是执行授权,不代表模型提出的每一个调用都自动获得运行许可,也不替代应用对工具可访问资源的限制。
严格Python工具的原始参数如果没有通过校验,SDK会先向模型返回可重试错误,不进入审批或回调执行。模型修正参数后,仍然要走所要求的审批流程。因此,参数符合结构与用户同意执行是两个不同条件。
FunctionToolApprovalRequest和FunctionToolApprovalDecision提供对应的请求与决定类型。run_input_policy_before_approval=True可让输入策略在审批谓词之前运行,并在执行前继续运行;这对希望先审查输入、再决定是否请求授权的应用有意义。

自有模型客户端与实时语音分别接入哪一层
原生工具循环可以接应用拥有的异步Responses客户端、Chat Completions客户端、LiteLLM、AnyLLM和自定义适配器。这里的变化是客户端接入方式,不能据此认定任意提供商都支持全部模型功能或具有相同的请求行为。
Session的Realtime语音支持服务器WebSocket、浏览器WebRTC,以及接入已有SIP通话。原生Session Realtime接口位于agents.realtime.native;保留的Classic/v0 Realtime接口仍在agents.realtime。两套导入路径对应不同接口,不应混用。
预算检查点恢复为什么需要备份
alpha.7支持运行中的预算控制,alpha.8进一步支持带请求预算或token预算的部分待处理运行检查点。恢复时,已消耗的请求数或token仍计入预算,不会因为恢复就从零开始。
新预算格式无法由alpha.7执行约束,所以alpha.7会拒绝该格式。官方明确要求升级前备份已保存状态;回退后无法打开状态时,需要使用升级前的备份。这不是对所有状态都无法回退的结论。
官方验证范围包括Linux x86-64上空闲检查点、等待手动Python工具回复的检查点,以及已关闭的LocalStorage配置;测试使用匹配的应用设置和两版共同支持的能力。它不等于任意平台、任意待处理MCP请求或复杂子任务都已获兼容保证。部分恢复路径对未完成调用、暂存输入和原后端继续执行还有单独限制。
Linux运行环境和网络规则有哪些限制
预览版增加Linux ARM64 wheel,两个Linux wheel均要求glibc 2.28或更新版本。发布说明报告在四个平台上使用CPython 3.10和3.14做了全新安装验证;项目声明Python最低版本为3.10。预览wheel从GitHub Releases提供,不能把这个预览版描述成已经获得所有Python版本和Linux发行版的实机验证。
Linux本地执行需要兼容的bubblewrap,并在/usr/bin或/bin提供bwrap,同时允许创建沙箱命名空间。Docker执行器则需要镜像或执行器包中带有bwrap。仅满足glibc版本并不能替代这些执行环境前提。
网络域名规则中的裸星号需要改成精确主机或限定范围的模式。允许公共主机出站的NetworkPolicy.allow_all()在Linux还要求allow_all_unix_sockets=True,以及与主机服务和其他任务隔离的执行器。Windows目前仍不支持显式网络策略,不能将Linux规则直接解释为Windows也可用。
已有应用还要分清模型认证与工具权限
保存的Codex登录现在只提供模型认证。需要ChatGPT Apps工具的Agent必须带有ChatGPTAppsMCP声明,并提供已配置的Apps token、账户ID和允许暴露的工具名称。模型能完成认证,不等于已获全部应用工具权限。
对于保存历史的应用,同一次执行可能同时出现提供商的function_call、function_call_output和类型化记录。官方要求按原生thread_id、turn_id与call_id关联,而不是按历史行数重复计数。升级评估应围绕实际使用的审批、状态和历史读取路径展开,保留预览版边界。




























