返回实战项目
可复现实验API 迁移进阶

用 Codex Migration Pack 完成 Responses API 迁移演练

在公开的 OpenAI 迁移工具包上,从固定版本、dry-run、diff 审查到测试,完成一次可回滚的 API 迁移演练。

公开仓库:openai/completions-responses-migration-pack核验于 2026/07/21

任务说明

在一个只含最小旧 Completions 调用的测试仓库中先生成迁移计划,再应用变更并验证请求结构;不接触生产 key 和生产数据。

开始前准备

  • ·固定工具包 commit。
  • ·备份目标分支。
  • ·先 dry-run。

给 Codex 的执行步骤

  1. 1克隆官方迁移工具包并记录 commit。
  2. 2阅读 README、SECURITY 和脚本,运行 bash 语法检查。
  3. 3创建最小测试仓库并执行 --dry-run。
  4. 4审查生成计划后在隔离分支应用。
  5. 5运行测试并检查 store、streaming 与 tool 调用行为。

预期代码变更

  • ·旧请求入口迁移到 Responses API。
  • ·请求与返回读取方式按当前 SDK 调整。
  • ·补充或更新迁移测试与说明。

测试命令

bash -n scripts/completions-to-responses-upgrade.sh && git diff --check && 在目标测试仓库运行其原有 lint/test

结果边界

只有 dry-run、diff 和目标仓库测试都通过才可认为演练完成。;该项目不证明任意生产系统可以自动迁移,也不包含真实 API key。

复盘问题

  • ·固定 commit 和校验脚本来源比直接执行 main 一行命令更可审计。
  • ·Codex 能帮助生成迁移,但 API 行为、数据保留和费用仍需人工确认。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. openai/completions-responses-migration-pack

    官方来源 · https://github.com/openai/completions-responses-migration-pack