OpenAI Prompt Object 将停用:如何把提示词迁回应用代码

OpenAI 文档列明 /v1/prompts 与可复用 Prompt Object 计划于 11 月 30 日停用。本文给出调用识别、代码迁移、回归验收与回滚步骤。

关键词
LALondAI 内容团队发布日期 2026-11-16
6 分钟阅读模型教程
LA
OpenAI Prompt Object 将停用:如何把提示词迁回应用代码
OpenAI Prompt Object官方来源与可执行检查LondAI 内容团队

如果应用的 Responses API 请求仍传入 prompt.id、version 或 variables,需要在 2026 年 11 月 30 日前制定迁移计划。OpenAI 的官方弃用清单将 /v1/prompts 和可复用提示词对象列为当日停用,建议把提示词内容放回应用代码。只使用普通文本消息的应用不必因为这项变更替换模型。

先定位受影响调用

在业务仓库中搜索 /v1/prompts、pmpt_、prompt: { id 及模板版本字段,列出使用它们的任务、调用端、提示词版本和负责人。不要在排查输出、工单或文章中记录真实 API Key、客户输入和完整提示词。OpenAI 迁移指南展示了旧调用用 prompt 对象引用版本和变量、新调用直接传 model 与 input 的差别。

迁移时哪些行为会变

原先服务端保存的模板内容与变量替换,改由应用在调用前生成。提示词版本因此需要跟随代码发布:把稳定指令放在有名字的模块中,动态字段通过经过校验的参数填入,记录模板版本号与发布版本。变量不能直接拼进最高优先级指令;来自用户的文本应保留为用户输入,并对长度与格式做校验。官方Prompting 指南建议将生产提示词作为应用代码管理,并让提示词变更经过测试与发布评审。

一个最小迁移例子

以下是说明请求形状的脱敏示例,模型仅作示意,实际调用需使用账号可用模型和现有 SDK 支持的字段。旧请求中的 prompt.id 与版本号被应用管理的系统消息和用户消息取代:

const systemText = "你是客服助手。回答要准确、简短。";
const customerName = "示例客户";
const issue = "示例问题";
const response = await client.responses.create({
  model: "gpt-6-astra",
  input: [
    { role: "system", content: systemText },
    { role: "user", content: `客户:${customerName};问题:${issue}` }
  ]
});
  1. 先导出并核对每个仍在使用的提示词版本,把模板放进私有应用仓库的命名模块;不要把客户数据或密钥一起提交。
  2. 将变量映射为受校验的函数参数,保持原有消息角色、业务约束和输出格式;同时更新调用方,不再发送 prompt.id。
  3. 使用脱敏的代表性样本并行比较新旧调用:正确性、结构化输出、拒答、延迟和 token 用量。对涉及工具调用的流程加上不执行危险动作的沙盒样本。
  4. 先灰度少量流量,记录模板版本与请求 ID;保留切回上一应用版本的能力,完成后再移除旧 Prompt Object 引用。

中转平台的适用范围

这项弃用针对 OpenAI 管理的 Prompt Object 与相应端点,不等于所有“提示词”功能都会停用。第三方中转是否透传 prompt 对象取决于其接口实现;本文没有对 LondAI 网关做兼容性实测,也没有改动鉴权、计费或数据库。如果应用通过本站接入,先在测试账号核对支持的端点与字段,别把官方接口能力直接视作本站能力。

发布前的验收与回退

检查代码和请求样本中不再出现 pmpt_ ID 或 /v1/prompts 调用;用同一批脱敏输入比较输出结构、业务规则、usage 和费用。迁移失败时回退应用代码版本并恢复旧提示词映射,但官方停用日期后不能依赖旧端点长期回退。基础接入方式见 LondAI 接入文档;若需要排查限流,可参考 OpenAI API 429 排查。