如果你的 Agent 还在创建 Assistant、Thread 或 Run，眼下最危险的不是模型答错，而是请求已经没有服务可接。OpenAI 官方迁移页确认：Assistants API 于 2026 年 8 月 26 日正式 sunset，现已不可用。
受影响的通常是客服机器人、知识库、长会话和工具调用应用。Assistants API 过去把配置、会话和执行过程包装成一组持久对象。官方迁移目标是 Responses API，但这不是一次 endpoint 改名。
截止日期已过，404 只是一个开发者信号
官方迁移指南现在写的是“已正式下线，且不再可用”，不是仍可延期的弃用提醒。8 月 27 日，有开发者在 OpenAI 社区报告旧 GET /v1/assistants 返回 404，并询问能否找回 Assistant instructions。
这条帖子说明下线已经影响到具体维护工作，但它只是一个个案。不能据此推断所有账号都会得到相同结果，更不能宣称所有旧 Thread 已被删除。
先看懂四组对象映射
| Assistants 旧对象 | Responses 侧对象 |
|---|---|
Assistants | Prompts |
Threads | Conversations |
Runs | Responses |
Run steps | Items |
这里变的不只是名词。Prompt 接手模型、工具和 instructions 等配置；Conversation 保存消息、工具调用和输出等 Item；Response 接收输入并返回输出，工具调用循环要由应用显式管理。
恢复业务，先走这条最小路径
- 搜代码、环境变量、后台任务和监控，定位
/v1/assistants、/v1/threads、/v1/runs，以及 SDK 中的beta.assistants、beta.threads。 - 盘点旧 Assistant 的 instructions、模型和工具声明。优先从源码、自有备份或仍可访问的管理入口保存，不要假设旧读取接口还能工作。
- 按官方映射重建。官方文档要求在 Dashboard 把 instruction 与 tool bundle 建成具名 Prompt，再让代码引用稳定的 Prompt ID；长会话迁到 Conversation 与 Item。
- 重做回归测试，覆盖冷启动恢复、多轮状态、工具调用中断与重试，以及文件检索或知识库链路。
旧 Run 轮询代码也要单独检查。Responses 的请求、结果和工具循环都变了，一次成功响应不能证明迁移已经完成。
为什么改 URL 救不了旧应用
旧 Assistant 是通过 API 管理的持久配置对象，Thread 主要保存消息，Run 在线程上执行。迁移后，配置进入可版本化的 Prompt，会话变成 Item 流；历史裁剪、工具循环和重试等编排职责，也更明确地落在应用侧。
直接替换 endpoint，往往会同时撞上请求格式、状态恢复和工具调用问题。官方没有承诺 Responses 与 Assistants 无缝兼容，测试夹具也必须跟着对象模型重建。
哪些团队今天就该检查
仍维护 OpenAI Agent、客服机器人、知识库、长会话或工具调用应用的团队，应立即做依赖盘点。主服务已经迁移，也别漏掉定时任务、旧客户端和灾备脚本。
只使用 Responses API，或项目从未依赖 Assistants、Threads 与 Runs 的开发者，不必重做架构。确认依赖树里没有遗留的旧 SDK 调用即可。
