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

Подключение 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")
}
подсказка
Замените $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. Укажите в поле одну из фраз активации, которые вы указали при создании навыка.

подсказка
Подробнее о работе с платформой Aimybox

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

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

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

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

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

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