簡介
GPT-5.5 提升了模型在正式環境中處理複雜工作流程的基本水準。它特別適合程式開發、高度依賴工具的智慧體、依據可靠資料作答的助理、長上下文檢索,以及將產品規格轉為計畫的工作流程。對於直接服務客戶、同時重視任務執行品質與回覆表達的工作流程,它也很合適。
若要充分發揮 GPT-5.5 的效能,請將它視為需要重新調校的新模型系列,避免直接用它替換 gpt-5.2 或 gpt-5.4。遷移時請重新建立基準,避免照搬舊版提示詞組合中的每一條指示。先找出足以維持產品既定行為的最精簡提示詞,再使用具代表性的範例調校推理強度、回覆詳略程度、工具說明與輸出格式。
GPT-5.5 支援 GPT-5.4 原有的所有 API 功能,包括提示詞快取、託管工具、工具搜尋、壓縮,以及手動重送助理項目時對 phase 的處理。
如需有效的提示詞範例,請參閱提示詞最佳實務。
新功能與改進
- 推理更有效率: 即使採用相同的推理強度,GPT-5.5 也能用比先前模型更少的推理 Token 得到良好結果。對於複雜、高度依賴工具或包含多個步驟的工作流程,這項改進特別有用,因為每個步驟省下的 Token 都會累積。
- 以成果為先的提示詞能提升任務執行能力: GPT-5.5 更擅長依據明確目標行動、遵守限制,並將產品意圖轉化為具體的下一步。請說明預期成果、成功標準、允許的副作用、採信證據的規則,以及輸出的形式。除非任務必須採取特定做法,否則請避免逐步指定流程。
- 工具運用能力更強,也更精準: GPT-5.5 特別適合工具眾多的環境、多步驟服務流程,以及長時間執行的智慧體任務。它通常能更精準地選擇工具並使用引數。
- 語氣通常更流暢,也可能更直接: GPT-5.5 通常只需較少的提示詞引導,就能給出更親切、易讀的回答。
行為變更
-
推理強度現在預設為
medium: GPT-5.5 的預設推理強度為medium。建議先使用medium,以兼顧品質、可靠性、延遲與成本。對延遲敏感的工作流程,如果工具使用、規劃、搜尋或多步驟決策仍然重要,請先評估low,再考慮none。只有在任務對延遲要求極高,且不需要推理或串接多次工具呼叫時,才使用none,例如簡短的語音互動、快速資訊檢索與分類。只有在評估顯示品質有可衡量的提升,足以抵銷額外延遲與成本時,才提高到high或xhigh。如需進一步瞭解建議設定,請參閱推理模型文件。提高推理強度未必能改善結果。如果任務中的指示互相衝突、停止標準不明確,或工具使用沒有明確範圍,提高強度可能導致過度推敲、不必要的搜尋,甚至降低輸出品質。只有在評估顯示品質有可衡量的提升時,才提高推理強度。
-
圖像輸入預設保留更多視覺細節: GPT-5.5 調整了圖像輸入的預設處理方式,以保留更多視覺細節,並提升操作電腦時的表現。未設定
image_detail或將其設為auto時,模型現在會採用original的處理方式。只要圖像不超過 10,240,000 像素,且任一邊長不超過 6,000 像素,就會保留原始尺寸。若要使用high,請直接指定該值。此設定會保留圖像的原始尺寸,上限為 2,500,000 像素,且任一邊長不得超過 2,048 像素。low現在更注重上下文的使用效率。若任一邊長超過 512 像素,縮小圖像的幅度會比先前模型更大。請參閱圖像與視覺文件。 -
更能遵循指示: GPT-5.5 會按字面完整解讀提示詞,因此當產品有特定需求時,可以提供具體且詳盡的指示。請定義成功標準與停止規則,尤其是長時間執行、高度依賴工具或需要蒐集證據的工作流程。請參閱撰寫以成果為先的提示詞與掌握適當的具體程度。
-
預設風格更精簡、直接: GPT-5.5 預設傾向以簡潔、直接的方式完成任務。這適用於許多正式環境工作流程,但對於直接服務客戶或以對話為主的產品,可能需要明確說明助理的個性、語氣應有多親切、何時解釋理由,以及如何編排回覆。請依需求設定
text.verbosity。預設值為medium,若希望回覆精簡,通常可以先試low。請參閱提示詞最佳實務。 -
程式開發工作流程需要更完善的協調: GPT-5.5 更適合需要規劃、使用工具、查找程式碼、驗證結果與分步執行的複雜開發任務。對於程式開發智慧體,請明確說明應重用哪些既有成果、如何將工作委派給子代理程式、測試要求與驗收標準,以及何時應繼續執行、何時應尋求協助。
遷移快速入門
使用 Codex 自動遷移
Codex 可以透過 OpenAI Docs 技能套用本指南建議的變更。
$openai-docs 請將這個專案遷移至 gpt-5.5
若要在其他程式開發智慧體中使用此技能,請從 OpenAI 技能程式碼庫下載。
API 與模型參數
- 將模型 Slug 更新為
gpt-5.5。 - 凡是涉及推理、工具呼叫或多輪互動的使用情境,請使用 Responses API。
- 調校
reasoning.effort。需要有效率的推理時,請使用low。若要兼顧延遲與效能,請使用medium。對於需要深入推理、對延遲較不敏感的複雜智慧體任務,請使用high。對於難度最高的非同步智慧體任務,或測試模型智慧極限的評估,請使用xhigh。請參閱推理模型文件。 - 若希望回覆更精簡,請將
text.verbosity設為low。與 GPT-5.4 相比,在 GPT-5.5 上使用low時,回覆長度的縮減幅度更大。 - 對於高度依賴工具或長時間執行的工作流程,請確認應用程式能正確處理
phase、開場說明,以及助理項目的重送。 - 使用基準測試比較 GPT-5.5 與其他模型的準確度、Token 用量及端對端延遲。
撰寫提示詞
- 說明預期成果與成功標準。
- 減少或移除詳細的逐步流程指示。除非產品要求特定做法,否則請讓 GPT-5.5 自行選擇。
- 盡可能將輸出結構描述的定義移出提示詞,改用結構化輸出。
- 調整提示詞以充分利用快取:將固定內容放在開頭,動態內容放在結尾。
- 移除提示詞中的當天日期。模型已經知道目前的 UTC 日期。
- 參照提示詞最佳實務檢查並改善提示詞。
使用推理模型
以下建議適用於 GPT-5 系列模型。每當團隊將工作負載移至推理模型時,都值得重新檢視這些建議。GPT-5.5 延續了許多先前模型率先推出的功能。如果您正從較早的 GPT-5 模型、GPT-4.1 或 o3 等推理模型遷移,仍值得再熟悉一次這些功能。
團隊容易忽略這些功能,因為其中一部分需要透過 API 設定與工作流程協調來運用,單靠提示詞無法涵蓋。搭配使用 Responses API、推理設定、回覆詳略設定、結構化輸出、提示詞快取、工具設計、託管工具與狀態管理,有助於充分發揮推理模型的能力,提高可靠性,並兼顧延遲與成本。
- Responses API: GPT-5.5 搭配 Responses API 的效果最佳。請使用
previous_response_id管理多輪互動的狀態。對於無狀態或零資料保留的流程,請在每一輪將先前傳回的相關輸出項目送回 API。詳情請參閱傳遞上一則回覆的上下文。 - 推理強度: 使用
reasoning.effort選擇low、medium、high或xhigh。預設值為medium,但許多工作負載使用low就有良好表現。只有在低延遲比推理能力更重要時,才使用none。詳細建議請參閱推理模型。 - 回覆詳略程度: 使用
text.verbosity控制輸出長度。請分開考量最終回答的長度與推理品質,並視需要指定字數上限、章節數、表格寬度,或要求只輸出 JSON。 - 結構化輸出: 避免在提示詞中描述預期的輸出結構描述。請使用結構化輸出自動驗證輸出並提高準確度。
- 提示詞快取: 符合條件的長提示詞會自動使用提示詞快取,有助於降低延遲與輸入 Token 成本。若要提高快取命中率,請將固定內容放在請求開頭,將隨使用者而變動的上下文放在接近結尾的位置。追蹤
usage.prompt_tokens_details.cached_tokens即可衡量重用情況。對於具有相同可重用前綴的請求,請使用固定的prompt_cache_key。這個鍵可協助將相關請求導向同一個快取,對提高 GPT-5.5 的快取命中率很重要。若一組請求的流量很大,請參照將流量分散至更多快取鍵的指引。 - 工具呼叫: GPT-5.5 支援與 GPT-5.4 相同的工具呼叫模式,包括函式工具,以及高度依賴工具的智慧體工作流程。大部分工具專屬指引應放在工具本身的說明中,包括工具的用途、使用時機、必要輸入、副作用、是否能安全重試,以及常見的錯誤情況。只有當工具相關資訊適用於多個工具,或會實質改變智慧體的運作規則時,才將其加入系統指示。
- 託管工具與工具搜尋: 工作流程適用時,請優先採用 OpenAI 託管工具,例如網頁搜尋、檔案搜尋、程式碼解譯器、圖像生成及電腦操作。託管工具能減少自行協調工具的工作量,並讓常見的工具使用模式與 Responses API 和 Agents SDK 保持一致。若需要呼叫自己的系統、確保工具產生特定業務領域要求的副作用,或提供內部業務流程供智慧體使用,請採用自訂函式工具。若工具目錄很大,可以考慮使用工具搜尋延後載入工具定義,只載入與任務相關的工具。
- 工具呼叫前的開場說明: 開場說明可以改善對話體驗,讓使用者在模型產生最終回覆前,先看到有用的進度訊息。這也讓使用者更容易跟上工具使用過程:模型可以先說明即將檢查的事項或採取的行動,等工具傳回結果後,再從同一個助理狀態接續執行。
- 處理
phase: 如果應用程式在每一輪送回輸出項目,自行管理 Responses 的狀態,而未使用previous_response_id,請保留助理輸出項目中傳回的phase參數,並原樣送回。使用推理強度設定、開場說明或多次工具呼叫時,這一點尤其重要。請參閱 Phase 參數。 - 壓縮: 對於長時間執行的智慧體,請依任務需要使用對話與狀態壓縮。請保留已完成的動作、目前採用的假設、ID、工具執行結果、尚未排除的障礙,以及下一個具體目標。
- Agents SDK: 建立新的智慧體系統時,請採用最新版 Agents SDK 的工具協調、追蹤、任務交接與狀態管理模式,避免從頭打造協調機制。
- 當天日期: GPT-5.5 知道目前的 UTC 日期,因此無須在系統指示中加入當天日期。只有在應用程式需要業務指定的時區、政策生效日期、使用者所在地的日期,或其他非 UTC 的時間基準時,才明確提供相關日期或時區資訊。
提示詞最佳實務
當提示詞明確定義成果,同時讓模型自行選擇有效率的解法時,GPT-5.5 的表現最佳。與先前模型相比,通常可以使用更短、更著重成果的提示詞。請描述理想結果、重要限制、可用的證據,以及最終回答應包含的內容。
避免照搬舊版提示詞組合中的每一條指示。先前模型需要更多引導才能按照預期執行,因此舊提示詞往往對流程規定得過於詳細。對 GPT-5.5 而言,這些規定可能造成干擾、限制模型探索解法的範圍,或使回答過於機械化。
以下寫法可作為起點。請根據產品介面、工具、評估方式與使用者體驗目標加以調整。
個性與行為
GPT-5.5 的預設風格簡潔、直接,以完成任務為重。這適合正式環境中的系統:回覆能聚焦於任務,行為更容易引導,模型也能避免多餘的寒暄。
對於直接服務客戶的助理、客服流程、教練式互動及其他對話產品,請同時定義個性與協作風格。
- 個性決定助理如何表達,包括語氣、親切度、直接程度、正式程度、幽默感、同理心,以及措辭的細緻程度。
- 協作風格決定助理如何工作,包括何時提問、何時採用假設、應有多主動、提供多少上下文、何時檢查成果,以及如何處理不確定性或風險。
兩類指示都應簡短。個性指示應塑造使用者體驗,協作指示則應引導任務執行方式。兩者都不能取代明確的目標、成功標準、工具使用規則或停止條件。
以下個性指示適用於沉穩、專注於任務的助理:
# 個性
你是能幹的協作夥伴,待人親切、做事沉穩、說話直接。相信使用者具備處理問題的能力,也出於善意。回應時保持耐心與尊重,提供實際的協助。
只要請求已經明確到可以著手處理,就優先推進工作。運用已有的上下文,做出合理假設並繼續執行。只有在缺少的資訊會實質改變答案或帶來明顯風險時,才請使用者澄清,而且只問需要釐清的事。
回答要簡潔,語氣仍要親切。提供足以讓使用者理解並信任答案的背景後,就可以收尾。如果舉例、比較或簡單的類比能讓重點更容易理解,就加以運用。糾正使用者或表達不同意見時,坦率說明,並提出有建設性的看法。有人指出錯誤時,直接承認,專心修正。
在專業範圍內配合使用者的語氣。預設避免使用表情符號或粗話,除非使用者明確要求這種風格,或已清楚表明這種風格適合目前的對話。
以下個性指示適用於表達生動、重視協作的助理:
# 個性
讓對話生動自然。展現敏銳的理解力與好奇心,適時帶點俏皮,也要留意使用者的思路。問題還不明確時,用切中要點的問題釐清需求。掌握足夠的上下文後,就果斷做出判斷。
態度親切,樂於協作,措辭得體。讓對話輕鬆、有活力,避免為了聊天而多話。提出自己的觀點,不要只附和使用者,同時要顧及對方的目標與限制。
任務需要綜合資訊或提供建議時,請仔細思考,讓看法有據可循。掌握足夠的上下文後,提出明確建議,解釋重要取捨,並坦白指出哪些地方仍不確定,避免含糊其詞。
若產品需要更生動的表達,可以明確要求助理展現親切感、好奇心、幽默感或自己的觀點,但指示仍應簡短。請運用個性塑造體驗,避免試圖用個性設定彌補模糊的目標或缺漏的任務指示。
使用開場說明,縮短使用者看到第一個 Token 的等待時間
在串流應用程式中,使用者會注意到從送出請求到看到第一段回覆要等多久。GPT-5.5 在輸出可見文字前,可能會先花時間推理、規劃或準備工具呼叫。
對於耗時較長或高度依賴工具的任務,請在提示詞中要求模型先給一段簡短的開場說明,讓使用者知道模型已收到請求,以及接下來的第一步。這能讓使用者更快感受到回應,無須改變任務本身。
如果任務可能需要多個步驟、需要呼叫工具,或涉及長時間執行的智慧體工作流程,可以採用這種寫法。
處理多步驟任務時,在呼叫任何工具前,先向使用者發送簡短的進度訊息,確認已收到請求並說明第一步要做什麼。用一到兩句話即可。
對於能區分不同訊息階段的程式開發智慧體,可以更明確地指定:
只要任務需要呼叫工具,就一律先向使用者發送進度訊息,再於 analysis 頻道中寫入任何內容。這則訊息應確認已收到請求,並說明第一步要做什麼。
以成果為先的提示詞與停止條件
提示詞先定義目標成果、成功標準、限制與可用的上下文,再讓模型自行選擇做法,最能發揮 GPT-5.5 的能力。
許多任務只需說明要達成什麼,無須指定每個步驟。這樣模型就能依任務選擇合適的搜尋方式、工具或推理策略。
建議採用以下寫法:
從頭到尾解決客戶的問題。
成功標準:
- 根據現有政策與帳戶資料,判定客戶是否符合資格。
- 在回覆客戶前,完成處理此問題所需且獲准執行的所有動作。
- 最終回答包含 completed_actions、customer_message 和 blockers。
- 若證據不足,只請客戶提供足以補足證據的最小必要欄位。
避免不必要的絕對規則。 舊版提示詞常使用 ALWAYS、NEVER、must 與 only 等嚴格措辭來控制模型行為。請將這類措辭留給必須一律遵守的要求,例如安全規則、必填輸出欄位,或絕不可執行的動作。需要視情況判斷時,例如決定何時搜尋、詢問細節、使用工具或繼續迭代,請優先說明判斷依據。
除非每一步都不可或缺,否則請避免以下寫法:
先檢查 A,再檢查 B,接著逐一比對每個欄位,然後仔細考慮所有可能的例外情況,
再決定要呼叫哪個工具,接著呼叫該工具,
最後向使用者解釋整個過程。
加入明確的停止條件:
用盡可能少的工具呼叫輪次解決使用者的問題。確保答案正確更為重要,也不可為了減少輪次而略過可取得的替代證據、必要的計算,或事實性陳述所需的引用標記。
每次取得結果後,都問自己:「我現在能否根據有用的證據回答使用者的核心問題,並為事實性陳述標明出處?」如果可以,就作答。
定義證據不足時的處理方式:
只使用足以正確作答的最少證據,確切標明出處,然後停止。
格式
您可以精準控制 GPT-5.5 的輸出格式與結構。當特定格式能幫助讀者理解內容,或更符合產品需求時,請善用這項能力。
請設定 text.verbosity,並描述預期的輸出形式。只有在較嚴謹的結構有助於理解,或產品介面需要形式穩定的產出時,才要求這類結構。API 的 text.verbosity 預設為 medium。若希望回覆更短、更精簡,請使用 low。
一般對話的簡明格式:
選擇能幫助讀者理解內容的格式。一般對話、說明、報告、文件與技術文章預設使用一般段落。版面要簡潔易讀,避免繁複的結構蓋過內容。
標題、粗體、項目符號和編號清單都要節制使用。若使用者要求採用這些格式、回答需要清楚呈現比較或排名,或資訊寫成段落後難以快速瀏覽,再使用這些格式。其餘情況優先使用自然銜接的短段落。
尊重使用者的格式偏好。若使用者要求回答簡短、簡化排版、不使用項目符號或標題,或採用特定結構,除非有充分理由,否則請照做。
明確說明目標讀者與篇幅要求:
以企業高階主管為讀者,回答篇幅須少於 400 詞。使用短段落,只有在條列能讓讀者更快找到重點時才使用。先說結論,再說明理由,最後指出需要留意的限制。
在編輯、改寫、摘要或撰寫客戶訊息時,請先告訴模型哪些內容必須保留,再請它改善文風。若只想潤飾文字而不增加篇幅,這種寫法很合適。
優先保留使用者要求的交付形式、篇幅、結構與文體。直接改善文字的清晰度、流暢度與正確性,無須特別說明。除非使用者明確要求,否則不要增添新主張或額外章節,也不要加重宣傳語氣。
接地、引用與檢索預算
若回答必須有可靠依據,請在提示詞中說明引用規則。請定義哪些說法需要佐證、什麼樣的證據才算充分,以及缺乏證據時模型應如何回應。找不到證據時,不應直接斷定答案是「否」。如需更多詳細說明與範例,請參閱引用格式指南。
明確設定檢索預算
檢索預算是搜尋的停止規則,用來告訴模型何時已有足夠的證據可以作答。
處理一般問答時,先選用簡短、能區分相關與無關結果的關鍵字,進行一次廣泛搜尋。如果排名靠前的結果已提供足夠的佐證,可供引用並回答核心問題,就依據這些結果作答,不必再次搜尋。
只有在下列任一情況下才再次呼叫檢索工具:
- 排名靠前的結果無法回答核心問題。
- 缺少必要的事實、參數、負責人、日期、ID 或來源。
- 使用者要求涵蓋所有情況、進行比較,或提供完整清單。
- 必須查閱特定文件、網址所指的頁面、電子郵件、會議內容、紀錄或程式碼產物。
- 若不再檢索,回答中就會有重要的事實性陳述缺乏佐證。
不要為了修飾措辭、增加範例或替非必要的細節補上引文而再次搜尋。如果改用較概括的說法就能維持準確,也不要為了支持原本的措辭而再次搜尋。
創意撰稿的界線
對於撰稿任務,請告訴模型哪些說法必須有來源依據,以及哪些部分可以自由發揮。製作投影片、撰寫產品上市文案、客戶摘要、發言提綱或主管簡介,以及安排敘事角度時,這一點尤其重要。
處理創作或內容生成請求時,例如製作投影片、撰寫主管簡介、對外文案、供分享的摘要或發言提綱,或安排敘事角度,請區分有來源佐證的事實與可自由發揮的措辭。
- 具體談及產品、客戶、指標、路線圖、日期、功能或競爭情況時,請以檢索取得或已提供的事實為依據,並標明出處。
- 不要為了提高草稿的說服力,捏造具體名稱、聲稱來自第一方資料的發現、指標、路線圖進度、客戶成果或產品功能。
- 如果幾乎沒有或完全沒有可引用的佐證,請撰寫仍具實用性的通用草稿,使用預留位置或清楚標示假設,避免加入缺乏依據的細節。
前端工程與視覺設計判斷
進行前端開發時,請參閱指示範例,瞭解如何具體引導模型改善介面品質。範例涵蓋產品與使用者的使用情境、與設計系統保持一致、首屏易用性、使用者熟悉的控制項、應支援的介面狀態,以及響應式行為。範例也說明應避免哪些生成式介面常見的預設做法與問題,例如千篇一律的主視覺區塊、層層嵌套的卡片、裝飾性漸層、把設計指示顯示在畫面上,以及版面錯亂。
要求模型檢查自己的成果
如果輸出可以驗證,請讓 GPT-5.5 使用能檢查輸出的工具。
對於程式開發智慧體,請要求它執行具體的驗證指令:
完成變更後,執行目前可用且與變更最相關的驗證:
- 針對行為變更執行相關的單元測試。
- 視情況執行型別檢查或靜態程式碼檢查。
- 對受影響的套件執行建置檢查。
- 若完整驗證的成本太高,執行最基本的冒煙測試。
如果無法執行驗證,請解釋原因,並說明最合適的替代檢查方式。
對於視覺成果,請要求模型在完成算繪後檢查畫面:
定稿前先算繪成果。檢查實際畫面的版面配置、內容是否遭裁切、間距是否合適、是否遺漏內容,以及視覺風格是否一致。持續修正,直到算繪結果符合需求。
對於工程與規劃任務,請讓實作計畫中的各項安排都能追溯至對應需求:
實作計畫應包含:
- 各項需求,以及計畫中的哪個部分會處理該需求。
- 涉及的資源、檔案、API 或系統的具體名稱。
- 適用時,說明狀態轉換或資料流向。
- 驗證指令或檢查方式。
- 發生失敗時系統的行為。
- 隱私與安全方面的考量。
- 尚待釐清且會實質影響實作的問題。
Phase 參數
從 GPT-5.4 開始,長時間執行或高度依賴工具的 Responses 工作流程,可以透過助理項目的 phase 值區分中途進度訊息與最終回答。GPT-5.5 沿用相同做法。
如果使用 previous_response_id,API 會自動保留先前的助理狀態。如果應用程式會手動將助理輸出項目重送至下一個請求,請保留每個項目原有的 phase 值,並原樣送回。當回覆包含開場說明、多次工具呼叫,或在助理發出中途進度訊息後才提供最終回答時,這一點尤其重要。
如果手動重送助理項目:
- 原樣保留助理項目的 `phase` 值。
- 使用 `phase: "commentary"` 標示使用者可見的中途進度訊息。
- 使用 `phase: "final_answer"` 標示已完成的回答。
- 不要在使用者訊息中加入 `phase`。
建議的提示詞結構
撰寫複雜提示詞時,可以從以下結構著手。每一節都應簡短,只有在細節會改變模型行為時才加以補充。
角色:[用 1-2 句話說明模型的職能、工作情境與任務]
# 個性
[語氣、態度與協作風格]
# 目標
[使用者能看到的成果]
# 成功標準
[在給出最終回答前必須滿足的條件]
# 限制
[政策、安全、業務、證據與副作用方面的限制]
# 輸出
[章節、篇幅與語氣]
# 停止規則
[何時重試、改採備用方案、暫不作答、提問或停止]