Перейти к основному содержимому

Google Assistant как входящий канал

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

  1. Создайте канал Google Ассистент.
  2. Скачайте Action Package.
  3. Зарегистрируйте Action в Actions Console.
  4. Задайте активационную фразу.
  5. Скопируйте Project ID.
  6. Скачайте gactions.
  7. Загрузите Action Package в проект.
  8. Протестируйте бота в симуляторе 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. Проверьте настройки Отслеживания действий, должны быть активны пункты:

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