For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主导航
Codex

Codex use case

升级您的 API 集成

升级您的应用,使其使用最新的 OpenAI API 模型。

Difficulty 中级
Time horizon 1 小时

使用 Codex 将现有 OpenAI API 集成更新到最新推荐的模型和 API 功能,并在发布前检查是否出现回归。

最适合

  • 从旧模型或旧版 API 接口升级的团队
  • 需要通过明确验证确保迁移前后行为一致的代码仓库

Contents

    ← 全部使用场景

    升级您的 API 集成

    升级您的应用,使其使用最新的 OpenAI API 模型。

    使用 Codex 将现有 OpenAI API 集成更新到最新推荐的模型和 API 功能,并在发布前检查是否出现回归。

    中级
    1 小时

    使用 Codex 将现有 OpenAI API 集成更新到最新推荐的模型和 API 功能,并在发布前检查是否出现回归。

    中级
    1 小时

    最适合

    • 从旧模型或旧版 API 接口升级的团队
    • 需要通过明确验证确保迁移前后行为一致的代码仓库

    技能与插件

    • 在 Codex 修改您的实现之前,先获取当前的模型、迁移和 API 指南。
    Skill Why use it
    OpenAI Docs 在 Codex 修改您的实现之前,先获取当前的模型、迁移和 API 指南。

    入门提示

    使用 $openai-docs 将此 OpenAI 集成升级到最新推荐的模型和 API 功能。 具体来说,请查找专门针对该模型的最新模型指南和提示词指南。 要求: - 首先梳理代码仓库中当前使用的模型、端点和工具使用假设。 - 确定一套最精简的迁移计划,使我们采用最新的受支持方案。 - 除非新 API 或模型要求变更,否则保持现有行为不变。 - 按照最新的模型提示词指南更新提示词。 - 明确指出任何需要我们手动审查的提示词、工具或响应结构变更。
    使用 $openai-docs 将此 OpenAI 集成升级到最新推荐的模型和 API 功能。 具体来说,请查找专门针对该模型的最新模型指南和提示词指南。 要求: - 首先梳理代码仓库中当前使用的模型、端点和工具使用假设。 - 确定一套最精简的迁移计划,使我们采用最新的受支持方案。 - 除非新 API 或模型要求变更,否则保持现有行为不变。 - 按照最新的模型提示词指南更新提示词。 - 明确指出任何需要我们手动审查的提示词、工具或响应结构变更。

    简介

    随着我们发布新模型和 API 功能,建议您升级集成,以便从最新改进中受益。 从一个模型切换到另一个模型,通常并非只需更新模型名称那么简单。

    API 可能会发生变化——例如,针对 GPT-5.4 模型,我们为助手消息新增了 phase 参数,您的集成务必要包含该参数——但更重要的是,模型行为也可能有所不同,需要您修改现有提示词。

    迁移到新模型时,您不仅应完成必要的代码修改,还应评估迁移对工作流的影响。

    利用 OpenAI 文档技能

    模型指南 页面汇集了针对各代模型的 API 功能指南、模型行为指南、迁移指南和提示词指南。

    OpenAI 文档技能还提供了 具体指导,可直接作为迁移参考。对于当前的升级目标,请使用 模型指南 页面。

    Codex 现已默认内置 OpenAI 文档技能,因此,使用 OpenAI API 进行开发时,请务必在提示词中提及该技能,以获取所有最新文档和指南。

    构建稳健的评测流水线

    Codex 可根据最新的提示词指南自动更新您的提示词,但您还应建立自动验证机制,确认集成是否按预期运行。

    请务必构建一条评测流水线,以便每次修改集成时都能运行该流水线,验证行为未发生回归。

    这篇 Cookbook 指南 详细介绍了实现这一点的方法,即使用我们的 Evals API

    相关使用场景