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 и создайте новый проект с помощью кнопки New project.



При создании проекта придумайте ему название и укажите язык для вашего проекта и страну.



Далее, выберите категорию и подкатегорию проекта.



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

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



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

Нажмите Save.

Шаг 5. Project ID

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



Вставьте это значение в блокнот, оно понадобится нам позже.

Шаг 6. gactions

Скачайте на свой компьютер программу gactions для вашей операционной системы.



Скачайте её в ту же папку, куда скачивали action.json.

Не пытайтесь запустить этот файл, просто переходите к следующему шагу.

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

Если у вас Mac, переходите к этой инструкции. Выполните её, а затем переходите к шагу 8.

Если у вас 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:



Напишите "y" и нажмите Enter, чтобы обновить gactions. Затем снова отправьте команду с предыдущего шага.


Шаг 8.

В результате gactions выдаст URL, который нужно открыть в любом браузере. Чтобы открыть url, выделите его, нажмите Ctrl + C, и затем вставьте в строку браузера.



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

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



Затем нажмите "Разрешить":



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





Затем нажмите Enter.

Шаг 9.

После этого вы увидите сообщение, что навык успешно обновлён:

"Your app for the Assistant for project ... was successfully updated with your actions. Visit the Actions on Google console to finish registering your app and submit it for review at https://..."




Готово. Можете закрыть терминал.

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

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

Для этого просто откройте Google Assistant и попросите его запустить action, используя тот invocation, который вы установили ранее.

Убедитесь, что вы используете Google Assistant под тем аккаунтом, под которым разрабатывали приложение. Для этого нажмите на ваш аватар в Google Assistant и выберите "Аккаунт".


А также вы можете тестировать Action в симуляторе Actions Console. Для этого перейдите на вкладку Test.




Разрешения в Google Account

Перед тестированием должны быть проставлены разрешения на отслеживание действий в вашем Google Account.

Для того чтобы проставить эти разрешения выполните следующее:

перейдите в свой аккаунт Google - https://myaccount.google.com/
в разделе Конфиденциальность и персонализация" нажмите "Управление данными и персонализация":



В разделе Отслеживание действий включите следующие пункты:

- История приложений и веб-поиска
- История голосового управления
- Информация с устройств



Требования Google Assistant

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

Публикация навыка

Когда вы убедились, что ваш сценарий соответствует требованиям Google Assistant, перейдите на вкладку Overview вашего проекта и совершите шаги, нужные для публикации навыка.
Была ли эта статья полезна?
отменить
Спасибо!