Lineamientos para diseñar apps conectadas en productos de Google, como la app de Gemini y la Búsqueda.
Descripción general
Una app conectada con MCP permite que un usuario conecte un modelo de lenguaje grande (LLM) en cualquier producto de Google aplicable para leer y escribir los datos de tu app. Como tu app comparte el contexto de la conversación, los usuarios pueden completar tareas sin esfuerzo y sin cambiar de pestaña ni de app. Revisa estos lineamientos para asegurarte de que tu app conectada se apruebe para publicarse en los productos de Google aplicables.
Crea apps conectadas
Cuándo usar las Apps conectadas
Crea apps conectadas para las siguientes situaciones:
- Tareas con un principio y un final claros, como realizar un pedido, hacer una reserva o fijar un horario.
- Información práctica que los usuarios pueden aplicar de inmediato.
- Flujos de trabajo conversacionales naturales, como analizar datos, revisar documentos o coordinar un proyecto.
- Funcionalidad principal que expande de manera significativa lo que la IA puede lograr.
Lo ideal es que tus herramientas ayuden a los usuarios a completar acciones con la ayuda de la IA, como hacer una reserva o escribir un documento. Enfócate en acciones complejas en las que el modelo de base pueda simplificar el proceso.
Qué evitar
Cuando diseñes apps conectadas, evita los siguientes patrones:
- Menús desplegables, menús contextuales y paneles emergentes: Estos elementos se recortan por los límites del contenedor o entran en conflicto con la IU de la plataforma host.
- Desplazamiento anidado: Evita desplazarte dentro de un contenedor de desplazamiento.
- Vistas de varias capas: No uses rutas de navegación ni interfaces de desglose.
- Procesos largos: Evita los flujos que excedan el alcance del modo de visualización.
- Apps web independientes: No repliques apps web completas.
- No cumplir con la promesa: Cuando los usuarios ven que se cargan las apps conectadas, esperan un nivel básico de utilidad. No crees una app solo para renderizar una funcionalidad trivial, como un solo botón.
- Redireccionamientos automáticos: No lances sitios web externos ni aplicaciones nativas automáticamente sin que el usuario haga clic de forma explícita en un vínculo externo claramente marcado.
Contenedor y diseño
Los contenedores de host enmarcan tu app conectada junto con las respuestas del modelo. Estos contenedores proporcionan atribución de socios, bordes coherentes y tamaños responsivos en los productos de Google aplicables.
Anatomía del contenedor
- Encabezado: Muestra el ícono y el nombre oficial del socio.
- Contenido: Aparece como una tarjeta intercalada o un carrusel horizontal.
- Vinculación de texto de respuesta: Los modos de visualización siempre acompañan al texto de respuesta del modelo. Diseña en torno a este diseño combinado.
- Estilo de la IU: Hereda los estilos del contenedor de host en los productos de Google aplicables.
Comportamiento responsivo
Las apps conectadas se renderizan en diferentes anchos de contenedores y viewports de dispositivos. Evita las dimensiones fijas:
- Ajuste horizontal: Usa diseños flexibles que se adapten de forma limpia entre barras laterales compactas, pantallas de dispositivos móviles y feeds de escritorio amplios sin recortes horizontales.
- Ajustar el contenido verticalmente: Permite que los contenedores intercalados crezcan para ajustarse a su contenido hasta una altura de lectura cómoda. Nunca rellenes las tarjetas con espacio vacío fijo ni encierres el contenido en una barra de desplazamiento vertical.
- Respeta las entradas del dispositivo: Admite gestos táctiles nativos y áreas seguras en dispositivos móviles, y estados de desplazamiento en computadoras de escritorio.
Qué evitar
- Evita el padding doble: Las apps conectadas incluyen un padding interno predeterminado para cumplir con los estándares del sistema. Quita el padding adicional del contenido interno para evitar espacios no deseados.
- Evita el radio de esquina desequilibrado: Mantén las formas internas proporcionales al radio de esquina del contenedor host para evitar esquinas demasiado nítidas o redondeadas.
- Evita agregar tu propio trazo: Los contenedores incluyen un estilo de borde definido por el sistema de forma predeterminada. No apliques bordes ni trazos adicionales alrededor de los componentes internos.
Modos de visualización
Los modos de visualización definen cómo tu extensión muestra la IU visual directamente junto con las respuestas de los productos de Google aplicables. Usa uno de los dos modos de visualización principales: tarjeta intercalada o pantalla completa.
Tarjetas intercaladas
Las tarjetas intercaladas son componentes ligeros de un solo propósito que se incorporan directamente en el flujo de respuesta. Usa tarjetas intercaladas para confirmaciones rápidas, inspección de datos estructurados o acciones de un solo paso.
Cuándo usar tarjetas intercaladas
- Actualizaciones de estado y confirmaciones
- Visualizaciones o selecciones de datos simples.
- Resúmenes breves con expansión opcional
- Acciones rápidas que continúan la conversación
Límites de densidad y truncamiento del contenido
- Fijación de títulos: Limita los títulos de las tarjetas a 1 o 2 líneas con truncamiento de puntos suspensivos para que los encabezados nunca oculten las acciones.
- Límites de cuerpo y metadatos: Limita el texto de apoyo a 2 o 3 líneas y los metadatos por elemento a 2 o 3 atributos que se puedan leer con facilidad.
- Texto de CTA conciso: Usa etiquetas de acción que comiencen con un verbo (por ejemplo, "Reservar mesa" o "Confirmar pedido") y limita el pie de página de la tarjeta a, como máximo, 1 CTA principal y 1 acción secundaria opcional.
Definición de carrusel: Los carruseles deben contener entre 3 y 8 tarjetas para justificar el desplazamiento sin causar fatiga, y todas las tarjetas deben mantener dimensiones idénticas de altura y ancho. Limita los títulos de las tarjetas a 1 o 2 líneas y los metadatos a 2 o 3 campos por tarjeta.
Interacciones para tarjetas intercaladas
Las tarjetas intercaladas deben enfocarse en acciones rápidas y directas que mantengan a los usuarios en la conversación.
- Acciones intercaladas: Permiten que los usuarios realicen acciones directamente dentro de la tarjeta, como editar texto, agregar elementos o marcar tareas.
- Actualizaciones de estado: Refleja las acciones complejas del usuario directamente en el subproceso en lugar de dentro de la entidad. Por ejemplo, cuando un usuario reserva una estadía, genera una tarjeta actualizada que muestre la etiqueta "Reservado" en la conversación.
Navegación por el carrusel en computadoras
- Mecánica de desplazamiento: Los botones de íconos de navegación permanecen ocultos de forma predeterminada y se revelan cuando se coloca el cursor sobre el contenedor.
- Pantallas de desbordamiento: El estado de inicio muestra la pantalla del borde derecho, el estado intermedio muestra ambos bordes y el estado final muestra el borde izquierdo.
Experiencia móvil del carrusel
- Gestos táctiles: Usa el deslizamiento horizontal nativo con espacio entre las tarjetas del carrusel.
- Visualización de tarjetas: El estado inicial usa un padding izquierdo, el estado intermedio no tiene ninguno y el estado final usa un padding derecho.
Qué evitar en las tarjetas intercaladas
- Evita el desplazamiento anidado: Nunca incluyas una barra de desplazamiento vertical interna.
- Evita el desglose de varias vistas: No uses rutas de navegación, vistas de varias pestañas ni desgloses de varios pasos dentro de una tarjeta intercalada. Mueve los flujos complejos a pantalla completa.
- Evita los controles visibles sobre los menús: No uses menús desplegables, ventanas emergentes ni menús contextuales, ya que causan recortes de contenedores y colisiones de índice Z.
- Evita las entradas duplicadas: No coloques otra entrada dentro de la tarjeta, ya que los productos de Google aplicables ya tienen la entrada.
- Evita el desplazamiento vertical interno: No coloques contenedores desplazables dentro de las tarjetas, ya que esto provoca un bloqueo del desplazamiento y degrada la navegación en dispositivos móviles.
- Evita los popovers: Como cubren el contenido y desordenan la IU, no uses cuadros de información ni superposiciones de popovers para revelar detalles clave.
- Evita los menús desplegables: No ocultes acciones dentro de los selectores desplegables. Expón las acciones principales como botones explícitos.
- Evita ocultar el desbordamiento de desplazamiento en los carruseles: Asegúrate de que la tarjeta adyacente se asome en la vista para que los usuarios sepan que hay más contenido disponible para desplazarse.
- Evita los componentes de error personalizados: No uses estados de error personalizados. La IU del host proporcionará un componente de error estándar de manera coherente en toda la experiencia.
- Evita usar modales: Las apps de MCP no admiten modales. Si necesitas más espacio, proporciona una opción para cambiar al modo de pantalla completa.
Pantalla completa
Usa el modo de pantalla completa como un lienzo envolvente para tareas enriquecidas de varios pasos o flujos de trabajo con muchos datos que no se pueden incluir en una tarjeta intercalada.
Cuándo usar la pantalla completa
- Explorar contenido denso, como fichas de bienes raíces, menús o mapas interactivos
- Flujos de trabajo complejos, como editar lienzos o diagramas que necesitan un espacio dedicado más allá de una tarjeta intercalada.
- Datos y análisis, como la visualización de paneles enriquecidos, visualizaciones de datos y herramientas de análisis detalladas que requieren atención enfocada.
Diseño e interacciones para pantalla completa
- Encabezado: Muestra una barra de encabezado proporcionada por el sistema con la atribución y las acciones de la app.
- Inserciones de área segura: Mantén un espacio libre debajo de la barra de encabezado para evitar que se superponga el contenido.
- Cerrar y abrir: Muestra un botón para abrir en pantalla completa y un botón para cerrar en el encabezado de la vista de pantalla completa.
Qué evitar en la pantalla completa
- Evita replicar tu aplicación nativa: Usa la pantalla completa para aumentar la interacción en tareas enfocadas de varios pasos.
- Evita las entradas duplicadas: Dado que los productos de Google aplicables ya tienen la entrada, los socios no deben colocar otra entrada dentro de la vista.
- Evita los paneles flotantes: No uses modales flotantes ni barras de herramientas de inspector arrastrables flotantes, ya que desordenan la interfaz y colisionan con las superposiciones de la superficie del host.
- Evita superponer áreas seguras: Mantén los elementos interactivos alejados de la barra de herramientas de la plataforma de hosting y de los indicadores del sistema, como las barras de estado y de inicio.
Lineamientos de interacción
Cómo los usuarios manipulan el contenido dentro de una app conectada, cómo se sincronizan las acciones con la conversación del organizador y cuándo transferir flujos de trabajo complejos a una app o un sitio web externos.
División del trabajo entre la IU de la app y la conversación
Diseña tu app conectada y las instrucciones conversacionales como capas complementarias:
- Usa la IU de la app conectada para la manipulación directa: Usa la IU para la navegación espacial, como desplazarse por un mapa, comparar opciones estructuradas, controles de formularios de varios campos y selecciones visuales en las que escribir instrucciones de texto sería tedioso o ambiguo.
- Usa la conversación del host para la intención abierta: Usa la conversación para los seguimientos en lenguaje natural, la síntesis de varios pasos y las consultas exploratorias amplias.
Divulgación progresiva
- Divulgación progresiva: Comienza con el modo de visualización más compacto que responda a la necesidad del usuario (tarjeta intercalada o carrusel), revela los detalles secundarios a pedido (Mostrar más) y escala a pantalla completa solo cuando se requiera una exploración profunda.
- Controles visibles sobre menús ocultos: Expón las acciones principales como botones o interruptores explícitos en lugar de ocultarlas dentro de barras de herramientas que solo se muestran cuando se coloca el cursor sobre ellas, menús contextuales que se abren al hacer clic con el botón derecho o gestos de mantener presionado que no funcionan en las ventanas de visualización de dispositivos móviles.
Transferencias externas y vinculación externa
Algunas funciones exceden el alcance de un iframe incorporado o requieren funciones nativas del SO y del hardware. Cuándo vincular a tu app o sitio:
- Funciones nativas del SO o que dependen del hardware (por ejemplo, navegación en vivo, captura de cámara o sensor, o seguimiento continuo de audio y ubicación en segundo plano)
- Flujos regulados o sensibles para la seguridad (por ejemplo, confirmación de pago final o verificación de identidad).
- Espacios de trabajo profundos más allá de la pantalla completa (por ejemplo, suites de creación con todas las funciones o paneles empresariales complejos)
Diseña la transferencia
- Muestra una indicación clara de vínculo externo: Siempre vincula los botones de transferencia externa con un indicador de inicio explícito (como el ícono
open_in_new) y una etiqueta específica del destino (por ejemplo, "Abrir en Google Maps"). - Vínculo directo con contexto preservado: Pasa todos los parámetros establecidos en la conversación a la URL del vínculo directo a través de la API de vínculo externo del host (
openLink) para que los usuarios nunca tengan que volver a ingresar sus selecciones después de cambiar de app.
Qué evitar
- Evita los redireccionamientos automáticos: Nunca dirijas a los usuarios fuera de la plataforma de hosting de forma automática. Para salir de la plataforma de hosting, siempre se debe requerir un clic explícito del usuario.
- Evita las tarjetas de "avance" o de solo vínculos: No crees una app conectada cuyo único propósito sea renderizar un banner o un botón estáticos que redirijan a los usuarios a tu sitio web.
- Evita los cambios de contexto sin previo aviso: Nunca apliques un estilo a un vínculo externo de forma idéntica a una acción en la tarjeta sin indicar que abre una app externa o una pestaña del navegador.
Lineamientos visuales
Los productos de Google aplicables priorizan los elementos de la IU ligeros y neutros, y el contraste suavizado para reducir la carga cognitiva.
Principios visuales
Aplica principios de diseño fundamentales para controlar la densidad visual y la estética en las apps conectadas:
- IU más ligera y minimalista: Reduce los trazos y los elementos de contenedor para mantener una densidad visual limpia.
- Equilibrio de colores neutros: Prioriza los tonos grises neutros y reserva los colores de los elementos destacados para los CTA principales.
- Elevación: Aplica rellenos de superficie suaves y limita las sombras paralelas exclusivamente al modo de pantalla completa y a los controles de navegación del carrusel.
- Herencia de estilo: Aplica colores, tipografía y radios de esquina para que las apps se sientan nativas en todos los productos de Google aplicables.
Color
Los productos de Google aplicables organizan el color en dos grupos funcionales: colores del sistema para el diseño estructural y colores de los elementos destacados para los momentos principales de la marca. Confiar en estos roles semánticos garantiza una jerarquía visual clara y una adaptación automática del tema en todos los productos.
Roles de color del sistema
Asigna colores estructurales a roles de IU coherentes en las apps conectadas:
- Superficies de fondo: Usa los colores de superficie neutros que proporciona el host para los contenedores de tarjetas y las agrupaciones anidadas. Evita anular los fondos de los contenedores con rellenos sólidos, gradientes o patrones personalizados.
- Jerarquía de texto y contenido: Usa colores de contenido principales para los títulos y los valores clave, tonos secundarios atenuados para el cuerpo del texto y las etiquetas de apoyo, y colores de estado semánticos (positivo, advertencia, crítico) para los metadatos operativos.
- Bordes y divisores: Usa colores sutiles del sistema para los bordes y divisores estructurales para separar el contenido sin agregar un peso visual excesivo.
- Color de los elementos destacados principal: Usa el color de los elementos destacados del sistema o el color de la marca de tu socio para los botones principales de llamado a la acción.
Áreas de aplicación de la marca del socio
Guía para la ubicación de los colores de la marca del socio en las apps conectadas:
- Recomendación: Aplica los colores de la marca de forma selectiva a los botones de CTA principales, los logotipos y los momentos destacados clave.
- No recomendado: Evita aplicar colores de la marca a los fondos de las tarjetas, el texto del cuerpo, los títulos, los bordes estructurales o los controles interactivos secundarios.
Temas y modo claro/oscuro
Las apps conectadas deben verse coherentes tanto en los temas claro y oscuro como en las paletas de colores dinámicos:
- Usa tokens semánticos en lugar de valores hexadecimales estáticos: Vincula superficies, texto y bordes a los tokens de color semánticos de la superficie del host para que tu interfaz se adapte automáticamente entre los modos claro y oscuro.
- Adapta los elementos destacados de la marca para ambos temas: Asegúrate de que el color de los elementos destacados de tu marca mantenga un contraste accesible en ambos temas. Para ello, proporciona una variante un poco más clara o menos saturada en el modo oscuro si el color predeterminado de tu marca se ve demasiado oscuro o muy vibrante en superficies oscuras.
- Usa contenido multimedia y logotipos compatibles con el tema: Exporta íconos, logotipos e ilustraciones con fondos transparentes para que no muestren cuadros delimitadores blancos en el modo oscuro.
Íconos
Las apps conectadas usan iconografía limpia y delineada para mantener la armonía visual y la legibilidad en los productos de Google aplicables.
Estilo y tamaño de los íconos
Guía sobre los umbrales de geometría, color y tamaño de los íconos en las apps conectadas:
- Geometría redondeada y con contorno: Usa íconos monocromáticos con contorno, con grosores de trazo uniformes y extremos redondeados (como los símbolos de Material de Google con contorno) o un conjunto de íconos de socios armonizados que coincidan con el peso visual de la interfaz del host.
- Matiz neutro: Aplica matices a los íconos funcionales de la IU con colores de contenido primarios o secundarios, en lugar de colores de la marca, para que los íconos admitan la jerarquía de lectura sin competir con los CTA principales.
- Límites de tamaño: Mantén los íconos entre 16 px (para metadatos intercalados compactos) y 32 px (para encabezados de tarjetas o funciones destacados) para preservar la legibilidad y la proporción en los viewports.
Accesibilidad
Los productos de Google aplicables aplican el cumplimiento de la accesibilidad de acuerdo con los estándares de WCAG 2.1 AA y Material Design 3.
Pilares fundamentales de la accesibilidad
- Contraste de color: Aplica una relación de contraste mínima de 4.5:1 de WCAG AA para el texto en comparación con los fondos de superficie en los temas claro y oscuro.
- Tamaño mínimo del texto: Aplica un tamaño de letra de 13 puntos.
- Objetivos táctiles: Aplica un área de objetivo interactivo mínima de 48 × 48 px para dispositivos móviles y de 24 × 24 px para computadoras de escritorio para los controles.
- Enfoque del teclado: Conserva un anillo indicador de enfoque visible y un orden de recorrido de pestañas lógico en los componentes de tarjetas interactivas.
- Texto alternativo de contenido multimedia dinámico: Proporciona texto alternativo descriptivo para todas las imágenes, miniaturas, pines de mapa y visualizaciones de datos que proporcione el socio.
- Anuncios de estado en vivo (
aria-live): Usa regionesaria-live="polite"para anunciar cambios de estado dinámicos en la tarjeta, como expandir las filas de "Mostrar más", filtrar elementos o completar una acción intercalada. - Movimiento reducido (
prefers-reduced-motion): Respeta la consulta de mediosprefers-reduced-motiondel usuario reemplazando los efectos de brillo de esqueleto y las transiciones de diapositivas del carrusel por cambios de estado estáticos o instantáneos. - Desbordamiento y truncamiento de contenido: Limita los bloques de texto largos a 3 o 5 líneas con una acción accesible de "Leer más" para evitar que se rompa el diseño y mantener la legibilidad.