截至 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 託管工具的存取權，例如程式碼解譯器和 File Search。此 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 中存取現有助理。
什麼是 Assistant？
助理代表一個專為特定用途打造的 AI，使用 OpenAI 的模型，並可存取檔案、維持持續性對話串，以及呼叫工具。
什麼是 Thread？
對話串是助理與使用者之間的對話工作階段。對話串會儲存訊息歷史記錄，並在對話長度超過模型的脈絡長度時進行截斷，藉此簡化應用程式開發。
File Search 工具是什麼？
`file_search` 工具內建多項擷取最佳實務，可協助你從檔案中擷取正確資料，以增強模型的回應。如需更多資訊，請閱讀我們的開發者文件。
依預設，file_search 工具會使用以下設定：
分塊大小：800 Token
分塊重疊：400 Token
嵌入模型：256 維度的 `text-embedding-3-large`
新增至脈絡的分塊數上限：20
檔案上傳有哪些限制？
上傳檔案的限制如下：
每個檔案 512 MB
每個檔案 5M Token
每個向量儲存區 1 萬個檔案
每個助理 1 個向量儲存區
每個對話串 1 個向量儲存區
組織中每個專案的整體儲存空間限制為 100 GB。
File Search 工具有哪些限制？
我們已知有幾項限制，並正努力在未來幾個月內新增支援：
目前無法修改分塊、嵌入或擷取設定。
我們不支援剖析文件中的圖片。
我們不支援對結構化檔案格式（例如 .csv 或 .jsonl 檔案）進行擷取。查看支援的檔案類型。
Assistants API 的速率限制為何？
Assistants API 的速率限制與使用層級和模型無關。相反地，預設限制會依要求類型而定，但有幾個例外：
GET：1000 RPM
POST：300 RPM
DELETE：每分鐘 300 個要求
API 中的程式碼解譯器如何計價？
程式碼解譯器的價格為每個工作階段 $0.03。如果你的助理在兩個不同對話串中同時呼叫程式碼解譯器，這會建立兩個程式碼解譯器工作階段（2 * $0.03）。每個工作階段預設會啟用一小時，這表示如果使用者在同一個對話串中持續向程式碼解譯器提供指示，最多一小時內你只需支付一次這筆費用。
API 中的 File Search 如何計價？
File Search 的價格為向量儲存區儲存空間每日每 GB $0.10（第一個 GB 儲存空間免費）。向量儲存區的大小是依據檔案經剖析、分塊和嵌入後所產生的向量儲存區大小而定。
任何在 2024 年 4 月 17 日之前建立的向量儲存區都將免費至 2024 年底，之後它們將會：
如果它們至少曾在 2024 年 4 月 17 日之後建立的 Run 中使用過一次，則按現行費率計費（目前為 $0.10/GB/日）。
如果它們在 2024 年 4 月 17 日至 2024 年 12 月 31 日期間未曾在任何 Run 中使用，則會遭到刪除——這是為了避免你因為在宣布此價格變更之前建立但從未使用的向量儲存區而被收費。
我可以建立的助理數量是否有限制？
組織可建立的助理數量沒有限制。
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 是否有 UI？
你可以查看 Assistants API 的 Playground。請確認你位於左側邊欄的 Assistants 檢視，並使用與你想啟用的 Tools 相容的模型。
Assistants API 中助理指示的字元限制是多少？
助理指示欄位的最大長度為 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 上聽取你的意見回饋。