Google Assistant - это голосовой помощник от компании Google, который работает на различных девайсах (на смартфонах, умных колонках, на телевизорах, в автомобилях и тд).

Actions

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

Как работают Actions

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

Как создать Action для Google Assistant

Чтобы создать свой Action и подключить к нему бота, нужно выполнить несколько шагов.

Шаг 1. Подключение канала Google Assistant

Зайдите в настройки каналов вашего бота и нажмите на кнопку Google Assistant. Откроется окно настроек канала. Здесь вы можете переименовать канал. Нажмите на Создать канал - создастся новый канал Google Assistant.



Шаг 2. Action Package

Скачайте JSON вашего Action Package. Для этого нажмите на ссылку Скачать JSON на подключенном канале.



Шаг 3. Регистрация Action в Actions Console

Зайдите в Actions Console и создайте новый проект (кнопка Add/import Project). При создании проекта придумайте ему название и укажите язык для вашего проекта и страну.



При создании проекта вы можете выбрать его категорию, а можете и пропустить этот шаг сейчас (кнопка Skip в правом углу).

Шаг 4. Активационная фраза

Перейдите в меню Invocation в левом меню и укажите фразу активации для вашего Action. Также здесь можно выбрать голос, которым ваш Action будет разговаривать с пользователями.



В данном случае мы указали фразу "Эхо бот", поэтому пользователи смогут запустить наш Action фразами "Давай поговорим с эхо бот" и подобными.

Шаг 5. Project ID

Перейдите в настройки вашего проекта и скопируйте значение поля Project ID.



Шаг 6. gactions

Скачайте на свой компьютер программу gactions для вашей операционной системы. Не пытайтесь запустить этот файл, просто переходите к следующему шагу.

Шаг 7. Загрузка Action Package в проект

Запустите программу Консоль ("Командная строка") в Windows или Терминал в Mac OS или Linux.
Чтобы открыть командную строку в WIndows, нажмите Win + R, наберите "cmd" без кавычек и нажмите Ок.



В командной строке перейдите в папку, в которую вы сохранили программу gactions и JSON файл вашего Action Package.
Чтобы перейти в нужную папку в Windows, наберите "cd" без кавычек и далее введите путь к папке. Например, так:



Затем выполните следующую команду:

gactions update --action_package PACKAGE_NAME --project PROJECT_ID

Вместо PACKAGE_NAME подставьте имя JSON файла, который вы скачали. Вместо PROJECT_ID подставьте Project ID, который вы скопировали из настроек вашего проекта. Нажмите Enter.



В результате gactions выдаст URL, который нужно открыть в любом браузере. Скопируйте URL и откройте его в браузере. Откроется страница, на которой вас попросят выбрать аккаунт и дать разрешения на управление проектами. Выберите аккаунт, на котором вы создали проект в Actions Console.

После этого вы увидите авторизационный код, который нужно скопировать и вставить обратно в Консоль (или Терминал). Нажмите Enter.

Как тестировать

Теперь вы можете тестировать ваш Action на реальном девайсе с Google Assistant под тем же аккаунтом, под которым вы создали проект. А также вы можете тестировать Action в симуляторе Actions Console.

Перед тестированием, должны быть проставлены разрешения на отслеживание действий в вашем Google Account. Для этого выберете пункт меню Конфиденциальность - Действия в сервисах Google. Проверьте настройки Отслеживания действий, должны быть включены флажки в следующих пунктах: История приложений и веб-поиска, Информация с устройств, История голосового управления.

Ограничения Google Assistant

У Google Assistant есть несколько ограничений, которые нужно учитывать при создании сценария.

1. Не больше двух текстовых ответов за раз

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

2. Картинка должна идти только после текста

Если ваш бот должен показать Изображение в ответе, то ее нужно располагать только после текстового блока (хотя бы одного).

3. Только одна картинка в ответе

В ответе можно показать только одно изображение (и строго после текстового).

4. Не более восьми кнопок в ответе

Ассистент позволяет показывать не более 8-ми кнопок в одном ответе. Если у вас более восьми кнопок на одном экране бота, то будут показаны только первые 8.

Требования к дизайну

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

1. Бот должен сообщать, чего он ожидает от пользователя

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

2. Бот должен уметь заканчивать диалог

Каждый Action в Google Assistant должен уметь завершить диалог - то есть попрощаться с пользователем и отключить микрофон. Хотя бы в одной ветке диалога в вашем сценарии должен использоваться блок Завершение сценария, чтобы ассистент мог отключить микрофон в какой-то момент.

Теперь дело за хорошо продуманным сценарием. Создать который вам поможет статья "Как создать крутой экшен для Google Ассистента. Лайфхаки от Just AI"

Была ли эта статья полезна?
отменить
Спасибо!