Чтобы AI-агент отвечал на вопросы о ваших товарах, ценах и условиях, ему нужна база знаний — набор текстов и файлов, по которым он ищет ответы. Без базы знаний агент опирается только на системный промпт и общие знания модели, а значит, не знает ничего про ваш конкретный продукт.
В Auralix база знаний состоит из двух частей:
- Тексты — документы, статьи, описания услуг, прайсы. Агент читает их и отвечает словами.
- Фото и видео — изображения, MP4, PDF, которые агент отправляет клиенту прямо в чате.
В этой инструкции разберём обе части — как добавить материалы, как их правильно оформить и как проверить, что агент действительно использует нужные данные.
Что понадобится
- Проект в Auralix с созданным агентом.
- Тексты о вашем продукте: описания, прайс, FAQ, условия работы.
- Опционально: фотографии, PDF-прайсы или видео, которые нужно отправлять клиентам в чате.
Шаг 1. Откройте раздел «База знаний»
В дашборде перейдите в нужный проект, затем в боковом меню выберите «База знаний».
Вы увидите две вкладки: «Тексты» и «Фото и видео». Начните с текстов.
Шаг 2. Добавьте текстовые документы
Есть три способа добавить текст:
Загрузить файл
Нажмите «Загрузить файл» и выберите .txt или .md файл. Подходит, если у вас уже есть готовый текст — описание компании, FAQ, каталог товаров.
Добавить URL страницы
Нажмите «Добавить URL», вставьте адрес страницы вашего сайта. Система автоматически извлечёт текст.
Важно: после обработки обязательно откройте документ и отредактируйте извлечённый текст. Удалите мусор: меню, футер, рекламные баннеры, повторяющиеся блоки. Оставьте только полезную информацию.
Создать документ вручную
Нажмите «Создать документ», введите название и напишите текст прямо в редакторе. Это самый контролируемый способ — вы сразу видите, что именно попадёт в базу.
Шаг 3. Как правильно структурировать текст
Качество ответов агента напрямую зависит от того, насколько хорошо структурированы документы. Несколько правил:
Каждый продукт или услугу — в отдельный раздел с заголовком. Используйте формат ## Название (ключевые параметры). Например:
## CRM-система для малого бизнеса (от 5 сотрудников)
Краткое описание в 1–2 предложения.
- Цена: от 1 900 руб/мес
- Пробный период: 14 дней бесплатно
- Что входит: сделки, клиенты, задачи, интеграция с почтой
- Подходит для: розница, услуги, B2B-продажи
В заголовке — ключевые параметры. Агент ищет по заголовкам. ## Курс Python (9–14 лет, онлайн) лучше, чем ## Курс 3.
Конкретные данные — цены, сроки, характеристики. Без них агент не сможет ответить на вопросы о стоимости. Не пишите «цена договорная» — пишите реальную цифру или диапазон.
Создайте сводный документ-каталог. Один документ со списком ВСЕХ продуктов и услуг — название, краткое описание, главные параметры. Это поможет агенту отвечать на общие вопросы «что у вас есть?» и «чем вы занимаетесь?».
Не загружайте шум. Страницы с отзывами, навигация сайта, юридические тексты, куки-политики — всё это мешает поиску. Загружайте только то, что содержит факты о продукте.
Используйте Markdown: ## заголовки, - списки, **выделение**. Структурированный текст агент понимает значительно лучше сплошного.
Шаг 4. Дождитесь статуса «Готов»
После добавления документ проходит несколько этапов:
| Статус | Что происходит |
|---|---|
| Ожидает | Документ в очереди на обработку |
| Обработка | Текст нарезается на части, генерируются эмбеддинги |
| Готов | Документ участвует в поиске при ответах агента |
| Ошибка | Проблема с обработкой — проверьте URL или содержимое файла |
Только документы со статусом «Готов» используются в ответах. Обновить статус вручную можно кнопкой «Обновить статус» в таблице.
Шаг 5. Добавьте фото, видео и PDF (если нужно)
Если клиент может попросить «пришлите прайс», «есть фото продукта?», «покажите видео» — перейдите на вкладку «Фото и видео».
- Нажмите «Загрузить файл» и выберите изображение, MP4 или PDF (до 50 МБ). Или нажмите «Файл по ссылке» и вставьте прямой URL.
- Заполните название и описание для поиска. Это не подпись под картинкой — это подсказка, по каким вопросам клиента агент должен отправить файл.
- Дождитесь статуса «Готов».
Пример хорошего описания:
Название: Прайс-лист курсов 2026
Описание: PDF с ценами на все курсы для детей.
Отправлять, когда клиент спрашивает стоимость, прайс,
цены или хочет скачать прайс-лист.
Поддерживаемые форматы: PNG, JPG, WebP, GIF, MP4, PDF.
Шаг 6. Проверьте работу агента
После того как документы перешли в статус «Готов», протестируйте агента — откройте виджет или перейдите на вкладку агента и задайте несколько вопросов.
Проверьте сценарии:
- Спросите о конкретной цене или услуге, которая есть в базе знаний.
- Попросите прислать медиафайл: «Есть прайс?», «Покажите видео».
- Задайте общий вопрос: «Чем вы занимаетесь?» — агент должен опираться на каталог.
Если агент «не знает» ответ, хотя факт есть в базе — проверьте, что нужный документ в статусе «Готов» и что факт сформулирован явно, а не подразумевается.
Частые ошибки
Агент не знает цену, хотя она есть. Скорее всего, документ ещё обрабатывается или цена «зарыта» в сплошном тексте без структуры. Вынесите её в отдельную строку.
Документ завис в «Обработка». Обновите страницу, нажмите «Обновить статус». Если статус не меняется — попробуйте пересохранить документ.
Агент отвечает по URL, но упоминает меню сайта. После обработки URL-страницы откройте документ и удалите навигационные блоки из извлечённого текста.
Медиафайл не отправляется. Убедитесь, что описание заполнено (минимум 10 символов) и документ в статусе «Готов». Протестируйте фразой из описания.
Итог
Хорошая база знаний — это не просто загруженные файлы, а структурированные тексты с конкретными фактами. Основные шаги:
- Создайте документы с описаниями продуктов, ценами и условиями — каждую услугу в отдельный раздел с заголовком.
- Добавьте сводный каталог всех продуктов для общих вопросов.
- При добавлении URL-страниц — очистите извлечённый текст от мусора.
- Добавьте медиафайлы с описаниями, если клиенты просят прайсы, фото или видео.
- Дождитесь статуса «Готов» и проверьте агента в тестовом диалоге.
Чем точнее и чище база знаний, тем меньше агент будет давать размытых ответов и тем выше конверсия из диалога в заявку.
