概览
使用 Codex 将你现有的 OpenAI API 集成更新到最新推荐的模型和 API 功能，并在发布前检查是否出现回归。
适合场景
- 从旧模型或旧 API 接口升级的团队
- 需要通过显式验证来进行行为保持型迁移的代码仓库
安全地升级集成
使用 $openai-docs 将这个 OpenAI 集成升级到最新推荐的模型和 API 功能。 具体来说，请查找这个特定模型的最新模型指南和提示词指南。 要求： - 先梳理代码仓库中当前使用的模型、端点和工具假设。 - 确定一个能让我们迁移到最新受支持方案的最小迁移计划。 - 除非新 API 或模型要求变更，否则保持现有行为不变。 - 根据最新的模型提示词指南更新提示词。 - 明确指出任何需要我们手动审查的提示词、工具或响应结构变更。
简介
随着我们发布新模型和 API 功能，我们建议你升级集成，以受益于最新改进。 从一个模型切换到另一个模型，通常并不只是更新模型名称这么简单。
API 可能也会发生变化——例如，对于 GPT-5.4 模型，我们在 assistant message 中新增了一个 phase 参数，这个参数在你的集成中很重要，应该包含进去——但更重要的是，模型行为可能会不同，并且需要你修改现有提示词。
迁移到新模型时，你应当确保不仅完成必要的代码修改，还要评估这些变更对你的工作流带来的影响。
利用 OpenAI Docs skill
关于新 API 功能和模型行为的所有细节，都记录在我们的文档中，包括 最新模型 和 提示词指南 指南。
OpenAI Docs skill 还包含一份具体指南，可作为实际迁移参考。对于当前的升级目标，请使用 最新模型 指南。
Codex 现在会自动附带 OpenAI Docs skill，因此在使用 OpenAI API 构建时，请确保在提示词中提及它，以访问所有最新文档和指南。
构建可靠的 evals 流水线
Codex 可以根据最新的提示词指南自动更新你的提示词，但你仍应具备一种自动验证集成是否按预期工作的方式。
请务必构建一条 evals 流水线，以便你在每次修改集成时都能运行它，从而验证行为没有发生回归。
这篇 Cookbook 指南 详细介绍了如何使用我们的 Evals API 来完成这件事。