設計 Gemini 應用程式和 Google 搜尋等 Google 產品的連結應用程式時,應遵循的規範。
總覽
使用者可透過 MCP 連結應用程式,在任何適用的 Google 產品上連結大型語言模型 (LLM),讀取及寫入應用程式資料。由於應用程式會分享對話內容,使用者不必切換分頁或應用程式,就能輕鬆完成工作。請詳閱這些規範,確保連結的應用程式獲准在適用的 Google 產品中上線。
建立連結的應用程式
使用連結的應用程式的時機
為下列情境建構連結的應用程式:
- 有明確開始和結束時間的工作,例如下單、預訂或鎖定時間表。
- 使用者可立即採取的行動。
- 自然對話式工作流程,例如分析資料、審查文件或協調專案。
- 核心功能,可大幅擴充 AI 的能力。
理想情況下,工具應能協助使用者在 AI 的幫助下完成動作,例如預訂或撰寫文件。著重於基礎模型可簡化流程的複雜動作。
應避免的做法
設計連結應用程式時,請避免下列模式:
- 下拉式選單、內容選單和彈出式面板:這些元素會遭到容器邊界裁剪,或與主機介面 UI 衝突。
- 巢狀捲動:避免在捲動容器內捲動。
- 多層檢視畫面:請勿使用導覽標記或深入分析介面。
- 冗長程序:避免流程超出顯示模式的範圍。
- 獨立網頁應用程式:請勿複製完整的網頁應用程式。
- 未達到預期效果:使用者看到連結應用程式載入時,會預期達到基本實用程度。請勿建立只提供簡單功能 (例如單一按鈕) 的應用程式。
- 自動重新導向:除非使用者明確點選標示清楚的外部連結,否則請勿自動啟動外部網站或原生應用程式。
容器和版面配置
主機容器會將連結的應用程式與模型回覆並排顯示。這些容器提供合作夥伴歸屬、一致的邊框,以及適用 Google 產品的回應式大小。
容器結構
- 標題:顯示合作夥伴的圖示和官方名稱。
- 內容:以內嵌資訊卡或橫向輪轉介面顯示。
- 回覆文字配對:顯示模式一律會伴隨模型回覆文字。請根據這個組合版面配置進行設計。
- UI 樣式:沿用適用 Google 產品的主機容器樣式。
回應式行為
連結的應用程式會根據不同的容器寬度和裝置可視區域顯示。避免使用固定尺寸:
- 水平重排:使用彈性版面配置,在精簡側欄、行動裝置螢幕和寬版電腦動態消息之間流暢調整,不會水平裁剪。
- 垂直調整內容:讓內嵌容器配合內容調整大小,直到達到舒適的閱讀高度。請勿在資訊卡中加入固定的空白空間,或將內容限制在垂直捲軸中。
- 尊重裝置輸入:支援行動裝置的原生觸控手勢和安全區域,以及電腦上的懸停狀態。
應避免的做法
- 避免重複邊框間距:連結的應用程式包含預設內部邊框間距,以符合系統標準。移除內部內容的多餘邊框間距,避免出現不必要的間距。
- 避免不平衡的圓角半徑:內部形狀應與主容器的圓角半徑成比例,避免過於尖銳或圓滑。
- 避免自行新增筆劃:容器預設包含系統定義的邊框樣式。請勿在內部元件周圍加上額外的邊框或筆劃。
顯示模式
顯示模式會定義擴充功能如何在適用的 Google 產品回覆旁,直接顯示視覺化 UI。使用兩種主要顯示模式之一:內嵌資訊卡或全螢幕。
內嵌資訊卡
內嵌資訊卡是輕量、單一用途的元件,直接嵌入回覆流程中。使用內嵌資訊卡,快速確認、檢查結構化資料或執行單一步驟動作。
內嵌資訊卡的使用時機
- 狀態更新和確認。
- 簡單的資料顯示或選取。
- 簡短摘要,可視需要展開。
- 延續對話的快速操作。
內容密度和截斷防護機制
- 標題截斷:將資訊卡標題限制在 1 到 2 行,並以刪節號截斷,確保標頭不會將動作推到檢視畫面外。
- 內文和中繼資料限制:輔助文案最多 2 到 3 行,每項中繼資料最多 2 到 3 個可掃描屬性。
- 簡潔的行動號召文字:使用動詞開頭的動作標籤 (例如「預訂桌位」或「確認訂單」),並將資訊卡頁尾限制為最多 1 個主要行動號召和 1 個選用的次要動作。
輪轉介面定義:輪轉介面應包含 3 到 8 張資訊卡,讓使用者能捲動瀏覽,但不會感到疲乏,且所有資訊卡的高度和寬度尺寸都應相同。資訊卡標題應限制在 1 到 2 行,中繼資料則限制在每張資訊卡 2 到 3 個欄位。
內嵌資訊卡的互動
內嵌資訊卡應著重於快速、直接的操作,讓使用者能持續對話。
- 內嵌動作:允許使用者直接在資訊卡中執行動作,例如編輯文字、新增項目或勾選工作。
- 狀態更新:直接在討論串中反映複雜的使用者動作,而非在實體中。舉例來說,當使用者預訂住宿時,系統會產生更新後的資訊卡,並在對話中顯示「已預訂」標籤。
電腦版輪轉介面導覽
- 懸停機制:導覽圖示按鈕預設為隱藏,並在容器懸停時顯示。
- 溢位遮罩:起始狀態會顯示右側邊緣遮罩,中間狀態會顯示兩側邊緣,結束狀態則會顯示左側邊緣。
輪轉介面行動版體驗
- 觸控手勢:使用原生水平滑動,輪轉介面資訊卡之間有間隔。
- 卡片窺視:開始狀態使用左側邊框間距,中間狀態不使用任何邊框間距,結束狀態使用右側邊框間距。
內嵌資訊卡應避免的事項
- 避免巢狀捲動:請勿加入內部垂直捲軸。
- 避免多重視圖深入分析:請勿在內嵌資訊卡中使用麵包屑、多分頁檢視和多步驟深入分析。將複雜的流程移至全螢幕。
- 避免在選單上顯示控制項:請勿使用下拉式選單、彈出式視窗和內容選單,因為這些控制項會導致容器裁剪和 z-index 衝突。
- 避免重複輸入:請勿在卡片中放置其他輸入內容,因為適用的 Google 產品已有輸入內容。
- 避免內部垂直捲動:請勿在資訊卡中放置可捲動的容器,否則會導致捲動陷阱,降低行動裝置導覽體驗。
- 避免使用彈出式視窗:彈出式視窗會遮蓋內容並使 UI 雜亂,因此請勿使用工具提示或彈出式疊加層顯示重要詳細資料。
- 避免使用下拉式選單:請勿將動作隱藏在下拉式選取器中。將主要動作設為明確的按鈕。
- 避免隱藏輪轉介面中的捲動溢位:確保相鄰的資訊卡會顯示在畫面中,讓使用者知道可以捲動查看更多內容。
- 避免使用自訂錯誤元件:請勿使用自訂錯誤狀態;主機 UI 會在整個體驗中提供標準錯誤元件。
- 避免使用互動視窗:MCP 應用程式不支援互動視窗。如需更多空間,請提供切換至全螢幕模式的選項。
全螢幕
全螢幕模式可做為沉浸式畫布,用於處理複雜的多步驟工作,或無法容納在內嵌資訊卡中的大量資料工作流程。
全螢幕模式使用時機
- 瀏覽房地產資訊、選單或互動式地圖等密集內容。
- 複雜的工作流程,例如編輯畫布或圖表,需要內嵌資訊卡以外的專屬空間。
- 資料和分析,例如查看豐富的資訊主頁、資料圖表,以及需要專注使用的詳細分析工具。
全螢幕版面配置和互動
- 標頭:顯示系統提供的標頭列,其中包含應用程式歸因和動作。
- 安全區域內凹:在標頭列下方保留明確間距,避免內容重疊。
- 關閉和開啟:顯示以全螢幕開啟的按鈕,以及全螢幕檢視畫面標頭中的關閉按鈕。
全螢幕模式應避免的元素
- 避免複製原生應用程式:使用全螢幕模式,讓使用者更專注於多步驟工作。
- 避免重複輸入:由於適用的 Google 產品已有輸入,合作夥伴不應在檢視畫面中放置另一個輸入。
- 避免使用浮動面板:請勿使用浮動互動視窗或浮動可拖曳檢查工具列,因為這會使介面雜亂,並與主機介面重疊元素衝突。
- 避免重疊安全區域:互動元素應避開主機介面工具列和系統指標,例如狀態列和主畫面列。
互動指南
使用者如何操作連結應用程式中的內容、動作如何與主機對話同步,以及何時將複雜的工作流程交給外部應用程式或網站。
應用程式 UI 與對話分工
將連結的應用程式和對話提示詞設計為互補層:
- 使用連結的應用程式 UI 直接操作:使用 UI 進行空間瀏覽,例如平移地圖、比較結構化選項、多欄位表單控制項,以及視覺化選取,避免輸入文字提示詞時繁瑣或模糊不清。
- 使用主機對話處理開放式意圖:使用對話進行自然語言後續追蹤、多步驟合成,以及廣泛的探索式查詢。
漸進式揭露
- 漸進式揭露:先以最精簡的顯示模式 (內嵌資訊卡或輪轉介面) 滿足使用者需求,再視需要顯示次要詳細資料 (「顯示更多」),只有在需要深入探索時,才切換至全螢幕模式。
- 顯示控制項,而非隱藏選單:將主要動作設為明確的按鈕或切換鈕,而不是隱藏在僅限滑鼠懸停的工具列、按一下滑鼠右鍵的內容選單,或在行動檢視區中無法使用的長按手勢。
外部交接和連結
部分功能超出嵌入式 iframe 的範圍,或需要原生 OS 和硬體功能。連結至應用程式或網站的時機:
- 原生 OS 或硬體相關功能 (例如即時導航、相機或感應器擷取,或持續背景音訊和位置追蹤)。
- 受管制或安全敏感流程 (例如最終付款結帳或身分驗證)。
- 超出全螢幕的深度工作區 (例如功能完整的編寫套件或複雜的企業資訊主頁)。
設計交接
- 顯示明確的外部連結功能:一律將外部接力按鈕與明確的啟動指標 (例如
open_in_new圖示) 和目的地專屬標籤 (例如「在 Google 地圖中開啟」) 配對。 - 保留情境的深層連結:透過主機的外部連結 API (
openLink),將對話中建立的所有參數傳遞至深層連結網址,這樣使用者切換應用程式後,就不必重新輸入所選項目。
應避免的做法
- 避免自動重新導向:請勿自動將使用者導出主機介面。使用者必須明確點選,才能離開託管介面。
- 避免使用「預告」或僅含連結的資訊卡:請勿建構連結的應用程式,其唯一目的是顯示靜態橫幅或按鈕,將使用者導向您的網站。
- 避免在未告知的情況下切換情境:請勿將外部連結的樣式設為與資訊卡內動作相同,除非您有指出該連結會開啟外部應用程式或瀏覽器分頁。
視覺效果準則
適用的 Google 產品會優先採用輕量、中性的 UI 元素和柔和的對比度,減輕認知負荷。
視覺原則
套用核心設計原則,控管連結應用程式的視覺密度和美感:
- 更輕巧、簡約的 UI:減少筆劃和容器元素,維持簡潔的視覺密度。
- 中性色平衡:優先使用中性灰色調,並將強調色保留給主要行動號召。
- 高度:套用柔和的表面填色,將投射陰影限制在全螢幕模式和輪轉介面導覽控制項。
- 樣式沿用:套用顏色、字體和圓角半徑,讓應用程式在所有適用的 Google 產品中,都能呈現原生風格。
顏色
適用的 Google 產品會將顏色分為兩個功能群組:用於結構版面配置的系統顏色,以及用於主要品牌時刻的強調色。使用這些語意角色,可確保視覺階層清楚明確,且各項產品會自動調整主題。
系統顏色角色
將結構色對應至連結應用程式中一致的 UI 角色:
- 背景表面:使用主機提供的中性表面顏色,做為資訊卡容器和巢狀分組的顏色。避免使用自訂純色填滿、漸層或圖案覆寫容器背景。
- 文字和內容階層:標題和重要值使用主要內容顏色,內文和輔助標籤使用次要柔和色調,作業中繼資料則使用語意狀態顏色 (正面、警告、重大)。
- 邊框和分隔線:使用精細的系統外框顏色,為結構邊框和分隔線區隔內容,不增加視覺權重。
- 主要強調色:使用系統強調色或合作夥伴品牌顏色,做為主要行動號召按鈕的顏色。
合作夥伴品牌應用領域
引導合作夥伴品牌顏色在連結應用程式中的位置:
- 建議做法:選擇性地將品牌顏色套用至主要行動號召按鈕、標誌和重要精彩時刻。
- 不建議:避免將品牌顏色套用至資訊卡背景、內文、標題、結構邊框或次要互動控制項。
主題與淺色/深色模式
連結的應用程式在淺色和深色主題,以及動態介面調色盤中,都必須呈現一致的風格:
- 使用語意符記,而非靜態十六進位值:將介面、文字和邊框繫結至主機介面的語意顏色符記,讓介面自動在淺色和深色模式之間切換。
- 調整兩種主題的品牌強調色:確保品牌強調色在兩種主題中都能維持無障礙對比度。如果預設品牌顏色在深色表面上顯得太暗或過於鮮豔,請在深色模式中提供稍微淺色或飽和度較低的變體。
- 使用主題適用的媒體和標誌:匯出具有透明背景的圖示、標誌和插圖,避免在深色模式中顯示明顯的白色定界框。
圖示
「連結的應用程式」採用簡潔的線條圖示,在適用的 Google 產品中維持視覺和諧,並方便使用者快速瀏覽。
圖示樣式和大小
連結應用程式的圖示幾何圖形、顏色和大小門檻指南:
- 圓角外框幾何圖形:使用單色外框圖示,筆畫粗細一致且端點圓潤 (例如 Google Material Symbols Outlined),或使用與主機介面視覺權重相符的合作夥伴圖示組合。
- 中性色調:使用主要或次要內容顏色 (而非品牌顏色) 為功能性 UI 圖示著色,讓圖示支援閱讀階層,不與主要行動號召競爭。
- 大小限制:圖示大小應介於 16px (適用於精簡內嵌中繼資料) 和 32px (適用於醒目資訊卡或功能標頭) 之間,確保在不同檢視區中都能清楚辨識,且比例適當。
無障礙設定
適用的 Google 產品會強制執行符合 WCAG 2.1 AA 和 Material Design 3 標準的無障礙規範。
無障礙功能的核心要素
- 色彩對比:在淺色和深色主題中,文字與表面背景的 WCAG AA 對比度至少須為 4.5:1。
- 文字大小下限:強制設定為 13pt。
- 觸控目標:強制規定控制項的互動目標區域大小,行動裝置至少為 48x48 像素,電腦至少為 24x24 像素。
- 鍵盤焦點:在互動式資訊卡元件中,保留可見的焦點指標環和邏輯分頁遍歷順序。
- 動態媒體替代文字:為所有合作夥伴提供的圖片、縮圖、地圖圖釘和資料圖表,提供描述性替代文字。
- 即時狀態公告 (
aria-live):使用aria-live="polite"區域,宣布動態資訊卡內狀態變更,例如展開「顯示更多」列、篩選項目或完成內嵌動作。 - 減少動態效果 (
prefers-reduced-motion):尊重使用者的prefers-reduced-motion媒體查詢,將骨架閃爍效果和輪轉介面投影片轉場效果,替換為靜態或即時狀態變更。 - 內容溢位和截斷:將長文字區塊限制在 3 到 5 行,並提供無障礙的「閱讀更多」動作,避免版面配置中斷,並維持可讀性。