For the complete documentation index, see llms.txt. Markdown versions of documentation pages are available by appending .md to the page URL.
主要導覽

提示詞

瞭解如何建立提示詞。

提供提示詞 ,就是向模型提供輸入的過程。輸出品質通常取決於你能否有效地透過提示詞引導模型。

概覽

撰寫提示詞既是藝術,也是科學。OpenAI 提供了一些策略,並在 API 設計上做了相應安排,協助你撰寫有效的提示詞,讓模型持續產生良好的結果。我們鼓勵你多加嘗試。

提示詞工具與技巧

  • 提示詞快取:重複使用固定的提示詞前綴,在快取命中時降低延遲與輸入 Token 費用
  • 提示工程:瞭解撰寫提示詞的策略、技巧與工具

改善提示詞

  • 將整體語氣或角色指引放在系統訊息中;將特定任務的細節與範例放在使用者訊息中。
  • 將少樣本範例整理成精簡的 YAML 風格區塊或項目清單,方便團隊快速閱讀與更新。
  • 依照專案結構組織資料夾,並使用清楚的名稱,讓團隊成員能快速找到提示詞。
  • 每次發布時都執行提示詞測試與評估案例;及早發現問題,比在正式環境中修正的成本更低。

應用程式中的提示詞

將提示詞視為應用程式程式碼。將提示詞內容存放在具名模組中,透過具型別的函式引數建立動態區段,並在同一個 Pull Request 中一併審查提示詞變更及其支援的產品行為變更。

OpenAI 正逐步棄用 API 中可重複使用的提示詞物件。自 2026 年 6 月 3 日起, 將逐步降低提示詞建立功能的顯著程度,而 v1/prompts 預計於 2026 年 11 月 30 日停止服務。請參閱已棄用項目 頁面,瞭解目前的 時程。

進行新的開發工作時,請勿建立可重複使用的提示詞物件。請改採以下做法:

  • 將每個正式環境使用的提示詞存放在由程式碼管理並納入版本控制的輔助模組中,例如 prompts/supportReply.ts
  • 以具型別的函式參數或經過驗證的輸入物件取代提示詞變數。
  • 透過 inputinstructions,將產生的訊息直接傳遞給 Responses API
  • 針對提示詞變更,使用測試、具代表性的測試資料及評估檢查加以驗證,並將這些檢查納入部署流程中執行。
  • 使用 git 歷程記錄、PR 審查、發布標籤及功能旗標,來審查、發布、比較及回復提示詞變更。

如果你已在 API 請求中使用提示詞 ID 或提示詞版本,請依照遷移指南,將這些提示詞移至程式碼中。

後續步驟

當你對自己的提示詞有把握後,可以參閱以下指南與資源。

文字生成

瞭解如何透過提示詞引導模型生成文字。

設計更好的提示詞

瞭解 OpenAI 的提示工程工具與技巧。