Diretrizes de design para apps conectados

Diretrizes para criar apps conectados em produtos do Google, como o app Gemini e a Pesquisa.

Visão geral

Um app conectado ao MCP permite que um usuário conecte um modelo de linguagem grande (LLM) em qualquer produto do Google aplicável para ler e gravar os dados do seu app. Como o app compartilha o contexto de conversação, os usuários podem concluir tarefas sem esforço, sem trocar de guia ou app. Leia estas diretrizes para garantir que seu app conectado seja aprovado para publicação nos produtos do Google aplicáveis.

Criar apps conectados

Quando usar os apps conectados

Crie apps conectados para os seguintes cenários:

  • Tarefas com início e fim claros, como fazer um pedido, uma reserva ou definir um horário.
  • Informações práticas que os usuários podem aplicar imediatamente.
  • Fluxos de trabalho de conversação naturais, como analisar dados, revisar documentos ou coordenar um projeto.
  • Funcionalidade principal que expande significativamente o que a IA pode fazer.

O ideal é que as ferramentas ajudem os usuários a concluir ações com a ajuda da IA, como fazer uma reserva ou escrever um documento. Foque em ações complexas em que o modelo de fundação pode simplificar o processo.

O que evitar

Ao projetar apps conectados, evite os seguintes padrões:

  • Menus suspensos, menus de contexto e painéis popover: esses elementos são cortados pelos limites do contêiner ou entram em conflito com a interface da plataforma host.
  • Rolagem aninhada: evite rolar dentro de um contêiner de rolagem.
  • Visualizações em várias camadas: não use navegação estrutural nem interfaces de detalhamento.
  • Processos longos: evite fluxos que excedam o escopo do modo de exibição.
  • Apps da Web independentes: não replique apps da Web completos.
  • Não cumprir a promessa: quando os usuários veem os apps conectados carregando, eles esperam um nível básico de utilidade. Não crie um app apenas para renderizar uma funcionalidade trivial, como um único botão.
  • Redirecionamentos automáticos: não abra sites externos ou apps nativos automaticamente sem um clique explícito do usuário em um link externo claramente marcado.

Contêiner e layout

Os contêineres de host mostram o app conectado ao lado das respostas do modelo. Esses contêineres oferecem atribuição de parceiros, bordas consistentes e dimensionamento responsivo em todos os produtos do Google aplicáveis.

Anatomia do contêiner

  1. Cabeçalho: mostra o ícone e o nome oficial do parceiro.
  2. Conteúdo: aparece como um card inline ou um carrossel horizontal.
  3. Pareamento de texto de resposta: os modos de exibição sempre acompanham o texto de resposta do modelo. Projete com base nesse layout combinado.
  4. Estilo da interface: herda os estilos do contêiner host em todos os produtos do Google aplicáveis.

Comportamento responsivo

Os apps conectados são renderizados em várias larguras de contêiner e janelas de visualização de dispositivos. Evite dimensões fixas:

  • Refluxo horizontal: use layouts flexíveis que se adaptam de forma limpa entre barras laterais compactas, telas de dispositivos móveis e feeds amplos para computadores sem corte horizontal.
  • Ajustar o conteúdo verticalmente: permita que os contêineres inline aumentem para se ajustar ao conteúdo até uma altura de leitura confortável. Nunca preencha os cards com espaço vazio fixo nem prenda o conteúdo em uma barra de rolagem vertical.
  • Respeite as entradas do dispositivo: ofereça suporte a gestos de toque nativos e áreas seguras em dispositivos móveis e estados de passagem do cursor em computadores.

O que evitar

  • Evite o padding duplo: os apps conectados incluem um padding interno padrão para atender aos padrões do sistema. Remova o padding extra do conteúdo interno para evitar espaçamento indesejado.
  • Evite raios de canto desequilibrados: mantenha as formas internas proporcionais ao raio de canto do contêiner host para evitar cantos excessivamente nítidos ou arredondados.
  • Evite adicionar seu próprio traço: os contêineres incluem um estilo de borda definido pelo sistema por padrão. Não aplique bordas ou traços extras ao redor de componentes internos.

Modos de exibição

Os modos de exibição definem como a extensão mostra a interface visual diretamente ao lado das respostas dos produtos do Google aplicáveis. Use um dos dois modos de exibição principais: cartão inline ou tela cheia.

Cards inline

Os cards inline são componentes leves e de finalidade única incorporados diretamente ao fluxo de resposta. Use cards inline para confirmações rápidas, inspeção de dados estruturados ou ações de etapa única.

Quando usar cards inline

  • Atualizações de status e confirmações.
  • Exibições ou seleções de dados simples.
  • Resumos breves com expansão opcional.
  • Ações rápidas que dão continuidade à conversa.

Proteções de densidade e truncamento de conteúdo

  • Fixação de títulos: limite os títulos dos cards a uma ou duas linhas com truncamento de reticências para que os cabeçalhos nunca ocultem as ações.
  • Limites de corpo e metadados: limite o texto de apoio a duas ou três linhas e os metadados por item a dois ou três atributos fáceis de ler.
  • Texto de CTA conciso: use rótulos de ação que comecem com verbos (por exemplo, "Reservar mesa" ou "Confirmar pedido") e limite o rodapé do card a no máximo uma CTA principal e uma ação secundária opcional.

Definição de carrossel: os carrosséis precisam ter entre 3 e 8 cards para justificar a rolagem sem causar cansaço, e todos os cards precisam ter as mesmas dimensões de altura e largura. Limite os títulos dos cards a uma ou duas linhas e os metadados a dois ou três campos por card.

Interações com cards inline

Os cards inline precisam se concentrar em ações rápidas e diretas que mantêm os usuários na conversa.

  • Ações inline: permitem que os usuários realizem ações diretamente no card, como editar texto, adicionar itens ou marcar tarefas como concluídas.
  • Atualizações de estado: reflita ações complexas do usuário diretamente na conversa, em vez de dentro da entidade. Por exemplo, quando um usuário reserva uma estadia, gere um card atualizado mostrando o rótulo "Reservado" na conversa.
  • Mecânica de passagem do cursor: os botões de ícone de navegação permanecem ocultos por padrão e aparecem quando o cursor passa sobre o contêiner.
  • Scrims de overflow: o estado inicial mostra o scrim da borda direita, o meio mostra as duas bordas e o final mostra a borda esquerda.
  • Gestos de toque: usa o gesto de deslizar horizontal nativo com espaço entre os cards do carrossel.
  • Visualização de cards: o estado inicial usa um padding à esquerda, o estado intermediário não tem nenhum e o estado final usa um padding à direita.

O que evitar em cards inline

  • Evite a rolagem aninhada: nunca inclua uma barra de rolagem vertical interna.
  • Evite detalhamento de várias visualizações: não use navegação estrutural, visualizações com várias guias e detalhamentos de várias etapas em um card inline. Mova fluxos complexos para a tela cheia.
  • Evite controles visíveis sobre menus: não use menus suspensos, popovers e menus de contexto, porque eles causam recorte de contêiner e colisões de Z-index.
  • Evite entradas duplicadas: não coloque outra entrada dentro do cartão, já que os produtos do Google aplicáveis já têm a entrada.
  • Evite a rolagem vertical interna: não coloque contêineres roláveis dentro de cards. Isso causa bloqueio de rolagem e prejudica a navegação em dispositivos móveis.
  • Evite popovers: como eles cobrem o conteúdo e poluem a interface, não use dicas ou sobreposições de popover para revelar detalhes importantes.
  • Evite menus suspensos: não oculte ações dentro de seletores suspensos. Exponha as ações principais como botões explícitos.
  • Evite ocultar o estouro de rolagem em carrosséis: garanta que o card adjacente apareça na visualização para que os usuários saibam que há mais conteúdo disponível para rolagem.
  • Evite componentes de erro personalizados: não use estados de erro personalizados. A IU do host vai fornecer um componente de erro padrão de forma consistente em toda a experiência.
  • Evite usar modais: os apps do MCP não oferecem suporte a modais. Se você precisar de mais espaço, ofereça uma opção para mudar para o modo de tela cheia.

Tela cheia

Use o modo de tela cheia como uma tela imersiva para tarefas ricas em várias etapas ou fluxos de trabalho com muitos dados que não cabem em um card inline.

Quando usar a tela cheia

  • Navegar por conteúdo denso, como anúncios imobiliários, menus ou mapas interativos.
  • Fluxos de trabalho complexos, como edição de telas ou diagramas que precisam de espaço dedicado além de um card inline.
  • Dados e análises, como visualização de painéis avançados, visualizações de dados e ferramentas de análise detalhadas que exigem atenção concentrada.

Layout e interações para tela cheia

  1. Cabeçalho: exibe uma barra de cabeçalho fornecida pelo sistema com atribuição e ações do app.
  2. Inserções de área segura: mantenha um espaçamento claro abaixo da barra de cabeçalho para evitar a sobreposição de conteúdo.
  3. Fechar e abrir: mostre um botão para abrir em tela cheia e um botão de fechar no cabeçalho da visualização em tela cheia.

O que evitar na tela cheia

  • Evite replicar seu app nativo: use a tela cheia para aumentar o engajamento em tarefas focadas e com várias etapas.
  • Evite entradas duplicadas: como os produtos do Google aplicáveis já têm a entrada, os parceiros não devem colocar outra entrada na visualização.
  • Evite painéis flutuantes: não use modais flutuantes ou barras de ferramentas de inspeção flutuantes arrastáveis, porque eles sobrecarregam a interface e colidem com as sobreposições da superfície do host.
  • Evite sobrepor áreas seguras: mantenha os elementos interativos longe da barra de ferramentas da plataforma host e dos indicadores do sistema, como as barras de status e inicial.

Diretrizes de interação

Como os usuários manipulam o conteúdo em um app conectado, como as ações são sincronizadas com a conversa do host e quando transferir fluxos de trabalho complexos para um app ou site externo.

Interface do app x divisão de trabalho da conversa

Crie seu app conectado e os comandos de conversação como camadas complementares:

  • Use a interface do app conectado para manipulação direta: use a interface para navegação espacial, como mover um mapa, comparar opções estruturadas, controles de formulário de vários campos e seleções visuais em que digitar comandos de texto seria tedioso ou ambíguo.
  • Use a conversa com o host para intenções abertas: use a conversa para acompanhamentos em linguagem natural, síntese em várias etapas e consultas exploratórias amplas.

Divulgação progressiva

  • Divulgação progressiva: comece com o modo de exibição mais compacto que atenda à necessidade do usuário (card inline ou carrossel), revelando detalhes secundários sob demanda (Mostrar mais) e escalando para tela cheia apenas quando uma exploração profunda for necessária.
  • Controles visíveis em vez de menus ocultos: exponha as ações principais como botões ou alternâncias explícitos, em vez de ocultá-las em barras de ferramentas que só aparecem ao passar o cursor, menus de contexto que aparecem ao clicar com o botão direito do mouse ou gestos de tocar e manter pressionado que não funcionam em janelas de visualização para dispositivos móveis.

Transferências externas e links para fora do app

Alguns recursos excedem o escopo de um iframe incorporado ou exigem recursos nativos de SO e hardware. Quando vincular ao seu app ou site:

  • Recursos nativos do SO ou dependentes de hardware (por exemplo, navegação em tempo real, captura de câmera ou sensor ou áudio em segundo plano contínuo e rastreamento de localização).
  • Fluxos regulamentados ou sensíveis à segurança (por exemplo, finalização de pagamento ou verificação de identidade).
  • Espaços de trabalho profundos além da tela cheia (por exemplo, pacotes de criação com todos os recursos ou painéis corporativos complexos).

Como projetar a transferência

  • Mostre uma indicação clara de link externo: sempre combine botões de transferência externa com um indicador de inicialização explícito (como o ícone open_in_new) e um rótulo específico do destino (por exemplo, "Abrir no Google Maps").
  • Link direto com contexto preservado: transmita todos os parâmetros estabelecidos na conversa para o URL do link direto usando a API de link externo do host (openLink) para que os usuários não precisem inserir novamente as seleções depois de trocar de app.

O que evitar

  • Evite redirecionamentos automáticos: nunca direcione os usuários para fora da superfície do host automaticamente. Sair da plataforma host precisa sempre exigir um clique explícito do usuário.
  • Evite cards de "teaser" ou que contenham apenas links: não crie um app conectado que sirva apenas para renderizar um banner ou botão estático que redirecione os usuários para seu site.
  • Evite mudanças de contexto não anunciadas: nunca estilize um link externo de forma idêntica a uma ação no card sem indicar que ele abre um app externo ou uma guia do navegador.

Diretrizes visuais

Os produtos do Google aplicáveis priorizam elementos de interface leves e neutros e contraste suavizado para reduzir a carga cognitiva.

Princípios visuais

Aplica princípios básicos de design para controlar a densidade visual e a estética em apps conectados:

  • Interface mais leve e minimalista: reduza traços e elementos de contêiner para manter uma densidade visual limpa.
  • Equilíbrio de cores neutras: priorize tons de cinza neutros, reservando cores de destaque para CTAs principais.
  • Elevação: aplique preenchimentos de superfície suaves, limitando as sombras projetadas exclusivamente ao modo de tela cheia e aos controles de navegação do carrossel.
  • Herança de estilo: aplique cores, tipografia e raios de canto para que os apps pareçam nativos em todos os produtos do Google aplicáveis.

Cor

Os produtos do Google aplicáveis organizam as cores em dois grupos funcionais: cores do sistema para o layout estrutural e cores de destaque para os momentos principais da marca. O uso dessas funções semânticas garante uma hierarquia visual clara e uma adaptação automática de tema em todos os produtos.

Funções de cor do sistema

Mapeie cores estruturais para funções de interface consistentes em todos os apps conectados:

  • Superfícies de plano de fundo: use cores de superfície neutras fornecidas pelo host para contêineres de cards e agrupamentos aninhados. Evite substituir os planos de fundo do contêiner por preenchimentos sólidos, gradientes ou padrões personalizados.
  • Hierarquia de texto e conteúdo: use cores de conteúdo primárias para títulos e valores-chave, tons secundários suaves para o corpo do texto e rótulos de suporte, e cores de status semânticas (positivo, aviso, crítico) para metadados operacionais.
  • Bordas e divisores: use cores de contorno sutis do sistema para bordas e divisores estruturais para separar o conteúdo sem adicionar peso visual.
  • Destaque principal: use o destaque do sistema ou a cor da marca do parceiro para os botões de call-to-action principais.

Áreas de aplicação da marca do parceiro

Oriente o posicionamento das cores da marca parceira nos apps conectados:

  • Recomendado: aplique as cores da marca de forma seletiva aos botões de CTA principais, logotipos e momentos de destaque.
  • Não recomendado: evite aplicar cores da marca a planos de fundo de cards, corpo de texto, títulos, bordas estruturais ou controles interativos secundários.

Tema e modo claro/escuro

Os apps conectados precisam ser consistentes nos temas claro e escuro, bem como nas paletas de superfície dinâmicas:

  • Use tokens semânticos em vez de valores hexadecimais estáticos: vincule superfícies, textos e bordas aos tokens de cor semânticos da superfície do host para que sua interface se adapte automaticamente entre os modos claro e escuro.
  • Adapte os detalhes da marca para os dois temas: garanta que a cor de destaque da sua marca mantenha um contraste acessível nos dois temas, oferecendo uma variante um pouco mais clara ou menos saturada no modo escuro se a cor padrão da marca parecer muito escura ou muito vibrante em superfícies escuras.
  • Use mídias e logotipos compatíveis com o tema: exporte ícones, logotipos e ilustrações com planos de fundo transparentes para que eles não mostrem caixas de limite brancas no modo escuro.

Ícones

Os apps conectados usam uma iconografia limpa e delineada para manter a harmonia visual e a legibilidade em todos os produtos do Google aplicáveis.

Estilo e tamanho do ícone

Oriente a geometria, a cor e os limites de tamanho dos ícones nos apps conectados:

  • Geometria arredondada e contornada: use ícones monocromáticos contornados com espessuras de traço uniformes e extremidades arredondadas (como os símbolos do Google Material Symbols Outlined) ou um conjunto de ícones de parceiros harmonizado que corresponda ao peso visual da interface do host.
  • Tonalidade neutra: use cores de conteúdo primárias ou secundárias, em vez de cores da marca, para colorir os ícones funcionais da interface. Assim, os ícones dão suporte à hierarquia de leitura sem competir com as CTAs primárias.
  • Limites de tamanho: mantenha os ícones entre 16 px (para metadados inline compactos) e 32 px (para cabeçalhos de cards ou recursos em destaque) para preservar a legibilidade e a proporção em todas as janelas de visualização.

Acessibilidade

Os produtos do Google aplicáveis seguem as diretrizes de acessibilidade alinhadas aos padrões das WCAG 2.1 AA e do Material Design 3.

Pilares de acessibilidade

  • Contraste de cores: aplique uma taxa de contraste mínima de 4,5:1 do WCAG AA para o texto em relação aos planos de fundo de superfície nos temas claro e escuro.
  • Tamanho mínimo do texto: aplica o tamanho de 13 pontos.
  • Áreas de toque: aplique um mínimo de 48 x 48 px para dispositivos móveis e 24 x 24 px para computadores na área interativa dos controles.
  • Foco do teclado: preserve um anel indicador de foco visível e uma ordem lógica de apresentação de guias em todos os componentes de card interativos.
  • Texto alternativo de mídia dinâmica: forneça um texto alternativo descritivo para todas as imagens, miniaturas, pins de mapa e visualizações de dados fornecidas pelo parceiro.
  • Anúncios de estado ativo (aria-live): use regiões aria-live="polite" para anunciar mudanças dinâmicas de estado no card, como expandir linhas de "Mostrar mais", filtrar itens ou concluir uma ação inline.
  • Movimento reduzido (prefers-reduced-motion): respeite a consulta de mídia prefers-reduced-motion do usuário substituindo os efeitos de brilho do esqueleto e as transições de slide do carrossel por mudanças de estado estáticas ou instantâneas.
  • Estouro e truncamento de conteúdo: limite blocos de texto longos a 3 a 5 linhas com uma ação acessível "Ler mais" para evitar quebras de layout e manter a legibilidade.