OpenAI Prompt Object 将停用:如何把提示词迁回应用代码
OpenAI 文档列明 /v1/prompts 与可复用 Prompt Object 计划于 11 月 30 日停用。本文给出调用识别、代码迁移、回归验收与回滚步骤。
如果应用的 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}` }
]
});
- 先导出并核对每个仍在使用的提示词版本,把模板放进私有应用仓库的命名模块;不要把客户数据或密钥一起提交。
- 将变量映射为受校验的函数参数,保持原有消息角色、业务约束和输出格式;同时更新调用方,不再发送
prompt.id。 - 使用脱敏的代表性样本并行比较新旧调用:正确性、结构化输出、拒答、延迟和 token 用量。对涉及工具调用的流程加上不执行危险动作的沙盒样本。
- 先灰度少量流量,记录模板版本与请求 ID;保留切回上一应用版本的能力,完成后再移除旧 Prompt Object 引用。
中转平台的适用范围
这项弃用针对 OpenAI 管理的 Prompt Object 与相应端点,不等于所有“提示词”功能都会停用。第三方中转是否透传 prompt 对象取决于其接口实现;本文没有对 LondAI 网关做兼容性实测,也没有改动鉴权、计费或数据库。如果应用通过本站接入,先在测试账号核对支持的端点与字段,别把官方接口能力直接视作本站能力。
发布前的验收与回退
检查代码和请求样本中不再出现 pmpt_ ID 或 /v1/prompts 调用;用同一批脱敏输入比较输出结构、业务规则、usage 和费用。迁移失败时回退应用代码版本并恢复旧提示词映射,但官方停用日期后不能依赖旧端点长期回退。基础接入方式见 LondAI 接入文档;若需要排查限流,可参考 OpenAI API 429 排查。