This site is no longer updated.Go to new Conversational Cloud docs

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


Подробнее о том, как подключить Google Assistant для проекта на JAICF

Чтобы создать 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. Проверьте настройки Отслеживания действий, должны быть активны пункты:

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