截至 2025 年 3 月 11 日，我们已发布新 Agents 平台的构建模块。有关详细信息，请参阅我们的 Responses API API 文档、包括 Web Search、File Search 和 Computer Use 在内的工具，以及包含 Tracing 的 Agents SDK。根据你对 Assistants API beta 的反馈，我们已将关键改进纳入 Responses API。在实现完整功能对等后，我们将在今年晚些时候公布 Assistants API 弃用计划，目标停止使用日期为 2026 年上半年。
常见问题
什么是 Assistants API？
Assistants API 让开发者能够在自己的应用中轻松构建功能强大的 AI 助手。使用此 API，无需自行管理对话历史，还能使用由 OpenAI 托管的工具，例如代码解释器和文件搜索。该 API 还支持改进后的函数调用功能，用于调用第三方工具。
我还能使用 Assistants API v1 beta 吗？
不能。自 2024 年 12 月 18 日起，用户已无法再使用 Assistant API beta 的 v1 版本。我们目前仅支持 v2。请参阅此迁移指南，将您的 API 调用从 v1 迁移到 v2。
我如何访问它？
任何拥有 OpenAI API 账户的人都可以使用 Assistants API，但它已弃用，并将于 2026 年 8 月移除。对于新项目，请改用 Responses API。如果你已在使用 Assistants API，请规划迁移到 Responses API。在该 API 仍可用期间，你仍可在 Assistants Playground 中访问现有 assistants。
什么是助手？
助手是为特定用途构建的 AI，使用 OpenAI 的模型，能够访问文件、维护持久化的对话线程并调用工具。
什么是对话线程？
对话线程是助手与用户之间的一次对话会话。对话线程会存储消息历史，并在对话超出模型的上下文长度时进行截断，从而简化应用开发。
什么是文件搜索工具？
file_search 工具内置了多项检索最佳实践，无需额外配置即可帮助你从文件中提取相关数据，提升模型的回答质量。
file_search 工具默认使用以下设置：
分块大小：800 个 token
分块重叠大小：400 个 token
嵌入模型：text-embedding-3-large，使用 256 维向量
添加到上下文的分块数量上限：20
文件上传有哪些限制？
文件上传的限制如下：
每个文件最多 512 MB
每个文件最多 500 万个 token
每个向量存储最多 1 万个文件
每个助手最多 1 个向量存储
每个对话线程最多 1 个向量存储
组织内每个项目的总存储空间上限为 100 GB。
文件搜索工具有哪些限制？
目前存在以下已知限制，我们正努力在未来几个月内补充相关功能：
目前无法修改分块、嵌入或检索设置。
不支持解析文档中的图像。
不支持检索结构化格式的文件（例如 .csv 或 .jsonl 文件）。查看支持的文件类型。
Assistants API 有哪些速率限制？
Assistants API 的速率限制与用量等级和模型无关。默认限制按请求类型设置，但有少数例外：
GET：每分钟 1000 次请求
POST：每分钟 300 次请求
DELETE：每分钟 300 次请求
API 中的代码解释器如何计费？
代码解释器的费用为每个会话 0.03 美元。如果你的助手在两个不同的对话线程中同时调用代码解释器，就会创建两个代码解释器会话（2 × 0.03 美元）。每个会话默认保持活跃一小时。这意味着，如果你的用户在这一小时内一直在同一个对话线程中向代码解释器发送指令，你只需支付一次费用。
API 中的文件搜索如何计费？
文件搜索按向量存储空间计费，费用为每天每 GB 0.10 美元（首个 GB 免费）。向量存储的大小以文件经过解析、分块和嵌入处理后实际生成的向量存储大小为准。
在 2024 年 4 月 17 日之前创建的所有向量存储均可免费使用至 2024 年底，之后将按以下情况处理：
如果在 2024 年 4 月 17 日之后创建的运行中至少使用过一次，则按现行费率计费（目前为每天每 GB 0.10 美元）。
如果在 2024 年 4 月 17 日至 2024 年 12 月 31 日期间从未在任何运行中使用过，则会被删除。这样可以避免你为定价变更公布前创建但从未使用过的向量存储付费。
我可以创建的 assistants 数量有限制吗？
组织可创建的 assistants 数量没有限制。
API 支持流式输出吗？
支持，Assistants API 提供流式输出。
Assistants API 支持 JSON 模式吗？
支持。你可以通过 Assistants 或 Run 对象上的 response_format 参数，在 Assistants API 中启用 JSON 模式。
Assistants API 也会管理第三方函数调用请求吗？
不会。函数调用让模型能够选择工具，并按工具要求的格式生成请求，但对第三方工具调用的实际执行不由 OpenAI 管理。
我发送给 OpenAI 的数据会如何处理？
与我们平台的其他服务一样，传入 OpenAI API 的数据和文件绝不会用于训练我们的模型，你也可以随时按需删除自己的数据。上传到 Assistants API 的数据将无限期保存，直到用户手动删除。
可以通过 Assistants API 使用 DALL-E 吗？
目前尚不支持 DALL-E。
Assistants API 有 UI 吗？
你可以查看 Assistants API 的 Playground。请确保你位于左侧边栏的 Assistants 视图中，并使用与你希望开启的工具兼容的模型。
Assistants API 中的助手指令有多少字符的限制？
助手指令字段的最大长度为 256,000 个字符。
我收到类似这样的错误提示：“服务器在处理你的请求时发生错误。对此我们深表歉意！你可以重试请求；如果错误仍然存在，请通过帮助中心 help.openai.com 联系我们。”我该怎么办？
出现此错误可能意味着你的提示词设置不正确。如果多次重试请求仍然失败，可以尝试以下方法：
调整提示词的结构，确保将所有类似函数的命令作为函数处理
将提示词中的所有命令作为函数添加到 tools 中
为什么我的文件搜索工具效果不佳？
使用文件搜索工具时，我们建议将 max_prompt_tokens 设置为不低于 20,000。对于较长的对话或需要多次使用文件搜索的情况，可以考虑将此上限提高到 50,000；更理想的做法是完全取消 max_prompt_tokens 限制，以获得最佳结果。
如何提供反馈？
欢迎通过我们的开发者论坛、帮助中心 help.openai.com 或 Twitter 账号 @OpenAIDevs 提供反馈。