截至 2025 年 3 月 11 日，我們已發布全新 Agents 平台的構建元件。詳情請參閱我們的 API 文件：Responses API、包括網頁搜尋、File Search 和電腦使用在內的工具，以及我們的 Agents SDK 與追蹤。根據你對 Assistants API beta 的意見，我們已將關鍵改進納入 Responses API。在達到完整功能對等後，我們將於今年稍後公布 Assistants API 棄用計劃，目標是在 2026 年上半年終止服務。
Assistants API 是甚麼？
Assistants API 讓開發者可輕鬆在其應用程式中構建強大的 AI 助理。此 API 免除了管理對話記錄的需要，並加入存取 OpenAI 託管工具的功能，例如程式碼解譯器和 File Search。此 API 亦支援改良的第三方工具函數調用。
我仍可使用 Assistants API v1 beta 嗎？
不可以。截至 2024 年 12 月 18 日，用戶已無法再存取 Assistant API beta 的 v1 版本。我們目前只支援 v2。請查看這份遷移指南，將你的 API 調用由 v1 轉換至 v2
我要如何存取它？
任何擁有 OpenAI API 帳戶的人都可使用 Assistants API，但該 API 已棄用，並將於 2026 年 8 月移除。新專案請改用 Responses API。如果你已在使用 Assistants API，請規劃遷移至 Responses API。在 API 仍可使用期間，你仍可在 Assistants Playground 存取現有 assistants。
Assistant 是甚麼？
assistant 代表一個為特定目的而建立的 AI，它使用 OpenAI 的模型，並可存取檔案、維持持久對話串，以及調用工具。
Thread 是甚麼？
thread 是 assistant 與用戶之間的對話 session。Threads 會儲存訊息記錄，並在對話長度超出模型的上下文長度時將其截短，從而簡化應用程式開發。
File Search 工具是甚麼？
`file_search` 工具內建多項擷取最佳實踐，協助你從檔案中抽取合適資料，以增強模型的回應。如需更多資訊，請閱讀我們的開發者文件。
預設情況下，file_search 工具使用以下設定：
分段大小：800 tokens
分段重疊：400 tokens
嵌入模型：`text-embedding-3-large`，256 維度
加入上下文的分段數量上限：20
檔案上載有甚麼限制？
上載檔案的限制如下：
每個檔案 512 MB
每個檔案 5M tokens
每個向量儲存區 10k 個檔案
每個 assistant 1 個向量儲存區
每個對話串 1 個向量儲存區
機構中每個專案的總儲存空間上限為 100 GB。
File Search 工具有甚麼限制？
我們有一些已知限制，並正努力在未來數月內加入支援：
目前無法修改分段、嵌入或擷取設定。
我們不支援解析文件中的圖像。
我們不支援對結構化檔案格式（例如 .csv 或 .jsonl 檔案）進行擷取。請參閱支援的檔案類型。
Assistants API 的速率限制是甚麼？
Assistants API 的速率限制並不綁定於使用量等級和模型。相反，預設限制按要求類型而定，但有幾項例外：
GET：1000 RPM
POST：300 RPM
DELETE：每分鐘 300 個要求
API 中的程式碼解譯器如何計價？
程式碼解譯器的價格為每個 session $0.03。如果你的助理在兩個不同的對話串中同時調用程式碼解譯器，這會建立兩個程式碼解譯器 session（2 * $0.03）。每個 session 預設會保持作用中一小時，這表示如果你的用戶在同一對話串中持續向程式碼解譯器提供指示，最長一小時內你只需支付一次此費用。
API 中的 File Search 如何計價？
File Search 的價格為向量儲存區儲存空間每日 $0.10/GB（首 GB 儲存空間免費）。向量儲存區的大小，取決於檔案經解析、分段及嵌入後所得向量儲存區的大小。
任何於 2024 年 4 月 17 日前建立的向量儲存區，在 2024 年底前均可免費使用；之後它們將會：
如它們在 2024 年 4 月 17 日後建立的 Run 中至少使用過一次，便會按現行費率（目前為 $0.10/GB/日）收費。
如它們在 2024 年 4 月 17 日至 2024 年 12 月 31 日期間未曾在任何 Run 中使用，便會被刪除——這是為了避免你因在公布此定價變更前建立但從未使用的向量儲存區而被收費。
我可以建立的 assistants 數量有限制嗎？
機構可建立的 assistants 數量沒有上限。
API 是否提供串流功能？
是，Assistants API 提供串流功能。
Assistants API 是否提供 JSON 模式？
是，Assistants API 可透過 Assistants 或 Run 物件上的 response_format 參數使用 JSON 模式。
Assistants API 也會管理第三方函數調用的要求嗎？
不會。雖然函數調用可讓模型選擇工具並為其格式化要求，但 OpenAI 不會管理對第三方工具的調用執行。
我傳送給 OpenAI 的資料會如何處理？
與我們平台的其他部分一樣，傳遞至 OpenAI API 的資料和檔案絕不會用於訓練我們的模型，而且你可在需要時隨時刪除你的資料。上載至 Assistants API 的資料會無限期儲存，直至用戶手動刪除為止。
DALL-E 是否可透過 Assistants API 使用？
目前 DALL-E 尚不可使用。
Assistants API 中 assistant 指示的字元限制是多少？
assistant 指示欄位的長度上限為 256,000 個字元。
我收到錯誤，例如「伺服器在處理你的要求時發生錯誤。對此我們深感抱歉！你可以重試要求；如果錯誤持續，請透過我們的說明中心 help.openai.com 聯絡我們。」我應該怎樣做？
如果你收到此錯誤，可能表示你的提示詞設定不正確。如果你持續重試要求仍然失敗，可以嘗試以下做法：
請務必重新構建你的提示詞，將任何類似函數的命令視為函數
將提示詞中的任何命令作為函數加入
tools
為甚麼我的 File Search 工具運作不佳？
使用 File Search 工具時，我們建議將 max_prompt_tokens 設為不少於 20,000。對於較長的對話或與 File Search 的多次互動，請考慮將此限制提高至 50,000；理想情況下，可完全移除 max_prompt_tokens 限制，以取得最高品質的結果。請在此處閱讀更多。
我可以如何提供意見？
我們很樂意在開發者論壇、透過說明中心 help.openai.com，或在 Twitter @OpenAIDevs 收到你的意見。