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

使用者介面設計指南

在 ChatGPT 中為外掛程式設計選用介面的指南。

概覽

外掛程式可視需要提供介面,讓使用者在不中斷對話的情況下完成更多操作。只有在視覺互動有助於改善工作流程時,才使用卡片、輪播、全螢幕檢視或其他顯示模式。

ChatGPT 行動版介面中的應用程式範例

設計系統

若要設計出品質優良、與 ChatGPT 原生介面風格一致的介面,可以使用 @openai/apps-sdk-ui 元件庫。

這個元件庫以 Tailwind 為樣式基礎,提供以 CSS 變數定義的設計權杖,以及一系列精心設計的無障礙元件。

你可以自行決定是否使用這個元件庫。使用它能更快建立符合 ChatGPT 設計系統的元件。

在開始撰寫程式碼之前,先用我們的 Figma 元件庫著手設計。

顯示模式

開發者可以透過不同的顯示模式,在 ChatGPT 中設計應用程式的互動介面。合作夥伴可藉此將內容和操作自然融入對話。從快速確認到沉浸式工作流程,每種模式都適合特定的互動方式。

以一致的方式使用這些模式,有助於讓操作保持簡單,符合使用者預期。

內嵌

內嵌模式會將介面直接呈現在對話中。目前,內嵌介面一律顯示在模型產生的回覆之前。所有應用程式最初都會以內嵌模式顯示。

ChatGPT 中的內嵌卡片與輪播範例

版面配置

  • 圖示與工具呼叫:標籤會顯示應用程式的名稱與圖示。
  • 內嵌顯示區:以輕量介面將應用程式內容嵌入模型回覆上方。
  • 後續回覆:模型產生的簡短回覆會顯示在小工具之後,建議使用者可修改的地方、後續步驟或相關操作。避免重複卡片中的內容。

內嵌卡片

內嵌卡片是直接嵌入對話、用途單一的輕量小工具。使用者可以透過卡片快速確認事項、執行基本操作,或查看輔助圖像。

適用時機

  • 只需執行一項操作或做一個決定,例如確認預訂。
  • 顯示少量結構化資料,例如地圖、訂單摘要或簡短的狀態資訊。
  • 提供可獨立使用的小工具或工具,例如音訊播放器或計分卡。

版面配置

內嵌卡片的版面配置圖

  • 標題:如果卡片以文件為主,或包含同屬某個上層項目的內容(例如播放清單中的歌曲),請加上標題。
  • 展開:如果卡片包含豐富的媒體內容或互動元素,例如地圖或互動式圖表,可用這項操作開啟全螢幕模式。
  • 顯示更多:如果以清單呈現多筆結果,可用這項操作顯示更多項目。
  • 編輯控制項:讓使用者直接在對話中編輯應用程式的回應,同時避免讓控制項占用過多對話空間。
  • 主要操作:卡片底部最多放置兩項操作。每項操作都應觸發一輪對話或一次工具呼叫。

互動方式

內嵌卡片的互動方式示意圖

卡片支援簡單的直接操作。

  • 狀態:使用者所做的修改會保留下來。
  • 直接編輯:適合時,可讓使用者直接在卡片內快速修改文字,無須向模型輸入提示詞。
  • 動態版面配置:卡片可依內容增加高度,最高可達行動裝置顯示區域的高度。

設計要點

  • 限制每張卡片的主要操作數量:最多提供兩項操作,包括一個主要行動呼籲(CTA),以及一個選用的次要 CTA。
  • 避免在同一卡片內設置多層導覽或多個檢視。 卡片內不應有多個通往詳細內容的入口、分頁或更深層的導覽。可考慮將這些內容拆分成獨立卡片或工具操作。
  • 避免巢狀捲動。卡片應自動配合內容調整大小,避免在卡片內捲動。
  • 避免重複提供輸入功能。不要在卡片內重製 ChatGPT 已有的功能。

內嵌卡片應避免的設計範例

內嵌輪播

輪播會並排顯示一組卡片,方便使用者快速瀏覽並從多個選項中做選擇。

適用時機

  • 列出少量同類項目,例如餐廳、播放清單或活動。
  • 項目的視覺內容和中繼資料較多,簡單的清單列放不下。

版面配置

內嵌輪播的版面配置圖

  • 圖片:每個項目都應包含圖片或其他視覺元素。
  • 標題:輪播項目通常應有標題,說明項目內容。
  • 中繼資料:根據回覆的上下文,顯示該項目最重要、最相關的資訊。盡量不要超過兩行文字。
  • 徽章:適合時,可用徽章提供補充資訊。
  • 操作:盡可能為每個項目提供單一且明確的 CTA。

設計要點

  • 為方便閱讀,每組輪播以 3–8 個項目為宜。
  • 中繼資料僅保留最相關的細節,最多三行。
  • 每張卡片可視需要提供一個 CTA,例如「預訂」或「播放」。
  • 各張卡片的視覺層次應保持一致。

全螢幕

全螢幕模式將介面延伸到內嵌卡片之外,提供沉浸式體驗,讓使用者有足夠的空間完成多步驟工作流程或深入探索。ChatGPT 撰寫工具會持續顯示在畫面上層,讓使用者能針對全螢幕檢視中的內容,繼續用自然的方式「與應用程式對話」。

適用時機

  • 處理單張卡片容納不下的複雜任務,例如操作附有地點標記的互動式地圖、功能豐富的編輯畫布或互動式圖表。
  • 瀏覽詳細內容,例如房屋物件清單或菜單。

版面配置

全螢幕版面配置圖

  • 系統關閉控制項:關閉面板或檢視。
  • 全螢幕檢視:顯示內容的區域。
  • 撰寫工具:ChatGPT 的原生撰寫工具,讓使用者能針對全螢幕檢視中的內容繼續對話。

互動方式

全螢幕模式的互動方式

  • 對話面板:在全螢幕介面旁保留對話上下文。
  • 思考中:撰寫工具的輸入框會顯示微光動畫,表示回覆正在串流傳送。
  • 回覆:模型完成回覆後,撰寫工具上方會短暫顯示一小段回覆文字。輕觸這段文字即可開啟對話面板。

設計要點

  • 設計互動流程時,請配合系統撰寫工具。全螢幕模式會一直顯示撰寫工具,因此請確保使用者能以自然的對話提示詞觸發工具呼叫。
  • 需要較大操作空間的工作適合使用全螢幕模式。 如果現有的編輯器和管理介面符合 iframe 政策,即可嵌入。

子母畫面(PiP)

子母畫面是 ChatGPT 中可持續顯示的浮動視窗,適合遊戲、影片等持續進行或即時播放的活動。對話進行時,PiP 仍會保持可見,也可以根據使用者的提示詞動態更新。

適用時機

  • 活動可與對話同時進行,例如遊戲、即時協作、測驗或學習活動。
  • PiP 小工具能回應對話中的輸入,例如依使用者的要求繼續一回合遊戲,或重新整理即時資料。

互動方式

子母畫面的互動方式

  • 啟用時: 使用者捲動畫面時,PiP 視窗會固定在顯示區域頂端。
  • 固定後: PiP 會保持固定,直到使用者關閉視窗或活動結束。
  • 活動結束時: PiP 會回到對話中的內嵌位置,並隨捲動移出畫面。

設計要點

  • 使用者透過系統撰寫工具互動時,請確保 PiP 能更新狀態或做出回應。
  • 活動結束時,自動關閉 PiP。
  • 避免在 PiP 中放入過多控制項或靜態內容,尤其是較適合以內嵌或全螢幕模式呈現的項目。

視覺設計指南

一致的外觀與操作體驗,有助於讓合作夥伴開發的工具自然融入 ChatGPT 平台。視覺設計指南讓介面清楚、易用且符合無障礙需求,也保留了適當展現品牌特色的空間。

以下原則說明如何運用色彩、文字排版、間距和圖像,讓系統介面保持清晰,同時展現各家服務的特色。

為什麼一致性很重要

一致的視覺設計與操作方式,能改善使用者在 ChatGPT 中使用應用程式的整體體驗。遵循這些指南,合作夥伴便能以使用者熟悉的方式呈現工具,讓使用者專注於工具提供的功能。

色彩

使用系統定義的色盤,有助於讓各項操作與回覆的外觀始終與 ChatGPT 平台一致。合作夥伴可以透過點綴元素、圖示或內嵌圖像展現品牌特色,但不應重新定義系統色彩。

色盤

設計要點

  • 文字、圖示以及分隔線等用來區分空間的元素,都應使用系統色彩。
  • 標誌或圖示等品牌點綴元素不應覆寫背景色或文字顏色。
  • 避免使用破壞 ChatGPT 簡約風格的自訂漸層或圖樣。
  • 在應用程式的顯示模式中,主要按鈕應使用品牌強調色。

色彩運用範例

將品牌色用於點綴元素和徽章。請勿變更文字顏色或其他核心元件樣式。

色彩運用範例

請勿為文字區域加上背景色。

文字排版

ChatGPT 使用各平台的原生系統字型(iOS 使用 SF Pro,Android 使用無襯線字型),以確保文字在各種裝置上都容易閱讀,並符合無障礙需求。

文字排版

設計要點

  • 一律繼承系統字型堆疊,並遵循系統對標題、內文和圖說的字級規範。
  • 合作夥伴可在內容區域使用粗體、斜體或醒目標示等樣式。請勿將這些樣式套用到介面結構元素。
  • 盡量減少字級變化,優先使用標準內文或小內文字級。

文字排版範例

即使在全螢幕模式中,也不要使用自訂字型。盡可能使用系統字型變數。

間距與版面配置

統一外距、內距與對齊方式,能讓使用者在對話中快速瀏覽合作夥伴提供的內容,也更容易預期各項資訊的位置。

間距與版面配置

設計要點

  • 卡片、集合與檢查器面板應使用系統格線間距。
  • 保持內距一致,避免內容過於擁擠或文字緊貼邊緣。
  • 盡可能使用系統指定的圓角半徑,讓元素的形狀保持一致。
  • 依序排列標題、輔助文字與 CTA,建立清楚的視覺層次。

圖示與圖像

系統圖示有助於清楚傳達功能,合作夥伴的標誌和圖片則能幫助使用者辨識品牌。

圖示

設計要點

  • 使用系統圖示,或採用符合 ChatGPT 視覺風格的自訂圖示,以單色線條勾勒輪廓。
  • 請勿在回覆內容中加入品牌標誌。ChatGPT 一律會先加上品牌標誌和應用程式名稱,再顯示小工具。
  • 所有圖像都必須符合規定的長寬比,以免變形。

圖示與圖像

無障礙設計

合作夥伴提供的每項體驗,都應讓盡可能多的人能夠使用。為 ChatGPT 開發應用程式時,應將無障礙設計列為核心考量。

設計要點

  • 文字與背景的對比度必須達到 WCAG AA 規定的最低對比值。
  • 為所有圖片提供替代文字。
  • 支援調整文字大小,並確保調整後版面仍能正常顯示。