升级至 GPT-5.4

当用户明确要求将现有集成升级到 GPT-5.4 时，请使用本指南。结合当前的 OpenAI 文档查询。默认目标字符串为 gpt-5.4.

升级原则

以最窄的安全变更集进行升级：

• 首先替换模型字符串
• 仅更新与该模型使用直接相关的提示词
• 尽可能首选仅提示词的升级
• 如果升级需要 API 接口层面的更改、参数重写、工具重新连接或更广泛的代码编辑，请将其标记为受阻，而不是扩大范围

升级工作流

1. 盘点当前的模型使用情况。
   • 搜索模型字符串、客户端调用和包含提示词的文件。
   • 包括内联提示词、提示词模板、YAML 或 JSON 配置、Markdown 文档以及保存的提示词（当它们明显与模型使用位置相关时）。
2. 将每个模型使用与其提示词层面配对。
   • 优先选择最接近的提示词层面：首先是内联系统或开发者文本，其次是相邻的提示词文件，然后是共享模板。
   • 如果您无法自信地将提示词与模型使用联系起来，请如实说明，而不是猜测。
3. 对源模型系列进行分类。
   • 常见分类： gpt-4o or gpt-4.1, o1 or o3 or o4-mini，早期 gpt-5，随后 gpt-5.x,或混合且不明确。
4. 确定升级类别。
   • model string only
   • model string + light prompt rewrite
   • blocked without code changes
5. 运行无代码兼容性检查。
   • 检查当前集成是否可以接受 gpt-5.4 而无需 API 接口层面的更改或实现层面的更改。
   • 对于长时间运行的响应或重度依赖工具的代理，请检查 phase 在宿主程序重放助手项目或使用前导内容时，是否已经被保留或进行往返处理。
   • 如果兼容性取决于代码更改，则返回 blocked.
   • 如果兼容性不明确，则返回 unknown 而不是临时调整。
6. 提供升级建议。
   • 默认替换字符串： gpt-5.4
   • 保持干预措施最小化且保留原有行为。
7. 提供结构化的建议。
   • Current model usage
   • Recommended model-string updates
   • Starting reasoning recommendation
   • Prompt updates
   • Phase assessment 当工作流是长时间运行的、重放的或重度依赖工具的
   • No-code compatibility check
   • Validation plan
   • Launch-day refresh items

输出规则：

• 始终发出一个起始 reasoning_effort_recommendation for each usage site.
• 如果代码库暴露了当前的推理设置，请首先保留它，除非源指南另有说明。
• 如果代码库未暴露当前设置，请使用源系列的起始映射，而不是返回 null.

升级结果

model string only

在以下情况选择此项：

• 现有提示词已经简短、明确且任务边界清晰
• 该工作流并非重度依赖研究、重度依赖工具、多代理、批处理或对完整性敏感，也非长期运行
• 没有明显的兼容性障碍

默认操作：

• 将模型字符串替换为 gpt-5.4
• 保持提示词不变
• 使用现有的评估或抽检来验证行为

model string + light prompt rewrite

在以下情况选择此项：

• 旧提示词是为了弥补较弱的指令遵循能力
• 工作流需要比默认的工具使用行为可能提供的更高的持久性
• 任务需要更强的完整性、引用规范或验证
• 除非另有指示，否则升级后的模型会变得过于冗长或不够完整
• 该工作流重度依赖研究，需要更强地处理稀疏或空的检索结果
• 该工作流面向编码、重度依赖工具或是多代理的，但现有的 API 接口和工具定义可以保持不变

默认操作：

• 将模型字符串替换为 gpt-5.4
• 添加一两个有针对性的提示词块
• 阅读 GPT-5.4 的提示词指南 以选择能恢复旧行为的最小提示词更改
• 避免进行与升级无关的大范围提示词清理
• 对于研究工作流，默认为 research_mode + citation_rules + empty_result_handling；是否添加 tool_persistence_rules 当宿主程序已使用检索工具时
• 对于依赖感知或重度依赖工具的工作流，默认为 tool_persistence_rules + dependency_checks + verification_loop；是否添加 parallel_tool_calling 仅在检索步骤真正独立时
• 对于编码或终端工作流，默认为 terminal_tool_hygiene + verification_loop
• 对于多智能体支持或分流工作流，默认至少包含以下之一 tool_persistence_rules, completeness_contract, or verification_loop
• 对于带有前言或多条助手消息的长时间运行的 Responses 智能体，请明确审查 phase 是否已得到处理；如果要添加或保留 phase 需要编辑代码，请将该路径标记为 blocked
• 不要仅仅因为可见代码片段非常精简，就将使用工具的 Responses 编码工作流分类为 blocked ；优先选择 model string + light prompt rewrite 除非代码库明确显示安全的 GPT-5.4 路径需要进行宿主端代码更改

blocked

在以下情况选择此项：

• 此次升级似乎需要更改 API 接口
• 此次升级似乎需要参数重写或对未在实现代码外部暴露的推理设置进行更改
• 此次升级需要更改工具定义、工具处理程序绑定或 schema 契约
• 您无法确切识别与模型使用相关的提示词接口

默认操作：

• 不要临时草率进行更大范围的升级
• 报告阻碍原因，并说明该修复超出了本指南的范围

无代码兼容性检查清单

在推荐无代码升级之前，请检查：

1. 当前宿主能否在不更改客户端代码或 API 接口的情况下接受 gpt-5.4 模型字符串？
2. 相关的提示词是否可识别且可编辑？
3. 宿主是否依赖于可能需要更改 API 接口、重写参数或重新绑定工具的行为？
4. 可能的修复是否仅涉及提示词，还是需要更改实现代码？
5. 提示词接口是否与模型的使用足够接近，以便您进行针对性更改而不是进行大规模清理？
6. 对于长时间运行的 Responses 或重度使用工具的智能体，如果宿主依赖于前言、重放的助手项或多条助手消息，是否已保留 phase 如果宿主依赖于前置语、重放的助手项或多个助手消息，是否已保留？

如果第 1 项为否，第 3 至 4 项指向实现工作，或者第 6 项为否且修复需要代码更改，请返回 blocked.

如果第 2 项为否，请返回 unknown 除非用户能指明提示词的位置。

Important:

• 现有对工具、智能体或多个使用站点的使用本身并不是阻碍。
• 如果当前宿主可以保持相同的 API 接口和相同的工具定义，请优先选择 model string + light prompt rewrite 优于 blocked.
• 将 blocked 保留给那些真正需要更改实现代码的情况，而不是仅需要更强提示词引导的情况。

范围界定

本指南可以：

• 更新或推荐更新的模型字符串
• 更新或推荐更新的提示词
• 检查代码和提示词文件以了解这些更改所属的位置
• 检查现有的 Responses 流程是否已保留 phase
• 标记兼容性阻碍

本指南不得：

• 将 Chat Completions 代码迁移至 Responses
• 将 Responses 代码迁移至其他 API 接口
• 重写参数结构
• 更改工具定义或工具调用处理
• 更改结构化输出绑定
• 在实现代码中添加或改造 phase 处理
• 编辑业务逻辑、编排逻辑或 SDK 用法（超出字面上的模型字符串替换）

如果安全的 GPT-5.4 升级需要上述任何更改，请将该路径标记为已阻碍并超出范围。

验证计划

• 使用现有的评估或实际的抽查来验证每个升级后的使用站点。
• 检查升级后的模型是否仍然符合预期的延迟、输出结构和质量。
• 如果添加了提示词编辑，请确认每个代码块都在发挥实际作用，而不是增加噪音。
• 如果工作流具有下游影响，请在最终确定之前增加一次轻量级验证。

发布日刷新项

当最终的 GPT-5.4 指南发生更改时：

1. 在适当的情况下，用最终的 GPT-5.4 指南替换发布候选假设。
2. 重新检查默认目标字符串是否应保持为 gpt-5.4 for all source families.
3. 重新检查任何其语义可能已发生更改的提示词块建议。
4. 根据最终的模型行为，重新检查研究、引用和兼容性指南。
5. 重新运行相同的升级场景，并确认“已阻碍”与“可行”的边界仍然成立。