觀點 · 資訊分享

OpenAI Agents SDK 0.18.2：Python 版跟上 GPT-5.6，新增提示快取設定與託管式多代理測試版

OpenAI Agents SDK（Python）在 7 月 11 日釋出 0.18.2，加入 GPT-5.6 的推理與提示快取控制，並實驗性支援 Responses API 的託管式多代理。前一版 0.18.1 則替 Sol、Terra、Luna 加了預設設定。

一句話看懂：OpenAI 的 Python 版 Agents SDK 在 7 月 11 日釋出 0.18.2，讓你在程式裡直接設定 GPT-5.6 的提示快取與推理模式，還加入託管式多代理的測試版支援。

Agents SDK 0.18.2 跟上 GPT-5.6資訊圖卡：SDK 內能直接設定提示快取與推理模式，多代理有測試版

先用白話講：Agents SDK 是什麼？

想像你要開一間小公司，不想每個員工的工作流程都從頭設計。Agents SDK 就像一套「員工訓練包」：它幫你定義一個 AI 代理要有什麼指令、能用哪些工具、遇到特定情況要把工作交給哪位同事，剩下的流程由套件處理。

SDK 是 Software Development Kit（軟體開發套件）的縮寫，這次的更新是針對 Python 版。因為 OpenAI 在 7 月 9 日剛推出 GPT-5.6，這套件需要跟著更新，才能用上新模型的新功能。

這次要看兩個連續的版本：

0.18.1（7 月 9 日，UTC）

0.18.2（7 月 11 日，UTC）

支援 GPT-5.6 的請求控制：新增 ModelSettings.prompt_cache_options，並把 GPT-5.6 的推理模式與上下文設定，帶進 Responses API 的 HTTP 與 WebSocket 連線
轉換 Chat 格式內容（文字、圖片、音訊、檔案）時，會保留明確的快取斷點
實驗性支援 Responses API 的託管式多代理（走 WebSocket）
修正 Responses WebSocket 的驗證標頭傳遞問題，以及一批沙盒與即時語音相關問題

OpenAI 在 GPT-5.6 公告中提到幾項新功能：更可控的提示快取（可明確標記要快取哪段內容）、max 推理強度、Pro 模式，以及 Responses API 裡的多代理測試版。SDK 這兩個版本，就是把它們接進套件裡，讓你不用自己手刻 API 請求。

Chat Completions 路徑仍使用 reasoning.effort；如果你傳入只有 Responses 才有的推理設定，SDK 會發出警告，在嚴格驗證模式下則會直接報錯
多模態內容的快取斷點能不能用，取決於你選的模型與 API 介面
託管式多代理的程式放在 agents.extensions.experimental 底下，PR 附有範例檔，名稱與位置可能再調整
官方說明把 GPT-5.6 的明確快取與舊的保留設定（legacy retention）分開，升級時要檢查舊設定是否還需要

# 升級 Python 版 Agents SDK
pip install -U openai-agents

我覺得這種「模型剛出，SDK 馬上跟上」的節奏，對用 SDK 開發的人其實是個提醒：新模型的新參數，通常不是舊版套件能直接用的，不升級就只能自己拼 API 請求。

不過也別急著全面換。GPT-5.6 的 Sol 輸入價是 Luna 的 5 倍，而文件與範例這次預設改成 gpt-5.6-sol，如果你直接複製範例上線，可能會不知不覺選到最貴的那一級。多代理功能則明確標示為測試版，我會先在測試環境跑跑看，確認 token 用量與行為穩定，再考慮正式使用。

Agents SDK 是什麼？

它是 OpenAI 提供的開發套件，用來建立能呼叫工具、把工作交給其他代理的 AI 代理程式。這篇說的是 Python 版。

升級到 0.18.2 一定要改用 GPT-5.6 嗎？

不用。0.18.2 是加入對 GPT-5.6 新設定的支援，並修了一批問題；沿用舊模型也能升級。不過依 0.18.1 的說明，文件與許多範例已改用 gpt-5.6-sol，複製範例時要留意用的是哪個模型。

託管式多代理可以上正式環境嗎？

官方的 PR 說明寫的是「實驗性」，OpenAI 的 GPT-5.6 公告也標示 multi-agent 為測試版，所以比較適合先在測試環境評估。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。