Consignes pour concevoir des applications connectées dans les produits Google tels que l'application Gemini et la recherche Google.
Présentation
Une application connectée MCP permet à un utilisateur de connecter un grand modèle de langage (LLM) sur n'importe quel produit Google applicable pour lire et écrire les données de votre application. Comme votre application partage le contexte de la conversation, les utilisateurs peuvent effectuer des tâches sans effort, sans changer d'onglet ni d'application. Consultez ces consignes pour vous assurer que votre application connectée est approuvée pour être diffusée sur les produits Google applicables.
Créer des applications connectées
Quand utiliser les Applis connectées
Créez des applications connectées pour les scénarios suivants :
- Tâches avec un début et une fin clairs, comme passer une commande, effectuer une réservation ou fixer un planning.
- Informations exploitables que les utilisateurs peuvent appliquer immédiatement.
- Workflows conversationnels naturels, comme l'analyse de données, l'examen de documents ou la coordination d'un projet.
- Fonctionnalité de base qui élargit considérablement les possibilités de l'IA.
Idéalement, vos outils doivent aider les utilisateurs à effectuer des actions à l'aide de l'IA, comme effectuer une réservation ou rédiger un document. Concentrez-vous sur les actions complexes pour lesquelles le modèle de fondation peut simplifier le processus.
À éviter
Lorsque vous concevez des applications connectées, évitez les modèles suivants :
- Menus déroulants, menus contextuels et panneaux popover : ces éléments sont tronqués par les limites du conteneur ou entrent en conflit avec l'interface utilisateur de la surface hôte.
- Défilement imbriqué : évitez de faire défiler un conteneur qui défile déjà.
- Vues multicouches : n'utilisez pas de fil d'Ariane ni d'interfaces d'exploration.
- Processus longs : évitez les flux qui dépassent le champ d'application du mode d'affichage.
- Applications Web autonomes : ne répliquez pas des applications Web complètes.
- Ne pas tenir ses promesses : lorsque les utilisateurs voient les applications connectées se charger, ils s'attendent à un niveau d'utilité de base. Ne créez pas d'application simplement pour afficher une fonctionnalité simple, comme un seul bouton.
- Redirections automatiques : ne lancez pas automatiquement de sites Web externes ni d'applications natives sans qu'un utilisateur ait explicitement cliqué sur un lien externe clairement indiqué.
Conteneur et mise en page
Les conteneurs hôtes encadrent votre application connectée ainsi que les réponses du modèle. Ces conteneurs fournissent l'attribution du partenaire, des bordures cohérentes et un dimensionnement responsif sur les produits Google applicables.
Anatomie du conteneur
- En-tête : affiche l'icône et le nom officiel du partenaire.
- Contenu : s'affiche sous la forme d'une fiche intégrée ou d'un carrousel horizontal.
- Association de texte de réponse : les modes d'affichage accompagnent toujours le texte de réponse du modèle. Concevez autour de cette mise en page combinée.
- Style de l'interface utilisateur : hérite des styles du conteneur hôte dans les produits Google applicables.
Comportement responsif
Les applications connectées s'affichent sur différentes largeurs de conteneur et fenêtres d'affichage d'appareil. Évitez les dimensions fixes :
- Reflow horizontal : utilisez des mises en page flexibles qui s'adaptent parfaitement aux barres latérales compactes, aux écrans mobiles et aux flux larges pour ordinateur sans coupure horizontale.
- Ajuster le contenu verticalement : permet aux conteneurs intégrés de s'agrandir pour s'adapter à leur contenu jusqu'à une hauteur de lecture confortable. Ne remplissez jamais les fiches avec un espace vide fixe et ne piégez pas le contenu dans une barre de défilement verticale.
- Respecter les entrées de l'appareil : prenez en charge les gestes tactiles natifs et les zones de sécurité sur mobile, ainsi que les états de pointage sur ordinateur.
À éviter
- Évitez le double padding : les applications connectées incluent un padding interne par défaut pour respecter les normes du système. Supprimez la marge intérieure supplémentaire du contenu interne pour éviter les espacements involontaires.
- Évitez les rayons d'angle déséquilibrés : gardez les formes internes proportionnelles au rayon d'angle du conteneur hôte pour éviter les angles trop nets ou arrondis.
- Évitez d'ajouter votre propre trait : les conteneurs incluent par défaut un style de bordure défini par le système. N'appliquez pas de bordures ou de traits supplémentaires autour des composants internes.
Modes d'affichage
Les modes d'affichage définissent la manière dont votre extension affiche l'UI visuelle directement à côté des réponses des produits Google applicables. Utilisez l'un des deux modes d'affichage principaux : carte intégrée ou plein écran.
Fiches intégrées
Les fiches intégrées sont des composants légers à usage unique intégrés directement dans le flux de réponse. Utilisez des fiches intégrées pour les confirmations rapides, l'inspection des données structurées ou les actions en une seule étape.
Quand utiliser des fiches intégrées ?
- Mises à jour de l'état et confirmations.
- Affichages ou sélections de données simples.
- Résumés courts avec possibilité de développement.
- Actions rapides qui poursuivent la conversation.
Densité du contenu et limites de troncature
- Limitation des titres : limitez les titres des fiches à une ou deux lignes avec des points de suspension pour que les en-têtes ne masquent jamais les actions.
- Limites du corps et des métadonnées : limitez le texte d'accompagnement à deux ou trois lignes, et les métadonnées par élément à deux ou trois attributs faciles à lire.
- Texte d'incitation à l'action concis : utilisez des libellés d'action commençant par un verbe (par exemple, "Réserver une table" ou "Confirmer la commande") et limitez le pied de page de la fiche à un incitation à l'action principale et une action secondaire facultative au maximum.
Définition du carrousel : les carrousels doivent contenir entre trois et huit fiches pour justifier le défilement sans fatiguer l'utilisateur. Toutes les fiches doivent avoir la même hauteur et la même largeur. Limitez les titres des fiches à une ou deux lignes, et les métadonnées à deux ou trois champs par fiche.
Interactions pour les fiches intégrées
Les fiches intégrées doivent se concentrer sur des actions rapides et directes qui maintiennent les utilisateurs dans la conversation.
- Actions intégrées : permettez aux utilisateurs d'effectuer des actions directement dans la fiche, comme modifier du texte, ajouter des éléments ou cocher des tâches.
- Mises à jour d'état : reflétez les actions complexes des utilisateurs directement dans le fil de discussion plutôt que dans l'entité. Par exemple, lorsqu'un utilisateur réserve un séjour, générez une fiche mise à jour affichant le libellé "Réservé" dans la conversation.
Navigation dans le carrousel sur ordinateur
- Mécanisme de survol : les boutons d'icône de navigation restent masqués par défaut et s'affichent lorsque l'utilisateur pointe sur le conteneur.
- Voiles de dépassement : l'état de début affiche le voile du bord droit, l'état du milieu affiche les deux bords et l'état de fin affiche le bord gauche.
Expérience sur mobile du carrousel
- Gestes tactiles : utilise le balayage horizontal natif avec un espace entre les fiches du carrousel.
- Aperçu de la carte : l'état de début utilise une marge intérieure gauche, l'état du milieu n'en utilise aucune et l'état de fin utilise une marge intérieure droite.
À éviter pour les fiches intégrées
- Évitez le défilement imbriqué : n'incluez jamais de barre de défilement verticale interne.
- Évitez l'exploration multivue : n'utilisez pas de fil d'Ariane, de vues multi-onglets ni d'explorations en plusieurs étapes dans une fiche intégrée. Déplacez les flux complexes en plein écran.
- Évitez les commandes visibles sur les menus : n'utilisez pas de menus déroulants, de popovers ni de menus contextuels, car ils provoquent un écrêtage du conteneur et des collisions d'index Z.
- Évitez les entrées en double : ne placez pas d'autre entrée dans la carte, car les produits Google concernés disposent déjà de l'entrée.
- Évitez le défilement vertical interne : ne placez pas de conteneurs à défilement dans les fiches, car cela peut entraîner un blocage du défilement et dégrader la navigation sur mobile.
- Évitez les popovers : comme ils couvrent le contenu et encombrent l'interface utilisateur, n'utilisez pas d'info-bulles ni de superpositions de popovers pour révéler des détails importants.
- Évitez les menus déroulants : ne masquez pas les actions dans des sélecteurs déroulants. Exposez les actions principales sous forme de boutons explicites.
- Évitez de masquer le dépassement de défilement dans les carrousels : assurez-vous que la fiche adjacente est visible pour que les utilisateurs sachent qu'ils peuvent faire défiler la page pour afficher plus de contenu.
- Évitez les composants d'erreur personnalisés : n'utilisez pas d'états d'erreur personnalisés. L'UI hôte fournira un composant d'erreur standard de manière cohérente tout au long de l'expérience.
- Évitez d'utiliser des fenêtres modales : les applications MCP ne sont pas compatibles avec les fenêtres modales. Si vous avez besoin de plus d'espace, proposez plutôt une option permettant de passer en mode plein écran.
Plein écran
Utilisez le mode plein écran comme canevas immersif pour les tâches riches en plusieurs étapes ou les workflows contenant beaucoup de données qui ne peuvent pas être contenus dans une fiche intégrée.
Quand utiliser le mode plein écran
- Parcourir des contenus denses tels que des annonces immobilières, des menus ou des cartes interactives.
- Workflows complexes, tels que la modification de canevas ou de diagrammes nécessitant un espace dédié au-delà d'une fiche intégrée.
- Données et analyses, telles que l'affichage de tableaux de bord enrichis, de visualisations de données et d'outils d'analyse détaillés nécessitant une attention particulière.
Mise en page et interactions pour le plein écran
- En-tête : affiche une barre d'en-tête fournie par le système avec l'attribution et les actions de l'application.
- Marges de la zone de sécurité : laissez un espace suffisant sous la barre d'en-tête pour éviter que le contenu ne se chevauche.
- Fermer et ouvrir : affiche un bouton pour ouvrir en plein écran et un bouton de fermeture dans l'en-tête de la vue plein écran.
À éviter pour le plein écran
- Évitez de reproduire votre application native : utilisez le plein écran pour renforcer l'engagement sur des tâches ciblées en plusieurs étapes.
- Évitez les entrées en double : étant donné que les produits Google concernés disposent déjà de l'entrée, les partenaires ne doivent pas en placer une autre dans la vue.
- Évitez les panneaux flottants : n'utilisez pas de fenêtres modales flottantes ni de barres d'outils d'inspection déplaçables flottantes, car elles encombrent l'interface et entrent en conflit avec les superpositions de la surface hôte.
- Évitez de chevaucher les zones de sécurité : tenez les éléments interactifs à l'écart de la barre d'outils de la surface hôte et des indicateurs système, tels que les barres d'état et la barre d'accueil.
Consignes d'interaction
Comment les utilisateurs manipulent le contenu dans une application connectée, comment les actions se synchronisent avec la conversation hôte et quand transférer des workflows complexes vers une application ou un site Web externe.
Interface utilisateur de l'application par rapport à la division du travail de conversation
Concevez votre application connectée et vos requêtes de conversation comme des couches complémentaires :
- Utilisez l'UI de l'application connectée pour une manipulation directe : utilisez l'UI pour la navigation spatiale, par exemple pour faire un panoramique sur une carte, comparer des options structurées, utiliser des commandes de formulaire à plusieurs champs et effectuer des sélections visuelles, lorsque la saisie de prompts textuels serait fastidieuse ou ambiguë.
- Utiliser la conversation hôte pour une intention ouverte : utilisez la conversation pour les suivis en langage naturel, la synthèse en plusieurs étapes et les requêtes exploratoires générales.
Dévoilement progressif
- Divulgation progressive : commencez par le mode d'affichage le plus compact qui répond aux besoins de l'utilisateur (fiche intégrée ou carrousel), en révélant les détails secondaires à la demande ("Afficher plus") et en passant au plein écran uniquement lorsqu'une exploration approfondie est nécessaire.
- Commandes visibles plutôt que menus masqués : affichez les actions principales sous forme de boutons ou de boutons d'activation/désactivation explicites plutôt que de les masquer dans des barres d'outils qui ne s'affichent qu'au passage de la souris, des menus contextuels accessibles par clic droit ou des gestes d'appui prolongé qui ne fonctionnent pas sur les fenêtres d'affichage mobiles.
Transferts externes et liens vers l'extérieur
Certaines fonctionnalités dépassent le champ d'application d'un iFrame intégré ou nécessitent des fonctionnalités matérielles et d'OS natives. Quand rediriger les utilisateurs vers votre application ou votre site :
- Fonctionnalités dépendantes de l'OS natif ou du matériel (par exemple, navigation en direct, capture par l'appareil photo ou un capteur, ou suivi continu de l'audio et de la position en arrière-plan).
- Flux réglementés ou sensibles à la sécurité (par exemple, paiement final ou validation de l'identité).
- Espaces de travail profonds au-delà du plein écran (par exemple, suites de création complètes ou tableaux de bord d'entreprise complexes).
Concevoir le transfert
- Afficher un affordance de lien externe clair : associez toujours les boutons de transfert externe à un indicateur de lancement explicite (comme l'icône
open_in_new) et à un libellé spécifique à la destination (par exemple, "Ouvrir dans Google Maps"). - Lien profond avec contexte préservé : transmettez tous les paramètres établis dans la conversation à l'URL du lien profond via l'API de lien externe de l'hôte (
openLink) afin que les utilisateurs n'aient jamais à saisir à nouveau leurs sélections après avoir changé d'application.
À éviter
- Évitez les redirections automatiques : ne redirigez jamais automatiquement les utilisateurs hors de la surface hôte. Pour quitter la surface hôte, l'utilisateur doit toujours cliquer explicitement.
- Évitez les fiches "teaser" ou contenant uniquement des liens : ne créez pas d'application connectée dont le seul but est d'afficher une bannière ou un bouton statique qui redirige les utilisateurs vers votre site Web.
- Évitez les changements de contexte inopinés : ne stylisez jamais un lien externe de la même manière qu'une action dans la fiche sans indiquer qu'il ouvre une application externe ou un onglet de navigateur.
Charte graphique
Les produits Google concernés privilégient les éléments d'interface utilisateur légers et neutres, ainsi qu'un contraste adouci pour réduire la charge cognitive.
Principes visuels
Applique les principes de conception de base pour régir la densité visuelle et l'esthétique dans les applications connectées :
- UI plus légère et minimaliste : réduisez les traits et les éléments de conteneur pour maintenir une densité visuelle épurée.
- Équilibre des couleurs neutres : privilégiez les nuances de gris neutres et réservez les couleurs d'accentuation aux incitations à l'action principales.
- Élévation : appliquez des remplissages de surface doux, en limitant les ombres portées exclusivement au mode plein écran et aux commandes de navigation du carrousel.
- Héritage de style : appliquez des couleurs, une typographie et des rayons d'angle pour que les applications s'intègrent de manière native à tous les produits Google applicables.
Couleur
Les produits Google concernés organisent les couleurs en deux groupes fonctionnels : les couleurs système pour la mise en page structurelle et les couleurs d'accentuation pour les moments clés de la marque. L'utilisation de ces rôles sémantiques garantit une hiérarchie visuelle claire et une adaptation automatique du thème dans tous les produits.
Rôles des couleurs système
Mappez les couleurs structurelles à des rôles d'UI cohérents dans les applications connectées :
- Surfaces d'arrière-plan : utilisez les couleurs de surface neutres fournies par l'hôte pour les conteneurs de fiches et les regroupements imbriqués. Évitez de remplacer les arrière-plans des conteneurs par des remplissages unis, des dégradés ou des motifs personnalisés.
- Hiérarchie du texte et du contenu : utilisez les couleurs de contenu principales pour les titres et les valeurs clés, des tons secondaires atténués pour le corps du texte et les libellés secondaires, et des couleurs d'état sémantiques (positif, avertissement, critique) pour les métadonnées opérationnelles.
- Bordures et séparateurs : utilisez des couleurs de contour système subtiles pour les bordures et les séparateurs structurels afin de séparer le contenu sans ajouter de poids visuel important.
- Accentuation principale : utilisez l'accentuation du système ou la couleur de votre marque partenaire pour les boutons d'incitation à l'action principaux.
Domaines d'application de la marque du partenaire
Guide de placement des couleurs de la marque partenaire dans les applications connectées :
- Recommandation : Appliquez les couleurs de la marque de manière sélective aux boutons d'incitation à l'action principaux, aux logos et aux moments clés.
- Non recommandé : évitez d'appliquer les couleurs de la marque aux arrière-plans des fiches, au corps du texte, aux titres, aux bordures structurelles ou aux commandes interactives secondaires.
Thèmes et modes clair/sombre
Les applications connectées doivent être cohérentes entre les thèmes clair et sombre, ainsi qu'avec les palettes de surfaces dynamiques :
- Utilisez des jetons sémantiques plutôt que des valeurs hexadécimales statiques : associez les surfaces, le texte et les bordures aux jetons de couleur sémantiques de la surface hôte afin que votre interface s'adapte automatiquement aux modes clair et sombre.
- Adaptez les accents de la marque pour les deux thèmes : assurez-vous que la couleur d'accentuation de votre marque conserve un contraste accessible dans les deux thèmes. Fournissez une variante légèrement plus claire ou désaturée en mode sombre si la couleur par défaut de votre marque apparaît trop sombre ou trop vive sur les surfaces sombres.
- Utilisez des contenus multimédias et des logos compatibles avec les thèmes : exportez les icônes, les logos et les illustrations avec des arrière-plans transparents afin qu'ils n'affichent pas de cadres de délimitation blancs en mode sombre.
Icônes
Les applications connectées utilisent une iconographie claire et épurée pour maintenir l'harmonie visuelle et la lisibilité dans les produits Google concernés.
Style et taille des icônes
Seuils de géométrie, de couleur et de taille des icônes de guide dans les applications connectées :
- Géométrie arrondie et contours : utilisez des icônes monochromes avec des contours d'épaisseur uniforme et des extrémités arrondies (comme les symboles Google Material Outlined) ou un ensemble d'icônes de partenaire harmonisé qui correspond au poids visuel de l'interface hôte.
- Teinte neutre : teintez les icônes fonctionnelles de l'interface utilisateur à l'aide de couleurs de contenu primaires ou secondaires plutôt que de couleurs de marque, afin que les icônes respectent la hiérarchie de lecture sans entrer en concurrence avec les incitations à l'action principales.
- Limites de taille : conservez les icônes entre 16 px (pour les métadonnées intégrées compactes) et 32 px (pour les en-têtes de fiche ou de fonctionnalité proéminents) afin de préserver la lisibilité et les proportions sur les fenêtres d'affichage.
Accessibilité
Les produits Google concernés appliquent des normes d'accessibilité conformes aux normes WCAG 2.1 AA et Material Design 3.
Piliers fondamentaux de l'accessibilité
- Contraste des couleurs : appliquez un rapport de contraste WCAG AA d'au moins 4,5:1 pour le texte sur les arrière-plans des thèmes clair et sombre.
- Taille de texte minimale : applique une taille de police de 13 pt.
- Cibles tactiles : appliquez une taille minimale de 48 x 48 px pour les mobiles et de 24 x 24 px pour les ordinateurs pour la zone cible interactive des commandes.
- Focus clavier : conservez un anneau d'indicateur de focus visible et un ordre de balayage logique des composants de carte interactifs.
- Texte alternatif dynamique pour les contenus multimédias : fournissez un texte alternatif descriptif pour toutes les images, miniatures, repères sur la carte et visualisations de données fournis par le partenaire.
- Annonces d'état en direct (
aria-live) : utilisez les régionsaria-live="polite"pour annoncer les changements d'état dynamiques dans la fiche, comme le développement des lignes "Afficher plus", le filtrage des éléments ou l'exécution d'une action intégrée. - Mouvement réduit (
prefers-reduced-motion) : respectez la requête médiaprefers-reduced-motionde l'utilisateur en remplaçant les effets de scintillement du squelette et les transitions de diapositives du carrousel par des changements d'état statiques ou instantanés. - Débordement et troncature du contenu : limitez les longs blocs de texte à trois à cinq lignes avec une action "En savoir plus" accessible pour éviter de casser la mise en page et maintenir la lisibilité.