Responses API 与 Chat Completions 是不同的应用接口约定，不是换个 URL 就能互通。迁移 Coding Agent 前，既要检查返回解析，也要检查工具循环、流式事件和对话状态，不能只看短问题能否返回文字。
根据 2026 年 9 月 29 日核验的官方迁移指南，OpenAI 建议新项目使用 Responses，同时继续支持 Chat Completions。第三方兼容接口的能力，需要另行验证。
先判断迁移是否解决你的问题
当所选模型、客户端或所需能力要求 Responses，或者你明确希望采用这种集成方式时，再迁移。正在正常工作的应用，不必只因为接口名称更新就匆忙改造。
先列出 Agent 实际要做的事情：纯文本、结构化输出、本地函数调用、流式、图片，还是服务商托管工具。每一项分别作为验收要求。
如果同时要整合服务商，可看一把 Key 的多模型迁移指南。避免同时改协议、模型、接口和提示词，否则出现故障时很难判断原因。
对照应用真正读取的接口约定
以上差异来自官方迁移指南，不代表一个网关实现了 OpenAI 的所有功能。
不要假设第一个输出 Item 一定是给用户看的正文。流式连接成功，也不能证明应用正确处理了完成、失败和工具事件。
验证一个完整的 Agent 循环
接真实工具之前，先用不会产生外部影响的测试数据。
对照协议时固定模型和任务。目标是应用正确性，不是证明某个接口永远更聪明或更便宜。通信测试通过后，再用小规模代码回归集检查实际产出。
保留可以恢复的旧路径
通过可控配置切换适配层。在关键任务通过、用量记录能对上之前，保留旧路径。不要为了比较效果，让两条路径同时执行会产生外部影响的真实任务。
明确谁管理对话状态。不要一边使用服务端续接机制，一边不加判断地重复发送全部历史。要确认所选接口的数据保留和续接行为；用了同一个 SDK，不等于这些能力兼容。
验证你真正要用的接口
Agent.Space Developer API 指南说明模型发现和协议选择，可用于确认受支持的集成方式，但不能据此推断服务商托管工具全部兼容。
需要接入受支持的模型路径时，可以打开 Agent.Space。把生产工作转过去之前，先验证一个完整且范围明确的 Agent 循环。