Amazon Web Services опубликовала руководство по настройке Amazon Quick embedded chat — встраиваемого чата с искусственным интеллектом, который позволяет пользователям задавать вопросы и получать аналитические данные прямо в интерфейсе веб-приложения. Без кастомизации такой чат выглядит как внешний инструмент, встроенный в страницу, что ухудшает пользовательский опыт. В материале описаны два ключевых направления настройки: визуальная тема и тон общения.
Визуальная тема включает два уровня. Первый — стилизация контейнера и макета через CSS, которую разработчик контролирует вокруг iframe чата. Второй — параметры SDK (frameOptions), передаваемые при создании embedding-контекста. Поскольку чат рендерится внутри iframe, напрямую стилизовать его внутренние элементы нельзя. Вместо этого настраивается контейнер, а через SDK убираются стандартные элементы бренда, конфликтующие с дизайном приложения. Например, параметр className позволяет добавить собственный CSS-класс к iframe для скругления углов, позиционирования или z-index. Параметр withIframePlaceholder отображает заглушку во время загрузки, а framePermissions включает доступ к буферу обмена.
| Опция | Что контролирует |
|---|---|
| className | CSS-класс для iframe, позволяет менять скругление, позиционирование, z-index |
| withIframePlaceholder | Отображение заглушки во время загрузки чата |
| framePermissions | Доступ к буферу обмена для копирования и вставки |
| footerOptions | Показ или скрытие бренда Amazon Quick и ссылки на политику использования |
В примере из руководства чат встроен в финансовый дашборд как боковая панель, выезжающая справа. CSS-стили задают фиксированное позиционирование, ширину 400 пикселей, тень и анимацию появления. Шапка панели использует градиент, совпадающий с фирменным стилем дашборда. Для мобильных устройств панель растягивается на всю ширину. Также из футера чата удаляются стандартные атрибуция Amazon Quick и ссылка на политику использования — это делает чат неотличимым от нативного элемента приложения.
Кастомизация включает визуальную тему (CSS, frameOptions) и тон общения (brand voice).
Второе направление — тон общения. Визуальной согласованности недостаточно: чат должен общаться в манере, отражающей индивидуальность организации. В руководстве упоминается, что настройка тона позволяет задать стиль ответов, соответствующий бренду. Для финансового ассистента это может означать формальный и точный язык, а для сервиса с молодёжной аудиторией — более непринуждённый.
Материал AWS адресован разработчикам, которые уже используют Amazon Quick для встраивания аналитики. Amazon Quick — это сервис бизнес-аналитики, позволяющий создавать дашборды и отчёты. Embedded chat — относительно новая функция, которая добавляет к дашбордам диалоговый интерфейс. Кастомизация — важный шаг для компаний, которые хотят сохранить единый бренд в своих продуктах. Подобные возможности есть и у других платформ, например у Power BI Embedded, но подход AWS отличается использованием SDK и гибкой настройкой через CSS.
Для тех, кто впервые сталкивается с встраиванием ИИ-чатов, важно понимать: основная сложность — не в подключении, а в интеграции с существующим дизайном. Руководство AWS даёт практические примеры кода, которые можно адаптировать под свои задачи. Однако стоит учитывать, что кастомизация ограничена возможностями iframe: нельзя изменить внутренние стили чата, только обёртку. Это накладывает ограничения на глубину настройки, но в большинстве случаев достаточно для создания целостного впечатления.
