SDK для стриминговых аватаров от AKOOL уже предоставляет основу для взаимодействия в режиме реального времени с помощью видео, аудио, текста и микрофона. Следующий шаг — сделать этот аватар полезным для вашего бизнеса, подключив его к проверенной документации по продуктам, регламентам, учебным материалам или контенту службы поддержки.
Это руководство посвящено уровню знаний. Вы создадите базу знаний AKOOL, подключите ее к сессии стримингового аватара с помощью knowledge_idи убедитесь, что аватар дает обоснованные ответы внутри вашего приложения.
Официальная документация SDK показывает, как запустить стриминг аватара. Это руководство покажет, как научить этот аватар понимать специфику вашего бизнеса.
Что вы создаете
Готовое решение объединяет три компонента: утвержденные вами источники знаний, базу знаний AKOOL, которая подготавливает эти источники для диалога, и стриминговый аватар, встроенный в ваше приложение. Когда пользователь задает вопрос, аватар использует подключенную базу знаний в качестве контекста и выдает ответ с помощью синхронизированных речи и видео.
Связующим звеном между уровнем знаний и активной сессией является поле knowledge_id . Оно добавляется при создании сессии стримингового аватара до того, как браузер подключится к каналу реального времени.
Источники знаний обрабатываются внутри AKOOL и представлены в виде knowledge_id. Ваш бэкенд включает этот ID при создании сессии стримингового аватара. Затем браузер подключается к возвращенной сессии через SDK AKOOL, что позволяет аватару отвечать на основе утвержденных знаний, сохраняя учетные данные на сервере.
Выберите путь разработки
Если вам нужен рабочий прототип в кратчайшие сроки, скопируйте приведенный ниже промпт в ИИ-агент для написания кода. Если у вас уже есть интеграция стримингового аватара AKOOL или вы предпочитаете настроить рабочий процесс самостоятельно, переходите к разделу «Быстрый старт». Оба пути приводят к одному результату: живому аватару, чьи ответы основаны на вашем собственном контенте.
Вариант 1: Создание с помощью ИИ-агента
Скопируйте этот промпт в предпочитаемый вами ИИ-агент для написания кода и предоставьте конфигурацию AKOOL, когда потребуется.
Промпт для сборки через ИИ-агент
Build a knowledge-powered AKOOL Streaming Avatar application.
Use AKOOL’s official Streaming Avatar SDK Quick Start as the implementation reference:
https://docs.akool.com/sdk/jssdk-start
Start from the official SDK workflow instead of recreating a generic streaming demo. Add the following knowledge-base workflow:
1. Create the avatar session from a backend endpoint.
2. Read the Avatar ID, Knowledge Base ID, optional Voice ID, language, and duration from server-side configuration.
3. Include knowledge_id and mode_type: 2 in the session-creation request.
4. Return only the temporary session credentials required by the browser.
5. Use the official AKOOL JavaScript SDK for video, audio, text, microphone, and interruption controls.
6. Add an explicit End Session action.
7. Provide a small test panel for an exact-source question, a paraphrased question, and an out-of-scope question.
Keep the interface simple and use the linked AKOOL documentation as the source of truth.Вариант 2: Следуйте инструкциям «Быстрого старта»
Используйте этот путь, если хотите добавить уровень знаний в существующее приложение или разобраться в интеграции перед тем, как передать задачу ИИ-агенту.
Перед началом работы
Вам потребуется учетная запись AKOOL с доступом к API, ID стримингового аватара и работающее приложение со стриминговым аватаром, созданное на основе официального JavaScript SDK. Вы можете создание или управление стриминговым аватаром в AKOOL. Подготовьте документы или общедоступные URL-адреса, которые должен использовать аватар. Идентификатор голоса (Voice ID) не является обязательным.
Если вы еще не подключились к стриминговому аватару, сначала выполните руководство по быстрому запуску SDK для стриминговых аватаров . В этой статье намеренно не повторяются шаги по установке, подключению каналов или обработке медиаданных.
Шаг 1: Подготовка источников знаний
Загрузите поддерживаемые документы или добавьте общедоступные URL-адреса. Для первого простого теста лучше всего подойдет хорошо структурированный файл DOCX. Старайтесь, чтобы каждый источник был посвящен одной теме — так база знаний сможет точнее находить нужные фрагменты.
Начните с небольшого набора проверенных данных и узкого круга тестовых вопросов. Когда аватар начнет давать точные ответы, постепенно добавляйте новые документы или URL-адреса и проводите повторное тестирование.
Шаг 2: Создание базы знаний AKOOL
Заполните основные поля настройки: понятное название, приветственное сообщение (пролог в API), инструкцию для промпта, а также документы или общедоступные URL-адреса, которые AKOOL будет использовать в качестве источников.
Приветственное сообщение (пролог): Напишите первую фразу, которую произнесет аватар в начале сессии. Она должна быть краткой, приветливой и соответствовать тематике базы знаний.
Промпт: «Отвечай на вопросы, используя утвержденные источники знаний. Будь краток и полезен. Если информации нет, прямо скажи об этом и предложи дальнейшие действия для получения поддержки».
Дождитесь завершения обработки источников, а затем скопируйте идентификатор базы знаний (Knowledge Base ID). AKOOL использует это значение в качестве knowledge_id для активной сессии.
Шаг 3: Подключение базы знаний к сессии
При создании сессии Streaming Avatar на бэкенде добавьте в запрос идентификатор базы знаний (Knowledge Base ID). Используйте режим диалога, чтобы аватар мог отвечать на вопросы и поддерживать беседу.
Пример конфигурации сессии
{
"avatar_id": "your_avatar_id",
"voice_id": "your_voice_id",
"knowledge_id": "your_knowledge_id",
"mode_type": 2
}Важно понимать, когда именно это происходит: knowledge_id должно выполняться при создании сессии, а не в браузере во время вызова joinChat() . Как только сессия создана, браузер может подключиться с помощью временных учетных данных, предоставленных AKOOL, и использовать стандартный поток взаимодействия SDK.
Создавайте сессию на бэкенде, а не напрямую в браузере, чтобы сохранить API-ключ в секрете. В этом примере cURL идентификатор базы знаний передается при создании сессии, а режим диалога активируется с помощью mode_type: 2.
Создание сессии Streaming Avatar с использованием базы знаний
curl --request POST \
--url https://openapi.akool.com/api/open/v4/liveAvatar/session/create \
--header "Content-Type: application/json" \
--header "x-api-key: <api-key>" \
--data '{
"avatar_id": "<avatar-id>",
"voice_id": "<voice-id>",
"language": "en",
"duration": 600,
"mode_type": 2,
"knowledge_id": "<knowledge-id>",
"stream_type": "agora"
}'Сохраняйте полученные учетные данные сессии на сервере, передавайте клиенту только необходимые для подключения параметры и используйте их для инициализации SDK AKOOL Streaming Avatar.
Шаг 4: Добавление аватара в ваше приложение
Используйте JavaScript SDK от AKOOL для подключения к каналу в реальном времени, запуска чата в режиме диалога, отображения видео и аудио, а также для отправки текстового или голосового ввода. Этот этап идентичен официальному руководству по быстрому старту SDK; ваша задача — определить, где будет отображаться аватар и как пользователи будут начинать, прерывать и завершать разговор.
Конфигурацию базы знаний следует выполнять на этапе создания сессии. Это позволяет одному и тому же фронтенду поддерживать разные продукты, регионы или аудитории, просто выбирая нужный идентификатор базы знаний на бэкенде.
Шаг 5: Проверка точности ответов
Не останавливайтесь на успешном подключении аватара. Убедитесь, что он действительно использует нужную базу знаний и корректно реагирует, если ответ на вопрос отсутствует.
Устранение распространенных проблем с базой знаний
Аватар игнорирует базу знаний. Убедитесь, что правильный knowledge_id указан в запросе на создание сессии. База знаний может существовать в панели управления, но при этом не быть привязанной к активной сессии Streaming Avatar.
Контент базы знаний не найден. Перед тестированием убедитесь, что обработка всех загруженных файлов или общедоступных URL-адресов завершена. Если обработка все еще выполняется или произошла ошибка, контент пока недоступен для извлечения.
Ответы противоречивы. Удалите устаревшие, дублирующиеся или противоречивые исходные материалы. Оставьте одну достоверную версию каждого факта, используйте четкие заголовки и проведите повторное тестирование с помощью прямых вопросов, ответы на которые явно содержатся в источниках.
Сессия работает, но диалог — нет. Убедитесь, что сессия была создана с помощью mode_type: 2. Затем проверьте, что SDK подключается к той же сессии, которую вернул ваш бэкенд, и что конфигурация аватара, голоса, языка и сессии действительны. Если во время отладки вы создаете новую сессию взамен старой, убедитесь, что клиент не продолжает использовать устаревшие учетные данные из предыдущего ответа.
Варианты использования
Клиентская поддержка. Позвольте посетителям задавать вопросы о продуктах, настройке, гарантии или правилах через более естественный интерфейс, чем стандартный поиск по справочному центру.
Подбор продуктов. Помогайте потенциальным клиентам ориентироваться в функциях, тарифах и рекомендуемых сценариях работы, используя утвержденные материалы по продажам и продуктам.
Обучение сотрудников. Превратите руководства по адаптации и внутренние регламенты в интерактивного помощника для обучения.
Образование и мероприятия. Предоставьте учащимся или участникам живого ведущего, который может отвечать на вопросы на основе учебных материалов, заметок докладчика или ресурсов мероприятия.
Чек-лист перед запуском
☐ Источники знаний актуальны, достоверны и полностью обработаны.
☐ Необходимый knowledge_id включен при создании сессии.
☐ Протестированы точные, перефразированные, выходящие за рамки и уточняющие вопросы.
☐ В приложении предусмотрены понятные элементы управления для запуска, прерывания и завершения сеанса.
☐ Итоговый продукт протестирован с использованием как текстового ввода, так и ввода через микрофон.
Ресурсы
- База знаний AKOOL
- Создание сеанса потокового аватара
- руководство по быстрому запуску SDK для стриминговых аватаров
- Рекомендации по работе с SDK потоковых аватаров
Часто задаваемые вопросы
Что такое knowledge_id в AKOOL Streaming Avatar?
knowledge_id — это идентификатор базы знаний AKOOL. Добавление его в сессию Streaming Avatar указывает AKOOL, какие обработанные документы и URL-адреса должен использовать аватар при ответах на вопросы, основанные на базе знаний.
Когда следует добавлять knowledge_id в сессию Streaming Avatar?
Добавляйте его во время создания сессии на стороне бэкенда, до того как браузер присоединится к сессии. Это гарантирует, что база знаний будет подключена с самого начала, и позволит избежать раскрытия вашего API-ключа AKOOL в клиентском коде.
Какие типы файлов поддерживает база знаний AKOOL?
Документы AKOOL поддерживают файлы форматов PDF, DOC, DOCX, TXT, MD, JSON, XML и CSV. Вы также можете добавлять общедоступные URL-адреса. Используйте чистые и актуальные источники с описательными заголовками и дожидайтесь завершения обработки перед тестированием поиска.
Можно ли напрямую подключить внешнюю LLM или RAG-базу знаний?
Описанный рабочий процесс Streaming Avatar использует базу знаний AKOOL: добавьте документы или URL-адреса, получите их knowledge_idи укажите этот ID при создании сессии. Не стоит рассчитывать на то, что произвольную внешнюю векторную базу данных или RAG-сервис можно подключить напрямую, если вы не разработали и не протестировали отдельную интеграцию на уровне приложения.
