OpenAI
页面内容为机器翻译。查看英文原文

Assistants API v2 的发布会如何影响我使用 API v1 启动的 Assistants?

对 Playground、成本和迁移的影响

更新于:13 days ago

截至 2025 年 3 月 11 日,我们已发布新智能体平台的构建模块。如需了解详情,请参阅我们的 API 文档:Responses API、包括 网页搜索文件搜索计算机使用在内的工具,以及带有 追踪功能的 智能体 SDK

  • 不会自动升级:你当前的 Assistants、Threads 和 Runs 不会自动迁移到 v2。除非你选择手动迁移,否则它们仍可在 v1 API 下访问并正常运行。

  • 可访问两个版本:你可以完全访问 v1 和 v2 这两个 API 版本。这意味着你可以继续为现有助手使用 v1,也可以探索 v2 提供的新功能和改进。

  • Token 使用量差异:v1 和 v2 之间的 Token 使用量可能有所不同,尤其是 file_search 和 retrieval 等工具。虽然 v2 中的 file_search 工具与 v1 中的 retrieval 工具相比,平均通常消耗更少的 Token,但如果你愿意,仍可通过 v1 版本标头使用较旧的 retrieval 工具。

  • 迁移选项:虽然 Playground UI 和更新后的 SDK 版本已迁移为使用 API 的 v2 版本,但你的 Assistants 不会自动升级。你可以灵活选择在集成中使用哪个 API 版本。请记住,Assistant 对象没有默认 API 版本,因此如果你愿意,可以继续使用较旧版本直到 2024 年底。如需了解有关从 Assistants v1 迁移到 v2 的更多信息,请查看这份迁移指南

这篇文章对你有帮助吗?