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

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

Кроме JAICP мы предоставляем платформу Aimybox, с помощью которой вы можете научить любое устройство слушать и разговаривать с пользователем. Для этого в Aimybox можно создать проект, включить в нем нужные голосовые функции, а затем интегрировать в ваше устройство. Вы можете выбрать Android SDK, iOS SDK или HTTP API.

При этом вы можете использовать любые системы распознавания и синтеза речи, которые поддерживаются в Aimybox, или подключить свое решение.

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

  1. Подготовьте проект.
  2. Подключите канал.
  3. Создайте навык в консоли Aimybox.
  4. Протестируйте навык.

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

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

  1. Укажите в файле build.gradle.kts в зависимостях настройки:
dependencies {
// ...
implementation("com.just-ai.jaicf:jaicp:$jaicfVersion")
implementation("com.just-ai.jaicf:aimybox:$jaicfVersion")
}
подсказка
  1. Сконфигурируйте способ подключения к платформе:
  • long polling — бот будет сам подключаться к серверу Just AI при взаимодействии с платформой. Простое решение, подходит для локальной разработки и отладки.

    Для этого способа укажите в файле JaicpPoller.kt канал AimyboxChannel:

package com.just-ai.jaicf.template.connections

fun main() {
JaicpPollingConnector(
templateBot,
accessToken,
channels = listOf(
ChatApiChannel,
ChatWidgetChannel,
TelephonyChannel,
AimyboxChannel
)
).runBlocking()
}
  • webhook — по указанной ссылке бот будет принимать сообщения платформы. Необходимо конфигурировать для подключения в JAICP Cloud.

    Для этого способа укажите в файле JaicpServer.kt канал AimyboxChannel:

package com.just-ai.jaicf.template.connections

fun main() {
JaicpServer(
botApi = templateBot,
accessToken = accessToken,
channels = listOf(
ChatApiChannel,
ChatWidgetChannel,
TelephonyChannel,
AimyboxChannel
)
).start(wait = true)
}

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

Перейдите в проект JAICF на JAICP. Нажмите на панели управления Каналы → Входящие → Подключить канал. В разделе Другие выберите Aimybox. Укажите название канала → нажмите Создать.

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

Создание навыка

Авторизуйтесь в консоли разработчика Aimybox. Теперь создайте навык в консоли, для этого нажмите Create skill и заполните параметры:

  • Skill name — добавьте название навыка.
  • Skill samples — придумайте и укажите одну или несколько фраз, которыми пользователь будет активировать ваш навык.

Далее выберите Aimylogic как способ подключения. В поле Aimylogic webhook URL вставьте ранее скопированный вебхук.

Нажмите Save skill.

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

Через несколько секунд вы сможете протестировать, как работает ваш навык. Для этого после завершения обучения нажмите Try it in action. Укажите в поле одну из фраз активации, которые вы указали при создании навыка.

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

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

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

action {
reactions.say("Привет!")
reactions.aimybox?.question(true)
}

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

action {
reactions.aimybox!!.response.replies += TextReply("Hello")
}