OpenAI Agents SDK JS 0.22.0:迁移类型与保存状态,修复待审批压缩和实时中断
Air Explorer Pro是一款跨平台多网盘管理工具,可实现一站式完成不同网盘间文件的互传、搜索和同步等操作。任务管理和过程控制会更完整,持续下载、批量同步或需要稳定传输流程的场景会更适合它。
OpenAI Agents SDK JS 0.22.0调整usage、Realtime图像、MCP描述与保存状态类型,并修复待审批期间的自动压缩及早期实时中断。升级时要同时验证TypeScript检查、旧状态恢复和工具审批链路。
OpenAI Agents SDK JS 0.22.0调整usage、Realtime图像、MCP描述与保存状态类型,并修复待审批期间的自动压缩及早期实时中断。升级时要同时验证TypeScript检查、旧状态恢复和工具审批链路。
Agents SDK JS 0.22.0升级检查顺序
- 在现有项目中核对直接使用的@openai/agents、agents-core、agents-realtime和agents-extensions包及锁文件,按项目包管理器升级相应0.22.0依赖。
- 执行项目现有TypeScript检查,逐一处理可空描述、unknown元数据及可选转写字段,不用强制类型断言掩盖差异。
- 用保存的旧会话样本验证恢复;另外测试包含丰富元数据或嵌套运行的1.24状态。
- 在测试环境检查工具待审批期间的压缩、审批后恢复,以及Realtime早期手动中断。
- 按现有发布流程部署,保留原锁文件与状态样本用于排查。
0.22.0升级首先检查哪些TypeScript类型
agents-core与agents-realtime的说明明确列出需要调用方适配的类型变化:usage细节、Realtime图像内容、可空MCP描述、未知结构的schema和tracing元数据,以及可选的转写细分字段。读取这些值时,应先按实际结构检查或收窄,不能继续假定所有字段始终是固定字符串或必填对象。
保存状态1.23与1.24怎样处理
兼容的保存状态继续保留schema 1.23;包含更丰富元数据或较新嵌套运行内容时使用1.24。不能把所有历史记录无条件改写成新版本号。应保留一份旧状态样本,分别验证普通会话、嵌套运行和审批恢复,确认现有存储与恢复流程能正确读取。
依据:官方原文;Realtime 0.22.0发布说明;Extensions 0.22.0发布说明
工具审批与Responses压缩为什么要一起验收
自动Responses压缩在存在待处理工具审批时被延后,避免压缩与审批恢复发生冲突。另有修复使带防护的终端工具在嵌套审批后恢复运行。应用升级时,应把暂停、批准、恢复和拒绝作为完整链路检查,而不是仅验证首次工具调用。

Realtime手动打断怎样验证
实时包会在音频尚未开始时手动中断活跃WebSocket响应。可在受控会话中测试两个时点:响应已启动但音频未播放,以及音频已经播放。核对应用的中断操作、响应状态与后续音频,避免只以播放器暂时静音判断服务端响应已经取消。
沙箱文件和追踪数据有什么变化
core增加了替换现有文件前的工作区归档校验,改进运行中Docker会话资源的落地权限与复制限制;extensions避免为托管工作区文件操作使用登录Shell。追踪在启用敏感数据捕获时,可向自定义处理器暴露提供给Chat Completions的工具定义,但托管OpenAI追踪导出会省略它们,因此不同导出目的地不能按同样内容推断。
依据:官方原文;Realtime 0.22.0发布说明;Extensions 0.22.0发布说明
OpenAI Agents SDK JS 0.22.0常见问题解答
所有保存状态都会改成1.24吗?
不会,官方说明兼容状态保留1.23,只有需要较新内容时使用1.24。
只使用普通Agents包是否与子包无关?
应检查锁文件中的实际依赖;普通包依赖的core变化也可能影响应用的类型与恢复流程。





























