如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

撰寫提示詞

瞭解如何建立提示詞。

撰寫提示詞就是為模型提供輸入。模型的輸出品質往往取決於提示詞寫得好不好。

概覽

撰寫提示詞既是藝術,也是科學。OpenAI 提供的策略和 API 設計能協助你撰寫有效的提示詞,讓模型穩定產生高品質的結果。我們鼓勵你嘗試不同的寫法。

撰寫提示詞的工具與技巧

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

改進提示詞

  • 在系統訊息中指定整體語氣或角色,並將個別任務的細節和範例放在使用者訊息中。
  • 將少樣本範例整理成簡潔的 YAML 風格區塊或項目清單,方便團隊快速瀏覽和更新。
  • 依照專案結構整理提示詞,並為資料夾取清楚的名稱,讓團隊成員能快速找到提示詞。
  • 每次發布時都要執行提示詞測試和評估案例。及早發現問題,比上線後才修正更省成本。

在應用程式中管理提示詞

將提示詞視為應用程式碼的一部分。把提示詞內容存放在有名稱的模組中,使用明確指定型別的函式引數組合動態內容。若產品行為的變更需要調整提示詞,請在同一個 Pull Request 中一併審查。

OpenAI 正逐步棄用 API 中可重複使用的提示詞物件。自 2026 年 6 月 3 日起,建立提示詞物件將不再是 API 的重點功能,v1/prompts 預定於 2026 年 11 月 30 日停止服務。最新時程請參閱棄用公告。

開發新功能時,請勿建立可重複使用的提示詞物件。請採用以下做法:

  • 將正式環境使用的每個提示詞存放在輔助模組中,例如 prompts/supportReply.ts,並隨程式碼一同進行版本控制。
  • 將提示詞變數改為明確指定型別的函式參數,或經過驗證的輸入物件。
  • 呼叫 Responses API 時,透過 input 和 instructions 直接傳入產生的訊息。
  • 使用具代表性的測試資料,並在部署流程中執行測試與評估,以驗證提示詞變更。
  • 使用 Git 歷程記錄、PR 審查、發布標籤和功能旗標來審查、發布、比較及回復提示詞變更。

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

後續步驟

當你對自己撰寫的提示詞有信心後,可以參考以下指南和資源。

文字生成

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

設計更有效的提示詞

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