Рекомендации по дизайну для подключенных приложений

Рекомендации по разработке подключенных приложений для продуктов Google, таких как приложение Gemini и Поиск.

Обзор

Приложение, подключенное к MCP, позволяет пользователю подключить большую языковую модель (LLM) к любому подходящему продукту Google, чтобы читать и записывать данные вашего приложения. Поскольку приложение передает контекст разговора, пользователи могут легко выполнять задачи, не переключаясь между вкладками или приложениями. Ознакомьтесь с этими рекомендациями, чтобы убедиться, что ваше подключенное приложение одобрено для использования в соответствующих продуктах Google.

Как создать подключенное приложение

Когда использовать подключенные приложения

Создавайте подключенные приложения для следующих сценариев:

  • Задачи с четким началом и концом, такие как размещение заказа, бронирование или составление расписания.
  • Практическая информация, которую пользователи могут применить немедленно.
  • Естественные диалоговые рабочие процессы, такие как анализ данных, проверка документов или координация проекта.
  • Основные функции, которые значительно расширяют возможности ИИ.

В идеале ваши инструменты должны помогать пользователям выполнять действия с помощью ИИ, например бронировать билеты или писать документы. Сосредоточьтесь на сложных действиях, которые можно упростить с помощью базовой модели.

Чего следует избегать

При разработке подключенных приложений избегайте следующих шаблонов:

  • Раскрывающиеся списки, контекстные меню и всплывающие панели. Эти элементы обрезаются границами контейнера или конфликтуют с интерфейсом хоста.
  • Вложенная прокрутка. Избегайте прокрутки внутри контейнера с прокруткой.
  • Многоуровневые представления. Не используйте навигационные цепочки и интерфейсы с детализацией.
  • Длительные процессы. Избегайте процессов, которые выходят за рамки режима отображения.
  • Отдельные веб-приложения. Не копируйте веб-приложения полностью.
  • Неоправданные ожидания. Когда пользователи видят, что приложение загружается, они ожидают, что оно будет работать. Не создавайте приложения, которые выполняют только простые действия, например содержат одну кнопку.
  • Автоматическая переадресация. Не запускайте внешние сайты или нативные приложения автоматически, без явного нажатия пользователем на четко обозначенную внешнюю ссылку.

Контейнер и макет

Контейнеры хоста обрамляют подключенное приложение и ответы модели. Эти контейнеры обеспечивают атрибуцию партнеров, единообразные границы и адаптивный размер в поддерживаемых продуктах Google.

Анатомия контейнера

  1. Заголовок. Значок и официальное название партнера.
  2. Контент. Показывается в виде встроенной карточки или горизонтальной карусели.
  3. Сочетание с текстом ответа. Режимы отображения всегда сопровождаются текстом ответа модели. Разрабатывайте дизайн с учетом этого комбинированного макета.
  4. Стиль интерфейса. Наследует стили родительского контейнера во всех поддерживаемых продуктах Google.

Адаптивное поведение

Подключенные приложения могут отображаться в контейнерах разной ширины и на экранах разных устройств. Не используйте фиксированные размеры.

  • Горизонтальное перекомпонование. Используйте гибкие макеты, которые легко адаптируются к компактным боковым панелям, экранам мобильных устройств и широким лентам на компьютерах без горизонтального кадрирования.
  • Вертикальное выравнивание. Позволяет увеличивать встроенные контейнеры до высоты, удобной для чтения. Не добавляйте на карточки фиксированное пустое пространство и не помещайте контент в вертикальную полосу прокрутки.
  • Учитывайте особенности устройств. Поддерживайте нативные жесты и безопасные области на мобильных устройствах, а также состояния при наведении указателя мыши на компьютерах.

Чего следует избегать

  • Избегайте двойных полей. В подключенных приложениях есть внутренние поля по умолчанию, которые соответствуют системным стандартам. Удалите лишние поля из внутреннего контента, чтобы избежать нежелательных пробелов.
  • Избегайте несбалансированного радиуса углов. Сохраняйте пропорции внутренних фигур относительно радиуса углов основного контейнера, чтобы избежать слишком острых или закругленных углов.
  • Не добавляйте собственную обводку. По умолчанию контейнеры включают системный стиль границ. Не добавляйте дополнительные границы или штрихи вокруг внутренних компонентов.

Режимы отображения

Режимы отображения определяют, как расширение показывает визуальный интерфейс непосредственно рядом с ответами соответствующих продуктов Google. Используйте один из двух основных режимов отображения: встроенная карточка или полноэкранный режим.

Встроенные подсказки

Встроенные карточки – это простые одноцелевые компоненты, встроенные непосредственно в поток ответов. Используйте встроенные карточки для быстрого подтверждения, проверки структурированных данных или одноэтапных действий.

Когда использовать встроенные карточки

  • Обновления статуса и подтверждения.
  • Простые экраны для просмотра или выбора данных.
  • Краткие сводки с возможностью развернуть.
  • Быстрые действия, которые продолжают разговор.

Плотность контента и ограничения на усечение

  • Ограничение длины заголовков. Ограничьте длину заголовков карточек одной-двумя строками с многоточием в конце, чтобы заголовки не скрывали кнопки действий.
  • Ограничения на текст и метаданные. Ограничьте текст 2–3 строками, а метаданные – 2–3 атрибутами.
  • Краткий призыв к действию. Используйте глаголы в начале призыва к действию (например, "Забронировать столик" или "Подтвердить заказ"). В нижнем колонтитуле карточки должен быть только один основной призыв к действию и одно необязательное дополнительное действие.

Определение карусели. Карусель должна содержать от 3 до 8 карточек, чтобы прокрутка была оправданной, но не утомляла пользователя. Все карточки должны иметь одинаковую высоту и ширину. Название карточки должно занимать не более двух строк, а метаданные – не более трех полей.

Взаимодействие со встроенными подсказками

Встроенные карточки должны быть ориентированы на быстрые и прямые действия, которые не отвлекают пользователей от разговора.

  • Встроенные действия. Позволяют пользователям выполнять действия непосредственно в карточке, например редактировать текст, добавлять элементы или отмечать задачи.
  • Обновления статуса. Отражайте сложные действия пользователей непосредственно в цепочке, а не внутри объекта. Например, когда пользователь бронирует номер, создайте обновленную карточку с пометкой "Забронировано" в чате.
  • Наведение указателя. Кнопки навигации по умолчанию скрыты и появляются при наведении указателя на контейнер.
  • Полупрозрачные наложения. В начале наложение отображается у правого края, в середине – у обоих краев, а в конце – у левого края.
  • Жесты. Используется стандартный горизонтальный жест пролистывания с промежутком между карточками карусели.
  • Просмотр карточек. В начальном состоянии используется отступ слева, в среднем – отступы отсутствуют, а в конечном – используется отступ справа.

Чего следует избегать при создании встроенных карточек

  • Избегайте вложенной прокрутки. Не добавляйте внутреннюю вертикальную полосу прокрутки.
  • Не используйте многоуровневую навигацию. Встроенные карточки не должны содержать хлебные крошки, несколько вкладок и многоуровневую навигацию. Перенесите сложные процессы в полноэкранный режим.
  • Не используйте видимые элементы управления поверх меню. Не добавляйте раскрывающиеся списки, всплывающие окна и контекстные меню, поскольку они могут привести к обрезке контейнера и конфликтам z-индекса.
  • Избегайте дублирования. Не размещайте в карточке ещё одно поле ввода, поскольку оно уже есть в продуктах Google.
  • Избегайте внутренней вертикальной прокрутки. Не размещайте прокручиваемые контейнеры внутри карточек. Это может привести к блокировке прокрутки и ухудшить навигацию на мобильных устройствах.
  • Не используйте всплывающие окна. Они закрывают контент и загромождают интерфейс. Не используйте подсказки и всплывающие окна для показа важной информации.
  • Не используйте раскрывающиеся меню. Не прячьте действия в раскрывающихся списках. Основные действия должны быть представлены в виде кнопок.
  • Не скрывайте полосу прокрутки в каруселях. Убедитесь, что соседняя карточка видна, чтобы пользователи знали, что контент можно прокручивать.
  • Не используйте собственные компоненты ошибок. В интерфейсе хоста есть стандартный компонент ошибок, который используется во всех сценариях.
  • Не используйте модальные окна. Приложения MCP не поддерживают модальные окна. Если вам нужно больше места, добавьте возможность переключиться в полноэкранный режим.

Полноэкранный режим

Используйте полноэкранный режим для сложных многоэтапных задач или рабочих процессов с большим объемом данных, которые не помещаются во встроенной карточке.

Когда использовать полноэкранный режим

  • Просмотр плотного контента, такого как списки недвижимости, меню или интерактивные карты.
  • Сложные рабочие процессы, например редактирование холстов или диаграмм, для которых требуется отдельное пространство за пределами встроенной карточки.
  • Данные и анализ, например просмотр информативных панелей, визуализаций данных и подробных аналитических инструментов, требующих сосредоточенного внимания.

Макет и взаимодействие в полноэкранном режиме

  1. Заголовок. Показывает заголовок, предоставленный системой, с атрибуцией приложения и действиями.
  2. Вставки в безопасной области. Оставляйте свободное пространство под панелью заголовка, чтобы контент не перекрывался.
  3. Закрыть и открыть. Показывает кнопку для открытия в полноэкранном режиме и кнопку закрытия в заголовке полноэкранного режима.

Чего следует избегать при создании полноэкранных объявлений

  • Не копируйте нативное приложение. Используйте полноэкранный режим, чтобы повысить вовлеченность пользователей при выполнении многоэтапных задач.
  • Избегайте дублирования. Поскольку в продуктах Google уже есть поле ввода, партнерам не нужно добавлять ещё одно.
  • Не используйте плавающие панели. Не используйте плавающие модальные окна или плавающие перетаскиваемые панели инструментов инспектора, так как они загромождают интерфейс и конфликтуют с оверлеями хоста.
  • Избегайте перекрытия безопасных областей. Не размещайте интерактивные элементы на панели инструментов хоста и системных индикаторах, таких как строка состояния и панель главного экрана.

Правила взаимодействия

Как пользователи управляют контентом в подключенном приложении, как действия синхронизируются с чатом и когда нужно передавать сложные рабочие процессы внешнему приложению или сайту.

Разделение задач между интерфейсом приложения и чатом

Разрабатывайте подключенное приложение и подсказки для разговора как дополняющие друг друга уровни:

  • Используйте интерфейс подключенного приложения для прямого управления. Используйте интерфейс для пространственного просмотра, например панорамирования карты, сравнения структурированных вариантов, элементов управления многополевыми формами и визуального выбора, когда ввод текстовых подсказок был бы утомительным или неоднозначным.
  • Используйте чат для открытых запросов. Чат подходит для уточняющих вопросов на естественном языке, многоэтапного синтеза и широких исследовательских запросов.

Постепенное развитие

  • Постепенное раскрытие. Начните с самого компактного режима отображения, который отвечает потребностям пользователя (встроенная карточка или карусель), показывая второстепенные детали по запросу ("Показать больше") и переходя к полноэкранному режиму только тогда, когда требуется глубокое изучение.
  • Видимые элементы управления вместо скрытых меню. Основные действия должны быть представлены в виде явных кнопок или переключателей, а не скрыты внутри панелей инструментов, доступных только при наведении курсора, контекстных меню, вызываемых нажатием правой кнопки мыши, или жестов долгого нажатия, которые не работают на мобильных устройствах.

Перенаправление на внешние ресурсы и ссылки на них

Некоторые возможности выходят за рамки встроенного элемента iframe или требуют использования функций ОС и аппаратного обеспечения. Когда нужно добавлять ссылку на приложение или сайт:

  • Функции, зависящие от ОС или аппаратного обеспечения, например навигация в реальном времени, съемка на камеру, запись с датчиков, непрерывное воспроизведение аудио в фоновом режиме или отслеживание местоположения.
  • Регулируемые или конфиденциальные процессы, например оплата или подтверждение личности.
  • Рабочие области, которые не помещаются на одном экране (например, полнофункциональные пакеты для разработки или сложные корпоративные панели управления).

Создание набора для разработчиков

  • Добавьте понятный индикатор внешней ссылки. Кнопки перехода на внешний ресурс должны сопровождаться явным индикатором запуска (например, значком open_in_new) и меткой с указанием места назначения (например, "Открыть в Google Картах").
  • Ссылка на контент с сохранением контекста. Передавайте все параметры, установленные в разговоре, в URL ссылки на контент через API внешних ссылок хоста (openLink), чтобы пользователям не приходилось повторно вводить выбранные параметры после переключения приложений.

Чего следует избегать

  • Избегайте автоматических перенаправлений. Никогда не перенаправляйте пользователей с хост-платформы автоматически. Для перехода с основной страницы на целевую всегда требуется явный клик пользователя.
  • Не создавайте карточки-тизеры или карточки, содержащие только ссылки. Не создавайте подключенные приложения, единственная цель которых – показывать статический баннер или кнопку, перенаправляющую пользователей на ваш сайт.
  • Избегайте неожиданных переходов. Не оформляйте внешние ссылки так же, как действия в карточке, если не указываете, что они открывают внешнее приложение или вкладку браузера.

Рекомендации для визуальных элементов

В продуктах Google используются простые нейтральные элементы интерфейса и мягкий контраст, чтобы снизить когнитивную нагрузку.

Принципы визуального дизайна

Применяет основные принципы дизайна для управления визуальной плотностью и эстетикой в подключенных приложениях:

  • Более легкий и минималистичный интерфейс. Уменьшите количество штрихов и элементов контейнера, чтобы сохранить визуальную плотность.
  • Нейтральный цветовой баланс. Отдавайте предпочтение нейтральным серым оттенкам, а акцентные цвета используйте для основных призывов к действию.
  • Высота. Применяйте мягкие заливки поверхностей, ограничивая тени исключительно полноэкранным режимом и элементами управления каруселью.
  • Наследование стилей. Применяйте цвета, шрифты и радиусы углов, чтобы приложения выглядели нативно во всех подходящих продуктах Google.

Цвет

В применимых продуктах Google цвета делятся на две функциональные группы: системные цвета (для структурных элементов) и цвета акцента (для основных элементов бренда). Использование этих семантических ролей обеспечивает четкую визуальную иерархию и автоматическую адаптацию темы в разных продуктах.

Роли системных цветов

Сопоставьте структурные цвета с ролями в интерфейсе, которые будут одинаковыми во всех подключенных приложениях:

  • Фоновые поверхности. Используйте нейтральные цвета поверхностей, предоставляемые хостом, для контейнеров карточек и вложенных групп. Не переопределяйте фон контейнера с помощью сплошной заливки, градиентов или узоров.
  • Иерархия текста и контента. Используйте основные цвета контента для заголовков и ключевых значений, дополнительные приглушенные тона – для основного текста и вспомогательных меток, а семантические цвета статуса (положительный, предупреждение, критический) – для операционных метаданных.
  • Границы и разделители. Используйте неброские цвета системных контуров для структурных границ и разделителей, чтобы разделять контент, не добавляя тяжелого визуального веса.
  • Основной акцент. Используйте системный акцент или цвет бренда-партнера для основных кнопок с призывом к действию.

Области применения бренда партнера

Руководство по размещению фирменных цветов партнеров в подключенных приложениях:

  • Рекомендуется использовать цвета бренда только для основных кнопок CTA, логотипов и ключевых моментов.
  • Не рекомендуется применять фирменные цвета к фону карточек, основному тексту, заголовкам, структурным границам или дополнительным интерактивным элементам управления.

Темы и светлый/тёмный режим

Подключенные приложения должны выглядеть гармонично как в светлой, так и в тёмной теме, а также при использовании динамических палитр.

  • Используйте семантические токены вместо статических шестнадцатеричных значений. Привяжите поверхности, текст и границы к семантическим токенам цвета основной поверхности, чтобы интерфейс автоматически адаптировался к светлой и тёмной темам.
  • Адаптируйте акцентные цвета бренда для обеих тем. Убедитесь, что акцентный цвет бренда сохраняет доступный контраст в обеих темах. Если цвет бренда по умолчанию кажется слишком темным или слишком ярким на темных поверхностях, используйте немного более светлый или менее насыщенный вариант в тёмной теме.
  • Используйте медиаконтент и логотипы, совместимые с темами. Экспортируйте значки, логотипы и иллюстрации с прозрачным фоном, чтобы в тёмной теме они не отображались в белых рамках.

Значки

В подключенных приложениях используются простые контурные значки, которые обеспечивают визуальную гармонию и удобство восприятия в продуктах Google.

Стиль и размер значков

Рекомендации по геометрии, цвету и размеру значков в подключенных приложениях:

  • Контурные закругленные значки. Используйте монохромные контурные значки с одинаковой толщиной линий и закругленными концами (например, Google Material Symbols Outlined) или набор значков партнера, которые соответствуют оптическому весу интерфейса хоста.
  • Нейтральные оттенки. Окрашивайте функциональные значки интерфейса в основные или дополнительные цвета контента, а не в цвета бренда. Так значки будут поддерживать иерархию чтения, не конкурируя с основными призывами к действию.
  • Размеры. Чтобы значки оставались разборчивыми и пропорциональными на разных экранах, их размер должен быть от 16 пкс (для компактных встроенных метаданных) до 32 пкс (для заметных карточек или заголовков функций).

Специальные возможности

Продукты Google, к которым это применимо, соответствуют стандартам WCAG 2.1 AA и Material Design 3.

Основные принципы доступности

  • Цветовой контраст. Обеспечьте минимальный коэффициент контрастности 4,5:1 WCAG AA для текста на фоне в светлой и темной темах.
  • Минимальный размер шрифта. Принудительно устанавливает размер шрифта 13 пт.
  • Области прикосновения. Минимальный размер интерактивной области для элементов управления должен составлять 48 x 48 пикселей на мобильных устройствах и 24 x 24 пикселя на компьютерах.
  • Фокус клавиатуры. Сохраните видимое кольцо индикатора фокуса и логичный порядок обхода вкладок для интерактивных компонентов карточки.
  • Альтернативный текст для динамических медиафайлов. Добавьте описательный альтернативный текст для всех изображений, значков, маркеров на карте и визуализаций данных, предоставленных партнером.
  • Оповещения о текущем состоянии (aria-live). Используйте области aria-live="polite", чтобы сообщать о динамических изменениях состояния карточки, например о развертывании строк по нажатию кнопки "Показать ещё", фильтрации элементов или выполнении встроенного действия.
  • Уменьшение движения (prefers-reduced-motion). Учитывайте запрос медиа prefers-reduced-motion пользователя, заменяя эффекты мерцания скелета и переходы слайдов карусели статическими или мгновенными изменениями состояния.
  • Переполнение и усечение контента. Ограничьте длинные текстовые блоки 3–5 строками и добавьте кнопку "Читать дальше", чтобы не нарушать макет и сохранить читабельность.