Linee guida per la progettazione di app connesse nei prodotti Google, come l'app Gemini e la Ricerca.
Panoramica
Un'app connessa a MCP consente a un utente di connettere un modello linguistico di grandi dimensioni (LLM) su qualsiasi prodotto Google applicabile per leggere e scrivere i dati della tua app. Poiché la tua app condivide il contesto della conversazione, gli utenti possono completare facilmente le attività senza cambiare scheda o app. Consulta queste linee guida per assicurarti che la tua app connessa sia approvata per la pubblicazione sui prodotti Google applicabili.
Crea app connesse
Quando utilizzare le App connesse
Crea App connesse per i seguenti scenari:
- Attività con un inizio e una fine chiari, come l'invio di un ordine, la prenotazione o la conferma di un appuntamento.
- Informazioni utili che gli utenti possono applicare immediatamente.
- Flussi di lavoro conversazionali naturali, come l'analisi dei dati, la revisione di documenti o il coordinamento di un progetto.
- Funzionalità di base che espandono in modo significativo le capacità dell'AI.
Idealmente, i tuoi strumenti dovrebbero aiutare gli utenti a completare azioni con l'aiuto dell'AI, ad esempio effettuare una prenotazione o scrivere un documento. Concentrati su azioni complesse in cui il modello di base può semplificare il processo.
Cose da evitare
Quando progetti app connesse, evita i seguenti pattern:
- Menu a discesa, menu contestuali e riquadri popover: questi elementi vengono tagliati dai confini del contenitore o entrano in conflitto con l'interfaccia utente della piattaforma host.
- Scorrimento nidificato: evita lo scorrimento all'interno di un contenitore di scorrimento.
- Visualizzazioni multilivello: non utilizzare breadcrumb o interfacce di drill-in.
- Processi lunghi: evita flussi che superano l'ambito della modalità di visualizzazione.
- App web autonome: non replicare app web complete.
- Mancato rispetto della promessa: quando gli utenti vedono il caricamento delle app connesse, si aspettano un livello di utilità di base. Non creare un'app solo per eseguire il rendering di una funzionalità banale, come un singolo pulsante.
- Reindirizzamenti automatici: non avviare automaticamente siti web esterni o app native senza un clic esplicito dell'utente su un link esterno chiaramente contrassegnato.
Contenitore e layout
I container host inquadrano l'app connessa insieme alle risposte del modello. Questi contenitori forniscono l'attribuzione del partner, bordi coerenti e dimensioni adattabili nei prodotti Google applicabili.
Anatomia del contenitore
- Intestazione: mostra l'icona e il nome ufficiale del partner.
- Contenuti: vengono visualizzati come scheda in linea o carosello orizzontale.
- Abbinamento del testo della risposta: le modalità di visualizzazione accompagnano sempre il testo della risposta del modello. Progetta tenendo conto di questo layout combinato.
- Stile UI: eredita gli stili del contenitore host nei prodotti Google applicabili.
Comportamento adattabile
Le app connesse vengono visualizzate in diverse larghezze dei container e finestre di visualizzazione dei dispositivi. Evita dimensioni fisse:
- Adatta i contenuti in orizzontale: utilizza layout flessibili che si adattano perfettamente a barre laterali compatte, schermi di dispositivi mobili e feed desktop ampi senza ritagli orizzontali.
- Adatta i contenuti verticalmente: consenti ai contenitori in linea di espandersi per adattarsi ai contenuti fino a un'altezza di lettura confortevole. Non riempire mai le schede con spazi vuoti fissi o contenuti intrappolati in una barra di scorrimento verticale.
- Rispetta gli input del dispositivo: supporta i gesti di tocco nativi e le aree sicure sui dispositivi mobili e gli stati di passaggio del mouse sui computer.
Cose da evitare
- Evita il doppio padding: le app connesse includono un padding interno predefinito per soddisfare gli standard di sistema. Rimuovi il padding aggiuntivo dai contenuti interni per evitare spaziature indesiderate.
- Evita un raggio dell'angolo sbilanciato: mantieni le forme interne proporzionali al raggio dell'angolo del container host per evitare angoli eccessivamente arrotondati o appuntiti.
- Evita di aggiungere un tratto personalizzato: i contenitori includono lo stile del bordo definito dal sistema per impostazione predefinita. Non applicare bordi o tratti aggiuntivi intorno ai componenti interni.
Modalità di visualizzazione
Le modalità di visualizzazione definiscono il modo in cui l'estensione mostra l'UI visiva direttamente accanto alle risposte dei prodotti Google applicabili. Utilizza una delle due modalità di visualizzazione principali: scheda incorporata o schermo intero.
Schede in linea
Le schede in linea sono componenti leggeri e con un unico scopo, incorporati direttamente nel flusso di risposta. Utilizza le schede incorporate per conferme rapide, ispezione dei dati strutturati o azioni in un unico passaggio.
Quando utilizzare le schede incorporate
- Aggiornamenti di stato e conferme.
- Visualizzazioni o selezioni di dati semplici.
- Brevi riepiloghi con espansione facoltativa.
- Azioni rapide che continuano la conversazione.
Misure di sicurezza per la densità e il troncamento dei contenuti
- Limitazione dei titoli: limita i titoli delle schede a 1-2 righe con troncamento con puntini di sospensione, in modo che le intestazioni non nascondano mai le azioni.
- Limiti per il corpo e i metadati: limita il testo di supporto a 2-3 righe e i metadati per elemento a 2-3 attributi scansionabili.
- Testo della CTA conciso: utilizza etichette di azione che iniziano con un verbo (ad esempio, "Prenota un tavolo" o "Conferma l'ordine") e limita il piè di pagina della scheda a un massimo di una CTA principale e un'azione secondaria facoltativa.
Definizione di carosello: i caroselli devono contenere tra 3 e 8 schede per giustificare lo scorrimento senza causare affaticamento, con tutte le schede che mantengono dimensioni di altezza e larghezza identiche. Limita i titoli delle schede a 1-2 righe e i metadati a 2-3 campi per scheda.
Interazioni per le schede in linea
Le schede in linea devono concentrarsi su azioni rapide e dirette che mantengono gli utenti nella conversazione.
- Azioni in linea: consentono agli utenti di eseguire azioni direttamente all'interno della scheda, ad esempio modificare il testo, aggiungere elementi o spuntare le attività.
- Aggiornamenti dello stato: rifletti le azioni complesse degli utenti direttamente nel thread anziché all'interno dell'entità. Ad esempio, quando un utente prenota un soggiorno, genera una scheda aggiornata che mostra l'etichetta "Prenotato" nella conversazione.
Navigazione carosello per computer
- Meccanica di passaggio del mouse: i pulsanti delle icone di navigazione rimangono nascosti per impostazione predefinita e vengono visualizzati quando passi il mouse sopra il contenitore.
- Scrim di overflow: lo stato iniziale mostra lo scrim del bordo destro, lo stato intermedio mostra entrambi i bordi e lo stato finale mostra il bordo sinistro.
Esperienza mobile con il carosello
- Gesti tattili: utilizza lo scorrimento orizzontale nativo con uno spazio tra le schede del carosello.
- Visualizzazione parziale della scheda: lo stato iniziale utilizza un padding a sinistra, quello centrale non ne ha e quello finale utilizza un padding a destra.
Cosa evitare per le schede incorporate
- Evita lo scorrimento nidificato: non includere mai una barra di scorrimento verticale interna.
- Evita l'esplorazione con più visualizzazioni: non utilizzare i breadcrumb, le visualizzazioni con più schede e i drill-down in più passaggi non sono consentiti all'interno di una scheda in linea. Sposta i flussi complessi a schermo intero.
- Evita i controlli visibili sui menu: non utilizzare menu a discesa, popover e menu contestuali, in quanto causano il ritaglio del contenitore e conflitti di z-index.
- Evita input duplicati: non inserire un altro input nella scheda, poiché i prodotti Google applicabili lo hanno già.
- Evita lo scorrimento verticale interno: non inserire contenitori scorrevoli all'interno delle schede, in quanto ciò causa il blocco dello scorrimento e peggiora la navigazione mobile.
- Evita i popover: poiché coprono i contenuti e ingombrano la UI, non utilizzare tooltip o overlay popover per mostrare dettagli chiave.
- Evita i menu a discesa: non nascondere le azioni all'interno dei selettori a discesa. Mostra le azioni principali come pulsanti espliciti.
- Evita di nascondere l'overflow di scorrimento nei caroselli: assicurati che la scheda adiacente sia visibile, in modo che gli utenti sappiano che sono disponibili altri contenuti da scorrere.
- Evita componenti di errore personalizzati: non utilizzare stati di errore personalizzati. L'UI host fornirà un componente di errore standard in modo coerente in tutta l'esperienza.
- Evita di utilizzare finestre modali: le app MCP non supportano le finestre modali. Se hai bisogno di più spazio, offri un'opzione per passare alla modalità a schermo intero.
Schermo intero
Utilizza la modalità a schermo intero come canvas immersivo per attività complesse in più passaggi o flussi di lavoro con molti dati che non possono essere contenuti in una scheda in linea.
Quando utilizzare lo schermo intero
- Navigazione di contenuti densi come annunci immobiliari, menu o mappe interattive.
- Flussi di lavoro complessi, come la modifica di canvas o diagrammi che richiedono uno spazio dedicato oltre a una scheda incorporata.
- Dati e analisi, come la visualizzazione di dashboard dettagliate, visualizzazioni di dati e strumenti di analisi dettagliati che richiedono un'attenzione mirata.
Layout e interazioni per lo schermo intero
- Intestazione: mostra una barra dell'intestazione fornita dal sistema con l'attribuzione e le azioni dell'app.
- Inset dell'area sicura: mantieni uno spazio libero sotto la barra dell'intestazione per evitare la sovrapposizione dei contenuti.
- Chiusura e apertura: mostra un pulsante per l'apertura a schermo intero e un pulsante di chiusura nell'intestazione della visualizzazione a schermo intero.
Cosa evitare per lo schermo intero
- Evita di replicare la tua app nativa: utilizza lo schermo intero per aumentare il coinvolgimento su attività mirate in più passaggi.
- Evita input duplicati: poiché i prodotti Google applicabili hanno già l'input, i partner non devono inserire un altro input all'interno della visualizzazione.
- Evita i riquadri mobili: non utilizzare finestre modali mobili o barre degli strumenti di ispezione trascinabili mobili, in quanto ingombrano l'interfaccia e si scontrano con gli overlay della superficie host.
- Evita di sovrapporre le aree sicure: tieni gli elementi interattivi lontani dalla barra degli strumenti della piattaforma host e dagli indicatori di sistema, come le barre di stato e la barra Home.
Linee guida per l'interazione
In che modo gli utenti manipolano i contenuti all'interno di un'app connessa, in che modo le azioni si sincronizzano con la conversazione host e quando trasferire workflow complessi a un'app o un sito web esterno.
Divisione del lavoro tra UI dell'app e conversazione
Progetta l'app connessa e i prompt conversazionali come livelli complementari:
- Utilizza la UI dell'app connessa per la manipolazione diretta: utilizza la UI per la navigazione spaziale, ad esempio per spostarti su una mappa, confrontare opzioni strutturate, controlli dei moduli con più campi e selezioni visive in cui la digitazione di prompt testuali sarebbe noiosa o ambigua.
- Utilizza la conversazione host per intenti aperti: utilizza la conversazione per follow-up in linguaggio naturale, sintesi in più passaggi e query esplorative ampie.
Divulgazione progressiva
- Divulgazione progressiva: inizia con la modalità di visualizzazione più compatta che risponde alle esigenze dell'utente (scheda o carosello in linea), rivelando i dettagli secondari on demand (Mostra altro) e passando allo schermo intero solo quando è necessaria un'esplorazione approfondita.
- Controlli visibili rispetto ai menu nascosti: esponi le azioni principali come pulsanti o opzioni di attivazione/disattivazione espliciti anziché nasconderle all'interno di barre degli strumenti di tipo hover-only, menu contestuali con tasto destro del mouse o gesti di pressione prolungata che non funzionano nelle aree visibili dei dispositivi mobili.
Handoff esterni e link in uscita
Alcune funzionalità superano l'ambito di un iframe incorporato o richiedono funzionalità hardware e del sistema operativo native. Quando inserire link alla tua app o al tuo sito:
- Funzionalità del sistema operativo nativo o dipendenti dall'hardware (ad esempio, navigazione in tempo reale, acquisizione di immagini o sensori o monitoraggio continuo della posizione e dell'audio in background).
- Flussi regolamentati o sensibili alla sicurezza (ad esempio, il pagamento finale o la verifica dell'identità).
- Aree di lavoro profonde oltre lo schermo intero (ad esempio, suite di creazione complete o dashboard aziendali complesse).
Progettazione dell'handoff
- Mostra un affordance chiaro per i link esterni: associa sempre i pulsanti di handoff esterni a un indicatore di avvio esplicito (ad esempio l'icona
open_in_new) e a un'etichetta specifica per la destinazione (ad esempio "Apri in Google Maps"). - Deep link con contesto conservato: passa tutti i parametri stabiliti nella conversazione all'URL del deep link tramite l'API per link esterni dell'host (
openLink) in modo che gli utenti non debbano mai reinserire le loro selezioni dopo aver cambiato app.
Cose da evitare
- Evita i reindirizzamenti automatici: non indirizzare mai gli utenti fuori dalla piattaforma host automaticamente. L'uscita dalla piattaforma host deve sempre richiedere un clic esplicito dell'utente.
- Evita le schede "teaser" o di soli link: non creare un'app connessa il cui unico scopo è mostrare un banner o un pulsante statico che reindirizza gli utenti al tuo sito web.
- Evita cambi di contesto non annunciati: non applicare mai a un link esterno uno stile identico a quello di un'azione nella scheda senza indicare che apre un'app esterna o una scheda del browser.
Indicazioni per l'aspetto visivo
I prodotti Google applicabili danno priorità a elementi UI leggeri e neutri e a un contrasto attenuato per ridurre il carico cognitivo.
Principi visivi
Applica i principi di progettazione fondamentali per gestire la densità visiva e l'estetica nelle app connesse:
- UI più leggera e minimalista: riduci i tratti e gli elementi contenitore per mantenere una densità visiva pulita.
- Bilanciamento dei colori neutri: dai la priorità alle tonalità di grigio neutro, riservando i colori intensi alle CTA principali.
- Elevazione: applica riempimenti di superficie morbidi, limitando le ombre esclusivamente alla modalità a schermo intero e ai controlli di navigazione del carosello.
- Eredità dello stile: applica colori, tipografia e raggi degli angoli in modo che le app sembrino native in ogni prodotto Google applicabile.
Colore
I prodotti Google applicabili organizzano i colori in due gruppi funzionali: colori di sistema per il layout strutturale e colori intensi per i momenti principali del brand. L'utilizzo di questi ruoli semantici garantisce una gerarchia visiva chiara e un adattamento automatico del tema tra i prodotti.
Ruoli dei colori di sistema
Mappa i colori strutturali a ruoli della UI coerenti nelle app connesse:
- Superfici di sfondo: utilizza i colori neutri della superficie forniti dall'host per i contenitori delle schede e i raggruppamenti nidificati. Evita di sostituire gli sfondi dei container con riempimenti a tinta unita, gradienti o pattern personalizzati.
- Gerarchia di testo e contenuti: utilizza i colori dei contenuti principali per i titoli e i valori chiave, i toni secondari tenui per il corpo del testo e le etichette di supporto e i colori di stato semantici (positivo, avviso, critico) per i metadati operativi.
- Bordi e divisori: utilizza colori di contorno del sistema discreti per i bordi e i divisori strutturali per separare i contenuti senza aggiungere un peso visivo eccessivo.
- Colore principale: utilizza il colore del sistema o del brand partner per i pulsanti call to action principali.
Aree di applicazione del brand dei partner
Guida al posizionamento dei colori del brand partner nelle app connesse:
- Consigliato: applica i colori del brand in modo selettivo ai pulsanti CTA principali, ai loghi e ai momenti chiave.
- Sconsigliato: evita di applicare i colori del brand agli sfondi delle schede, al corpo del testo, ai titoli, ai bordi strutturali o ai controlli interattivi secondari.
Tema e modalità Luce/Buio
Le app connesse devono avere un aspetto coerente sia con i temi chiaro e scuro sia con le tavolozze dinamiche delle piattaforme:
- Utilizza i token semantici anziché i valori esadecimali statici: associa superfici, testo e bordi ai token di colore semantici della superficie host in modo che l'interfaccia si adatti automaticamente alle modalità Luce e Buio.
- Adatta i colori intensi del brand per entrambi i temi: assicurati che il colore intenso del brand mantenga un contrasto accessibile in entrambi i temi, fornendo una variante leggermente più chiara o desaturata in modalità Buio se il colore predefinito del brand appare troppo scuro o eccessivamente vivace su superfici scure.
- Utilizza contenuti multimediali e loghi compatibili con i temi: esporta icone, loghi e illustrazioni con sfondi trasparenti in modo che non vengano visualizzati riquadri di delimitazione bianchi in modalità Buio.
Icone
Le App connesse utilizzano un'iconografia chiara e delineata per mantenere l'armonia visiva e la leggibilità nei prodotti Google applicabili.
Stile e dimensioni delle icone
Soglie di geometria, colore e dimensioni delle icone della guida nelle app connesse:
- Geometria arrotondata e con contorni: utilizza icone monocromatiche con contorni con spessori dei tratti uniformi e estremità arrotondate (ad esempio Google Material Symbols Outlined) o un set di icone partner armonizzato che corrisponda al peso visivo dell'interfaccia host.
- Tonalità neutre: colora le icone funzionali della UI utilizzando i colori dei contenuti principali o secondari anziché i colori del brand, in modo che le icone supportino la gerarchia di lettura senza competere con le CTA principali.
- Limiti di dimensioni: mantieni le icone tra 16 px (per i metadati in linea compatti) e 32 px (per le intestazioni di schede o funzionalità in evidenza) per preservare la leggibilità e le proporzioni nelle varie aree visibili.
Accessibilità
I prodotti Google applicabili impongono la conformità dell'accessibilità in linea con gli standard WCAG 2.1 AA e Material Design 3.
Pilastri fondamentali dell'accessibilità
- Contrasto dei colori: applica un rapporto di contrasto WCAG AA minimo di 4,5:1 per il testo rispetto agli sfondi delle superfici nei temi Chiaro e Scuro.
- Dimensioni del testo minime: applica una dimensione del carattere di 13 pt.
- Touch target: applica un'area target interattiva minima di 48 x 48 px per i dispositivi mobili e di 24 x 24 px per i computer per i controlli.
- Selezione della tastiera: mantieni un anello indicatore di selezione visibile e un ordine di attraversamento logico dei tasti di tabulazione tra i componenti interattivi della scheda.
- Testo alternativo dinamico per i contenuti multimediali: fornisci un testo alternativo descrittivo per tutte le immagini, le miniature, i segnaposto sulla mappa e le visualizzazioni dei dati forniti dai partner.
- Annunci di stato in tempo reale (
aria-live): utilizza le regioniaria-live="polite"per annunciare modifiche dinamiche dello stato della scheda, ad esempio l'espansione delle righe "Mostra altro", il filtraggio degli elementi o il completamento di un'azione in linea. - Movimento ridotto (
prefers-reduced-motion): rispetta la query supportiprefers-reduced-motiondell'utente sostituendo gli effetti di shimmer dello scheletro e le transizioni delle slide del carosello con modifiche di stato statiche o istantanee. - Overflow e troncamento dei contenuti: limita i blocchi di testo lunghi a 3-5 righe con un'azione "Leggi di più" accessibile per evitare interruzioni del layout e mantenere la leggibilità.