截至 2025 年 3 月 11 日，我們已發布新 Agents 平台的建構模組。如需詳細資訊，請參閱我們的 API 文件：Responses 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 日起，使用者已無法再存取 Assistants API Beta 版的 v1 版本。目前僅支援 v2。請參閱這份遷移指南，將您的 API 呼叫從 v1 轉換為 v2。
我要如何存取它？
任何擁有 OpenAI API 帳戶的人都可使用 Assistants API，但它已被棄用，並將於 2026 年 8 月移除。新專案請改用 Responses API。如果你已經使用 Assistants API，請規劃遷移至 Responses API。在 API 仍可用期間，你仍可在 Assistants Playground 中存取現有助理。
什麼是助理？
助理是為特定用途打造的 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，則會遭到刪除。這是為了避免你因為在此次定價變更公布前建立、卻從未使用的向量儲存庫而被收費。
我可以建立的助理數量是否有限制？
組織可建立的助理數量沒有限制。
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 檢視，並使用與你想啟用的 Tools 相容的模型。
Assistants API 的助理指令有多少字元的限制？
助理指令欄位的長度上限為 256,000 個字元。
我收到這類錯誤訊息：「伺服器處理你的請求時發生錯誤。很抱歉！你可以重試請求；如果錯誤持續發生，請透過說明中心 help.openai.com 聯絡我們。」我該怎麼辦？
如果你收到這個錯誤訊息，可能代表提示詞設定不正確。如果多次重試請求仍然失敗，可以嘗試以下做法：
調整提示詞的結構，確保將任何類似函式的指令作為函式處理
將提示詞中的所有指令以函式形式加入 tools
為什麼我的檔案搜尋工具效果不佳？
使用檔案搜尋工具時，建議將 max_prompt_tokens 設為至少 20,000。若對話較長，或需要多次使用檔案搜尋，請考慮將此上限提高至 50,000；更理想的做法是完全移除 max_prompt_tokens 限制，以獲得最佳品質的結果。
如何提供意見回饋？
歡迎透過我們的開發者論壇、說明中心 help.openai.com，或 Twitter 上的 @OpenAIDevs 分享你的意見。