截至 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 託管的工具，例如程式碼解譯器和檔案搜尋。此 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。
甚麼是助理？
助理是為特定用途而建立的 AI，使用 OpenAI 的模型，能夠存取檔案、維持持續保存的對話串，以及調用工具。
甚麼是對話串？
對話串是助理與使用者之間的一個對話工作階段。對話串會儲存訊息記錄，並在對話過長、超出模型的上下文長度時截斷記錄，從而簡化應用程式開發。
甚麼是檔案搜尋工具？
file_search 工具內置多項檢索最佳做法，無需額外設定，即可協助你從檔案中擷取合適的資料，提升模型的回應質素。
file_search 工具預設使用以下設定：
區塊大小：800 個 token
區塊重疊量：400 個 token
嵌入模型：text-embedding-3-large，使用 256 維
加入上下文的區塊數目上限：20
上傳檔案有哪些限制？
上傳檔案的限制如下：
每個檔案最多 512 MB
每個檔案最多 500 萬個 token
每個向量儲存庫最多 10,000 個檔案
每個助理最多 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 美元（首 1 GB 儲存空間免費）。向量儲存庫的大小，以檔案經過解析、分塊及嵌入處理後實際佔用的空間計算。
凡於 2024 年 4 月 17 日之前建立的向量儲存庫，均可免費使用至 2024 年底，之後將按以下方式處理：
如果曾在 2024 年 4 月 17 日之後建立的 Run 中使用至少一次，便會按現行費率收費（目前為每 GB 每日 0.10 美元）。
如果在 2024 年 4 月 17 日至 2024 年 12 月 31 日期間從未在任何 Run 中使用，則會被刪除。這是為了避免你因在此次價格變更公佈前建立、卻從未使用的向量儲存庫而被收費。
我可以建立的 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 中助理指令的字元數目上限是多少？
助理指令欄位的長度上限為 256,000 個字元。
我收到錯誤訊息，例如：「伺服器處理你的請求時發生錯誤。對此我們深感抱歉！你可以重試請求；如果錯誤持續發生，請透過說明中心 help.openai.com 聯絡我們。」我應該怎麼辦？
如果你收到此錯誤訊息，可能表示你的提示詞設定不正確。如果多次重試請求仍然失敗，可以嘗試以下方法：
重新調整提示詞的結構，確保將任何類似函數的命令作為函數處理
將提示詞中的任何命令以函數形式加入 tools
為甚麼我的檔案搜尋工具效果不佳？
使用檔案搜尋工具時，我們建議將 max_prompt_tokens 設為不低於 20,000。如果對話較長，或需要與檔案搜尋進行多次互動，可考慮將此上限提高至 50,000；最理想的做法是完全移除 max_prompt_tokens 限制，以獲得最佳結果。
我可以如何提供意見？
我們很樂意聽取你的意見。你可以透過開發者論壇、說明中心 help.openai.com，或 Twitter 上的 @OpenAIDevs 提供意見。