关联的应用的设计准则

有关如何设计适用于 Gemini 应用和 Google 搜索等 Google 产品的关联应用的指南。

概览

MCP 关联的应用可让用户在任何适用的 Google 产品上关联大语言模型 (LLM),以读取和写入应用的数据。由于您的应用会共享对话上下文,因此用户无需切换标签页或应用即可轻松完成任务。请查看这些准则,确保您关联的应用获准在适用的 Google 产品中发布。

创建关联的应用

何时使用关联的应用

针对以下场景构建关联的应用:

  • 有明确开始和结束时间的任务,例如下单、预订或锁定日程。
  • 用户可以立即应用的实用信息。
  • 自然对话工作流,例如分析数据、审核文档或协调项目。
  • 可显著扩展 AI 功能的核心功能。

理想情况下,您的工具应能帮助用户在 AI 的协助下完成操作,例如进行预订或撰写文档。重点关注基础模型可以简化流程的复杂操作。

避免事项

设计关联的应用时,请避免以下模式:

  • 下拉菜单、上下文菜单和弹出式面板:这些元素会被容器边界剪裁,或与宿主界面冲突。
  • 嵌套滚动:避免在滚动容器内滚动。
  • 多层视图:请勿使用面包屑导航或深入分析界面。
  • 流程冗长:避免流程超出显示模式的范围。
  • 独立 Web 应用:请勿复制完整的 Web 应用。
  • 未达到预期:当用户看到互联应用加载时,他们会期望获得基本的实用性。不要仅为了呈现琐碎功能(例如单个按钮)而创建应用。
  • 自动重定向:除非用户明确点击了清晰标记的外部链接,否则不得自动启动外部网站或原生应用。

容器和布局

宿主容器会将关联的应用与模型回答并排显示。这些容器在适用的 Google 产品中提供合作伙伴归因、一致的边框和自适应尺寸。

容器剖析

  1. 标题:显示合作伙伴的图标和官方名称。
  2. 内容:以嵌入式卡片或水平轮播界面的形式显示。
  3. 回答文本配对:显示模式始终伴随模型回答文本。围绕此组合布局进行设计。
  4. 界面风格:在适用的 Google 产品中沿用宿主容器的风格。

自适应行为

关联的应用可在不同的容器宽度和设备视口中呈现。 避免使用固定尺寸:

  • 水平重排:使用灵活的布局,在紧凑的边栏、移动设备屏幕和宽幅桌面信息流之间自适应,避免水平裁剪。
  • 垂直方向上适应内容:让内嵌容器在垂直方向上扩展以适应其内容,直至达到舒适的阅读高度。切勿使用固定的空白区域填充卡片,或将内容限制在垂直滚动条中。
  • 遵循设备输入:支持移动设备上的原生触控手势和安全区域,以及桌面设备上的悬停状态。

避免事项

  • 避免双重内边距:关联的应用包含默认内部内边距,以满足系统标准。从内部内容中移除额外的内边距,以避免出现不必要的间距。
  • 避免圆角半径不平衡:使内部形状与宿主容器的圆角半径成比例,以避免圆角过于尖锐或过于圆润。
  • 避免添加自己的描边:容器默认包含系统定义的边框样式。请勿在内部组件周围应用额外的边框或描边。

显示模式

显示模式定义了扩展程序如何直接在适用的 Google 产品回答旁边显示可视化界面。使用两种主要显示模式之一:内嵌卡片或全屏。

内嵌卡片

内嵌卡片是直接嵌入到回答流程中的轻量级单一用途组件。使用内嵌卡片可进行快速确认、结构化数据检查或单步操作。

何时使用内嵌卡片

  • 状态更新和确认。
  • 简单的数据显示或选择。
  • 简短摘要,可选择展开。
  • 可继续对话的快速操作。

内容密度和截断保护措施

  • 标题截断:将卡片标题限制为 1-2 行,并使用省略号截断,确保标题不会将操作按钮挤出视图。
  • 正文和元数据限制:辅助文案最多 2-3 行,每项元数据最多 2-3 个可扫描属性。
  • 简洁的 CTA 文案:使用动词开头的操作标签(例如“预订餐桌”或“确认订单”),并将卡片页脚限制为最多 1 个主要 CTA 和 1 个可选的次要操作。

轮播界面定义:轮播界面应包含 3 到 8 张卡片,以确保滚动操作有意义且不会造成疲劳,同时所有卡片应保持相同的高度和宽度尺寸。将卡片标题限制为 1-2 行,并将每张卡片的元数据限制为 2-3 个字段。

内嵌卡片的互动

内嵌卡片应专注于快速、直接的操作,让用户保持对话。

  • 内嵌操作:允许用户直接在卡片内执行操作,例如修改文本、添加内容或勾选任务。
  • 状态更新:直接在会话串中(而不是在实体中)反映复杂的用户操作。例如,当用户预订住宿时,生成一张更新后的卡片,在对话中显示“已预订”标签。
  • 悬停机制:导航图标按钮默认保持隐藏状态,在容器悬停时显示。
  • 溢出纱罩:开始状态显示右边缘纱罩,中间状态显示两个边缘,结束状态显示左边缘。
  • 轻触手势:使用原生水平滑动,轮播卡片之间有间隙。
  • 卡片窥视:开始状态使用左内边距,中间状态不使用任何内边距,结束状态使用右内边距。

内嵌卡片应避免的事项

  • 避免嵌套滚动:切勿包含内部垂直滚动条。
  • 避免多视图深入分析:禁止在内嵌卡片中使用面包屑导航、多标签页视图和多步深入分析。将复杂的流程移至全屏。
  • 避免在菜单上使用可见控件:请勿使用下拉菜单、弹出式窗口和上下文菜单,因为它们会导致容器剪裁和 z-index 冲突。
  • 避免重复输入:请勿在卡片中放置其他输入,因为适用的 Google 产品已经有输入。
  • 避免内部垂直滚动:请勿在卡片内放置可滚动容器,否则会导致滚动陷阱并降低移动导航体验。
  • 避免使用弹出式窗口:由于弹出式窗口会遮盖内容并使界面杂乱,因此请勿使用提示或弹出式叠加层来显示关键细节。
  • 避免使用下拉菜单:不要将操作隐藏在下拉选择器中。 将主要操作显示为显式按钮。
  • 避免在轮播界面中隐藏滚动溢出内容:确保相邻卡片部分可见,以便用户知道还有更多内容可供滚动查看。
  • 避免使用自定义错误组件:请勿使用自定义错误状态;宿主界面将在整个体验中一致地提供标准错误组件。
  • 避免使用模态窗口:MCP 应用不支持模态窗口;如果您需要更多空间,请提供切换到全屏模式的选项。

全屏

将全屏模式用作沉浸式画布,用于处理无法包含在内嵌卡片中的丰富、多步骤任务或数据密集型工作流。

何时使用全屏

  • 浏览密集内容,例如房地产信息、菜单或交互式地图。
  • 复杂的工作流,例如编辑画布或图表,这些工作流需要内嵌卡片之外的专用空间。
  • 数据和分析,例如查看丰富的信息中心、数据可视化图表以及需要集中注意力的详细分析工具。

全屏布局和互动

  1. 标题:显示系统提供的标题栏,其中包含应用归因和操作。
  2. 安全区域边衬区:在标题栏下方保持清晰的间距,以防止内容重叠。
  3. 关闭和打开:显示一个用于以全屏模式打开的按钮,并在全屏视图的标题中显示一个关闭按钮。

全屏模式下应避免的事项

  • 避免复制原生应用:使用全屏模式,让用户更专注于多步骤任务,从而加深互动。
  • 避免重复输入:由于适用的 Google 产品已经有输入,因此合作伙伴不应在视图中放置其他输入。
  • 避免使用浮动面板:请勿使用浮动模态窗口或浮动可拖动检查器工具栏,因为它们会使界面杂乱无章,并与宿主界面叠加层发生冲突。
  • 避免与安全区域重叠:确保互动元素不会遮挡宿主界面工具栏和系统指示器(例如状态栏和主屏幕栏)。

互动准则

用户如何在关联的应用中操作内容、操作如何与主对话同步,以及何时将复杂的工作流移交给外部应用或网站。

应用界面与对话的分工

将关联的应用和对话式提示设计为互补层:

  • 使用关联的应用界面进行直接操作:使用界面进行空间浏览,例如平移地图、比较结构化选项、多字段表单控件和视觉选择,在这些场景中,输入文本提示词会很繁琐或不明确。
  • 使用主对话实现开放式意图:使用对话进行自然语言跟进、多步合成和广泛的探索性查询。

逐步揭示游戏内容

  • 渐进式披露:首先使用最紧凑的显示模式(内嵌卡片或轮播界面)来满足用户需求,然后根据需要显示次要细节(“显示更多”),最后仅在需要深入探索时才升级到全屏模式。
  • 可见控件优于隐藏菜单:将主要操作公开为显式按钮或切换开关,而不是将其隐藏在仅悬停工具栏、右键点击上下文菜单或在移动设备视口中无法使用的长按手势中。

外部转接和链接

某些功能超出了嵌入式 iframe 的范围,或者需要原生操作系统和硬件功能。何时链接到您的应用或网站:

  • 原生操作系统或依赖硬件的功能(例如实时导航、摄像头或传感器捕获,或持续的后台音频和位置跟踪)。
  • 受监管或对安全性敏感的流程(例如,最终付款结账或身份验证)。
  • 超出全屏范围的深度工作区(例如,功能齐全的创作套件或复杂的企业信息中心)。

设计交接

  • 显示清晰的外部链接提示:始终将外部切换按钮与明确的启动指示器(例如 open_in_new 图标)和特定于目的地的标签(例如“在 Google 地图中打开”)配对。
  • 保留上下文的深层链接:通过主机的外部链接 API (openLink) 将对话中建立的所有参数传递到深层链接网址中,这样用户在切换应用后就无需重新输入其选择。

避免事项

  • 避免自动重定向:切勿自动将用户从宿主平台中转出。离开宿主界面必须始终需要用户明确点击。
  • 避免使用“预告”或仅包含链接的卡片:请勿构建仅用于呈现静态横幅或按钮的关联应用,因为这些横幅或按钮会将用户引导至您的网站。
  • 避免在不通知用户的情况下切换上下文:切勿将外部链接的样式设置为与卡片内操作完全相同,而不指明该链接会打开外部应用或浏览器标签页。

影像内容准则

适用的 Google 产品会优先采用轻量、中性的界面元素和柔和的对比度,以减轻认知负荷。

视觉原则

应用核心设计原则,控制互联应用中的视觉密度和美观度:

  • 更轻量、更简约的界面:减少描边和容器元素,保持简洁的视觉密度。
  • 中性色平衡:优先使用中性灰色调,将强调色留给主要 CTA。
  • 高度:应用柔和的表面填充,仅在全屏模式和轮播界面导航控件中使用阴影。
  • 样式继承:应用颜色、排版和圆角半径,让应用在每个适用的 Google 产品中都具有原生风格。

颜色

适用的 Google 产品将颜色分为两个功能组:用于结构布局的系统颜色和用于主要品牌时刻的强调色。依赖这些语义角色可确保清晰的视觉层次结构,并使主题自动适应各种产品。

系统颜色角色

将结构颜色映射到各个关联应用中一致的界面角色:

  • 背景表面:为卡片容器和嵌套分组使用宿主提供的中性表面颜色。避免使用自定义纯色填充、渐变或图案覆盖容器背景。
  • 文本和内容层次结构:对标题和键值对使用主要内容颜色,对正文和辅助标签使用次要柔和色调,对操作元数据使用语义状态颜色(积极、警告、严重)。
  • 边框和分隔线:对结构边框和分隔线使用柔和的系统轮廓颜色,以分隔内容,而不会增加过重的视重。
  • 主要强调色:将系统强调色或合作伙伴品牌颜色用于主要行动号召按钮。

合作伙伴品牌应用领域

指导合作伙伴在关联的应用中放置品牌颜色:

  • 建议:有选择地将品牌颜色应用于主要行动号召按钮、徽标和关键亮点时刻。
  • 不建议:避免将品牌颜色应用于卡片背景、正文、标题、结构边框或次要互动控件。

主题和浅色/深色模式

互联应用在浅色和深色主题以及动态表面调色板中必须具有一致的风格:

  • 使用语义令牌,而非静态十六进制值:将 Surface、文本和边框绑定到宿主 Surface 的语义颜色令牌,以便界面在浅色模式和深色模式之间自动调整。
  • 针对两种主题调整品牌强调色:确保您的品牌强调色在两种主题中都保持无障碍对比度。如果您的默认品牌颜色在深色表面上显得太暗或过于鲜艳,请在深色模式下提供稍微浅一点或饱和度较低的变体。
  • 使用支持主题的媒体和徽标:导出具有透明背景的图标、徽标和插图,以便在深色模式下不会显示明显的白色边界框。

图标

“互联应用”使用简洁的轮廓图标,以便在适用的 Google 产品中保持视觉和谐和可扫描性。

图标样式和尺寸

在所有关联的应用中,引导图标的几何形状、颜色和大小阈值:

  • 带轮廓的圆角几何图形:使用具有统一描边粗细和圆角端点的单色轮廓图标(例如 Google Material Symbols Outlined),或与宿主界面的视重相匹配的协调合作伙伴图标集。
  • 中性色调:使用主要或次要内容颜色(而非品牌颜色)为功能性界面图标着色,以便图标支持阅读层次结构,而不会与主要 CTA 冲突。
  • 尺寸边界:图标尺寸应介于 16 像素(适用于紧凑的内嵌元数据)和 32 像素(适用于突出的卡片或功能标题)之间,以确保在各种视口中都清晰可辨且比例协调。

无障碍

适用的 Google 产品会强制执行符合 WCAG 2.1 AA 和 Material Design 3 标准的无障碍合规性。

无障碍功能的核心支柱

  • 颜色对比度:在浅色和深色主题中,强制要求文本与表面背景的对比度至少达到 4.5:1(WCAG AA 标准)。
  • 文字大小下限:强制采用 13pt 字号。
  • 触摸目标:强制要求控件的互动目标区域在移动设备上至少为 48x48 像素,在桌面设备上至少为 24x24 像素。
  • 键盘焦点:在交互式卡片组件中,保留可见的焦点指示环和逻辑 Tab 键遍历顺序。
  • 动态媒体替代文本:为合作伙伴提供的所有图片、缩略图、地图图钉和数据可视化图表提供描述性替代文本。
  • 实时状态通知 (aria-live):使用 aria-live="polite" 区域通知卡片内动态状态变化,例如展开“显示更多”行、过滤内容或完成内嵌操作。
  • 减少动画 (prefers-reduced-motion):通过将骨架闪烁效果和轮播滑动过渡替换为静态或即时状态更改,遵循用户的 prefers-reduced-motion 媒体查询。
  • 内容溢出和截断:将长文本块限制为 3-5 行,并提供无障碍的“阅读更多”操作,以防止布局破坏并保持可读性。