Assistants API Migration Note

这页现在更适合拿来做“旧项目迁移说明”，不适合新项目入门。按 OpenAI 官方文档，Assistants API 已弃用，并给出了关闭日期 2026-08-26，同时建议迁移到 Responses API。

#先说结论

• 新项目：不要再把 Assistants 当默认方案
• 老项目：先盘点现有 Assistant / Thread / Run
• 迁移目标：逐步转到 Responses API

如果你现在是在读旧仓库代码，这页还有价值；如果你准备新接 OpenAI 功能，应该直接走 Responses API 路线。

#为什么会迁移

OpenAI 官方迁移文档给出的方向很清楚：

• Assistants -> Prompts
• Threads -> Conversations
• Runs -> Responses

背后的核心原因，是 Responses API 的心智更简单，也更统一。

#老的 Assistants 模型大概长什么样

旧流程通常是：

1. 创建 Assistant
2. 创建 Thread
3. 往 Thread 写 Message
4. 发起 Run
5. 等待工具调用和最终结果

这套模型不是不能用，而是对新项目来说已经不是主路线。

#迁移时先盘什么

别一上来就直接改代码。更稳的顺序通常是：

1. 盘每个 Assistant 的 instructions 和 tools
2. 盘业务里哪些地方依赖 Thread 持久上下文
3. 盘 Run 逻辑里是否有工具循环、重试或人工兜底

把这三件事盘清楚，再迁到 Responses，风险会小很多。

#一个更现实的迁移策略

不要整仓一口气切。更稳的办法是：

1. 先找一个最简单的助手流程
2. 用 Responses API 重做一条等价链路
3. 对比结果、日志和错误处理
4. 再逐步替换复杂流程

#Related pages

• OpenAI API overview
• Quickstart
• Chat basics