如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
總覽 智慧體存取權 ChatGPT 與 Codex 使用者文件 使用案例

外掛程式 UI 更新紀錄

外掛程式 UI 相容性 API 與 ChatGPT 擴充功能的最新動態。

August 2026

  • 固定的 OAuth 回呼網址與 CIMD 用戶端 ID

    修正與改進

    • ChatGPT 應用程式可使用固定的 OAuth 回呼網址 https://chatgpt.com/connector_platform_oauth_redirect,前提是其受保護資源與 OAuth 中繼資料指向同一部授權伺服器,且該伺服器支援 RFC 9207 簽發者識別機制。

    • 使用用戶端 ID 中繼資料文件(CIMD)的應用程式也可使用 https://chatgpt.com/oauth/client.json 作為固定的用戶端 ID。不支援簽發者識別機制的伺服器會沿用既有的回呼行為。瞭解更多。

July 2026

  • 舊版工具可見性中繼資料已棄用

    修正與改進

    • 已棄用 _meta["openai/visibility"]。將其設為 private 會讓模型看不到工具,卻未指明應用程式能否看到該工具,因此可能難以判斷工具原本要提供給誰使用。請使用 _meta.ui.visibility 指定工具僅供模型使用、僅供應用程式使用,或供兩者使用。

June 2026

  • ChatGPT 中的應用程式權限設定

    修正與改進

    • ChatGPT 使用者現在可以選擇已連結的應用程式何時需要徵得同意:每次都詢問、在進行變更前詢問,或只在進行重要變更前詢問。個人帳戶使用者可以設定全域偏好,也可以為個別應用程式設定偏好。Business 和 Enterprise 管理員則可管理整個工作區及個別應用程式的預設值。

May 2026

  • MCP Apps 的主機樣式變數

    修正與改進

    • ChatGPT 現在會在初始化時透過 hostContext.styles.variables 提供標準化的 MCP Apps 主機 CSS 變數,並在主機佈景主題變更時透過 ui/notifications/host-context-changed 更新這些變數。應用程式可利用這些變數配合 ChatGPT 的淺色與深色外觀,無須在程式碼中寫死特定主機的色彩值。

  • MCP Apps 工具生命週期更新

    修正與改進

    • ChatGPT 啟動小工具時,window.openai.toolResponseMetadata 現在會保留 MCP 工具結果的標準封裝結構,包括隱藏的 _meta 欄位。

    • 對於需要使用者核准的工具,ChatGPT 現在會等到使用者核准後,才透過 MCP Apps 的 ui/notifications/tool-input 生命週期通知將工具輸入傳給小工具,不再將輸入預先載入小工具的初始全域變數。

  • MCP 伺服器指示

    修正與改進

    • ChatGPT 現在會讀取 MCP 伺服器在初始化時傳回的指示,並結合工具中繼資料來理解跨工具工作流程、限制條件,以及適用於整個伺服器的指引。

  • 輸出結構描述範例

    修正與改進

    • 外掛程式使用者介面和 MCP 伺服器的文件現已在工具範例中示範如何使用 outputSchema,並建議為會傳回結構化內容的工具宣告輸出結構描述。

March 2026

  • 外掛程式發布指南

    修正與改進

    • 經核准的 Apps SDK 整合項目可作為 Codex 外掛程式發布。推出時,外掛程式僅限在 Codex 中使用。

  • window.openai 的檔案庫輔助函式

    修正與改進

    • 當使用者的 ChatGPT 檔案庫可用時,小工具可透過 window.openai.selectFiles() 從檔案庫中選取現有檔案。

    • 當使用者的 ChatGPT 檔案庫可用時,小工具可透過 window.openai.uploadFile(file, { library: true }) 將上傳的檔案儲存至檔案庫。

  • 上傳非圖片檔案

    修正與改進

    • window.openai.uploadFile 現在也支援上傳圖片以外的檔案類型。

February 2026

  • MCP 應用程式相容性

  • 外掛程式介面更新:重新導向、小工具說明與傳送後續訊息時的捲動行為

    修正與改進

    • window.openai.openExternal({ href, redirectUrl }) 支援 redirectUrl: false。使用這項設定可防止主機在外部連結末尾加上 ?redirectUrl=...。

    • window.openai.setOpenInAppUrl({ href }) 是變更全螢幕模式下「在 中開啟」目標網址的受支援方法。若未呼叫此方法,ChatGPT 仍會開啟小工具目前的 iframe 路徑。

    • 建立資源時,若已設定 openai/widgetDescription,系統會優先採用該值,而非 resource.description。

    • window.openai.sendFollowUpMessage 支援 scrollToBottom 參數,預設值為 true。若要停用自動捲動至底部的行為,可傳入 false。

January 2026

  • 公司知識相容性指南

  • 工具呼叫的工作階段中繼資料與 requestModal 範本切換功能

    修正與改進

    • 工具呼叫現在會包含 _meta["openai/session"]。這個匿名化的對話識別碼可用來關聯同一個 ChatGPT 工作階段內的請求。

    • window.openai.requestModal({ template }) 現在支援開啟其他已註冊的 UI 範本,只要傳入來自 registerResource 的範本 URI 即可。

November 2025