{ "componentChunkName": "component---src-templates-doc-page-js", "path": "/docs/ru/channels/google_assistant/jaicf/", "result": {"data":{"site":{"siteMetadata":{"title":"Gatsby-doc-engine"}},"markdownRemark":{"id":"335b10d6-a616-5921-affe-5183022d8880","excerpt":"Подключение Google Assistant для проекта на JAICF Чтобы создать Action и подключить к нему проект на JAICF, выполните следующие шаги: Подготовьте проект…","html":"

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

\n
\n

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

\n
    \n
  1. Подготовьте проект.
    2. \n
  2. Подключите канал.
    3. \n
  3. Скачайте Action Package.
    4. \n
  4. Зарегистрируйте Action в Actions Console.
    5. \n
  5. Задайте активационную фразу.
    6. \n
  6. Скопируйте Project ID.
    7. \n
  7. Скачайте gactions.
    8. \n
  8. Загрузите Action Package в проект.
    9. \n
  9. Протестируйте бота в симуляторе Actions Console.
    10. \n
\n

Данная интеграция с Google Assistant активна только для проектов, созданных с устаревшей версией Actions SDK. Для проектов, созданных с использованием Conversational Actions, используйте канал Dialogflow.

\n

Подготовка проекта

\n

Перед подключением канала предварительно подготовьте проект JAICF:

\n\n
dependencies {\r\n    // ...\r\n    implementation(\"com.justai.jaicf:jaicp:$jaicfVersion\")\r\n    implementation(\"com.justai.jaicf:google-actions:$jaicfVersion\")\r\n}
\n

Замените $jaicfVersion последней версией фреймворка.

\n
\n
    \n
  1. Сконфигурируйте в зависимости от способа подключения к платформе:
    2. \n
\n\n
package com.justai.jaicf.template.connections\r\n\r\nfun main() {\r\n    JaicpPollingConnector(\r\n        templateBot,\r\n        accessToken,\r\n        channels = listOf(\r\n            ChatApiChannel,\r\n            ChatWidgetChannel,\r\n            TelephonyChannel,\r\n            ActionsFulfillment.ActionsFulfillmentSDK\r\n        )\r\n    ).runBlocking()\r\n}
\n
\n\n
package com.justai.jaicf.template.connections\r\n\r\nfun main() {\r\n    JaicpServer(\r\n        botApi = templateBot,\r\n        accessToken = accessToken,\r\n        channels = listOf(\r\n            ChatApiChannel,\r\n            ChatWidgetChannel,\r\n            TelephonyChannel,\r\n            ActionsFulfillment.ActionsFulfillmentSDK\r\n        )\r\n    ).start(wait = true)\r\n}
\n

Подключение канала

\n

Перейдите в проект JAICF на платформе JAICP. Нажмите на панели управления Каналы > Входящие > Создать канал. В разделе Голосовые Ассистенты выберите Google Ассистент.

\n

Заполните поля:

\n\n

Нажмите Создать

\n

Action Package

\n

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

\n

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

\n

Зайдите в Action Console и создайте новый проект. Для этого нажмите Add/import Project. Укажите название для проекта, язык и страну. Выберите категорию для проекта из представленных.

\n

Активационная фраза

\n

На панели управления перейдите в меню Setup > Invocation. В поле Display name укажите активационную фразу для Action вашего бота.

\n

Также здесь можно выбрать голос, которым ваш бот будет разговаривать с пользователями.

\n

Project ID

\n

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

\n

gactions

\n

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

\n

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

\n

Запустите консоль (Windows) или терминал (macOS, Linux). Перейдите в папку, в которую вы сохранили программу gations и JSON-файл для Action Package. Выполните команду:

\n
gactions update --action_package PACKAGE_NAME --project PROJECT_ID
\n\n

Нажмите Enter.

\n

Разрешение на использование

\n

Вы получите от gactions URL, который нужно открыть в любом браузере. Скопируйте URL, а затем вставьте в строку браузера.

\n

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

\n

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

\n

Вы увидите авторизационный код, который нужно скопировать и вставить обратно в консоль/терминал, а затем нажать Enter.

\n

Тестирование

\n

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

\n

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

\n\n

Нативные возможности канала

\n

Хранение пользовательского контекста

\n

Google Assistant предоставляет собственный менеджер контекста для хранения пользовательских данных.\r\nЧтобы включить его, передайте параметр useDataStorage при указании канала:

\n
fun main() {\r\n    JaicpServer(\r\n        botApi = templateBot,\r\n        accessToken = accessToken,\r\n        channels = listOf(\r\n            ActionsFulfillment.ActionsFulfillmentSDK(useDataStorage = true)\r\n        )\r\n    ).start(wait = true)\r\n}
\n

Запросы, приходящие из Google Assistant, будут содержать контекст пользователя.

\n

Нативные реакции

\n

JAICF предоставляет универсальные реакции, доступные во всех каналах, а также реакции, уникальные для Google Assistant.\r\nЧтобы использовать специфические реакции Google Assistant, используйте reactions.actions, например:

\n
action {\r\n    reactions.say(\"Привет!\")\r\n    reactions.actions?.addSimpleResponse(\"display text\", \"ssml of text\")\r\n}
\n

Вы также можете напрямую обратиться к объекту с ответом через reactions.actions.response:

\n
action {\r\n    val builder = reactions.actions?.response?.builder\r\n    builder?.add(\"Hello\")\r\n}
\n

Ограничения канала

\n

При разработке сценария для Google Assistant учитывайте следующие ограничения канала:

\n
    \n
  1. Каждый ответ должен содержать хотя бы один текстовой элемент. Для этого нужно использовать реакцию say.
    2. \n
  2. Ответ может содержать максимум 1 изображение, аудио или другой медиаконтент.
    3. \n
  3. Ответ с изображением, аудио или медиаконтентом должен содержать кнопки. Для этого воспользуйтесь реакцией buttons.
    4. \n
\n

При отправке изображения и текста порядок, в котором они будут выведены, может отличаться от порядка вызовов реакций.

","frontmatter":{"title":"","description":null},"headings":[{"value":"Подключение Google Assistant для проекта на JAICF"}]}},"pageContext":{"slug":"/docs/ru/channels/google_assistant/jaicf/","previous":{"fields":{"slug":"/docs/ru/channels/iDigital/whatsapp/"},"frontmatter":{"title":"","description":null}},"next":{"fields":{"slug":"/docs/ru/channels/google_assistant/interactive_canvas/"},"frontmatter":{"title":"","description":null}}}}, "staticQueryHashes": ["1209419333"]}