Google Assistant как входящий канал
Чтобы создать Action и подключить к нему бота, выполните следующие шаги:
- Создайте канал Google Ассистент.
- Скачайте Action Package.
- Зарегистрируйте Action в Actions Console.
- Задайте активационную фразу.
- Скопируйте Project ID.
- Скачайте gactions.
- Загрузите Action Package в проект.
- Протестируйте бота в симуляторе Actions Console.
Создание канала
Нажмите на панели управления Каналы → Входящие → Подключить канал. В разделе Голосовые Ассистенты выберите Google Ассистент.
Заполните поля:
- Название — здесь вы можете сменить имя канала на удобное для вас.
- Web app URL — ссылка на веб-приложение Interactive Canvas.
- Ветка — укажите ветку проекта, которую вы хотите развернуть в канал, по умолчанию
master
. Вы также можете выбрать Git-тег или ввести хеш конкретного коммита. - Публикация — автоматически (после каждого сохранения внесенных в проект изменений) или вручную (с помощью кнопки Опубликовать в строке с описанием канала).
- Добавить триггер — укажите фразы, которые будут ассоциироваться с вашим навыком. Если пользователь произнесет одну из этих фраз, Google Ассистент предложит запустить ваш навык.
Нажмите Создать. Дождитесь всплывающего окна с результатом публикации.
Action Package
Скачайте JSON вашего Action Package. Для этого нажмите на ссылку Скачать action.json под названием добавленного канала.
Регистрация Action
Зайдите в Action Console и создайте новый проект. Для этого нажмите Add/import Project. Укажите название для проекта, язык и страну. Выберите категорию для проекта из представленных.
Активационная фраза
На панели управления перейдите в меню Setup → Invocation. В поле Display name укажите активационную фразу для Action вашего бота.
Также здесь можно выбрать голос, которым ваш бот будет разговаривать с пользователями.
Project ID
Перейдите в настройки проекта Project settings → скопируйте значение поля Project ID.
gactions
Скачайте на компьютер программу gactions для вашей операционной системы.
Загрузка Action Package в проект
Запустите консоль (Windows) или терминал (macOS, Linux). Перейдите в папку, в которую вы сохранили программу gations и JSON-файл для Action Package. Выполните команду:
gactions update --action_package PACKAGE_NAME --project PROJECT_ID
Вместо PACKAGE_NAME
подставьте имя JSON-файла. Вместо PROJECT_ID
подставьте Project ID, который вы скопировали из настроек проекта. Нажмите Enter
.
Далее, вам нужно авторизоваться. Перейдите по ссылке, скопируйте код и вставьте его в окно консоли или терминала. Нажмите Enter
Тестирование
Теперь вы можете протестировать Action на устройстве с Google Assistant в том же аккаунте, под которым был создан проект. А также вы можете тестировать бота в симуляторе Action Console.
Перед тестированием проставьте разрешения на отслеживание действий в вашем Google Assistant. Для этого перейдите в настройки аккаунта выберите пункт Конфиденциальность → Действия в сервисах Google. Проверьте настройки Отслеживания действий, должны быть активны пункты:
- история приложений и веб-поиска;
- информация с устройств;
- история голосового управления.