База знаний (документы / RAG)

База знаний — это «память» вашего AI-агента. Сюда вы загружаете документы и ссылки на сайты с информацией о вашей школе или бизнесе: программы, цены, расписание, условия, частые вопросы. Когда клиент задаёт вопрос в чате, агент находит в базе самые подходящие фрагменты и отвечает строго по ним — а не выдумывает.

Это ключевой принцип платформы: агент отвечает фактами из вашей базы, а не «из головы». Чем лучше наполнена база знаний, тем точнее и полезнее ответы.

Где находится база знаний

База знаний привязана к конкретному агенту. Документы загружаются на странице самого агента, а не на общей странице.

1. В дашборде откройте раздел AI → Агенты.
2. Выберите нужного агента.
3. Прокрутите до карточки «База знаний» — там и происходит загрузка.

[скриншот: карточка «База знаний» на странице агента с зоной загрузки и кнопкой URL]

Отдельная страница «База знаний» (в основном меню) — это общий обзор: она показывает все документы по всем вашим агентам сразу, с фильтрами и статистикой. Загружать новые файлы оттуда нельзя — только просматривать и удалять. Если на этой странице пусто, вы увидите подсказку: «Документы загружаются через страницу конкретного агента».

[скриншот: общая страница «База знаний» со статистикой — всего документов, обработано, в обработке, всего чанков]

Какие документы можно загружать

Поддерживаются три типа файлов и ссылки на сайты:

Важно про форматы:

• Старый формат Word .doc не поддерживается — пересохраните файл как .docx.
• Таблицы Excel (.xlsx), .csv и обычный текст .txt через загрузку файлов не принимаются. Если у вас данные в таблице — экспортируйте их в PDF или Word, либо опишите в обычном документе.
• PDF должен содержать текст, а не быть сканом-картинкой. Если PDF — это фотографии страниц, агент не сможет прочитать содержимое.

Как загрузить файлы

1. На странице агента в карточке «База знаний» найдите зону с пунктиром: «Перетащите файлы или нажмите для выбора».
2. Перетащите туда файлы мышкой или кликните по зоне и выберите файлы на компьютере.
3. Можно загрузить сразу несколько файлов за один раз (до 20).
4. Пойдёт индикатор «Загрузка файлов...» — дождитесь его окончания.

[скриншот: зона загрузки документов с подписью «PDF, DOCX, HTML до 50MB (до 20 файлов)»]

Как добавить сайт по ссылке

1. Нажмите кнопку URL в правом верхнем углу карточки «База знаний».
2. В появившемся поле вставьте адрес страницы (например, https://example.com/programs).
3. Нажмите Добавить.

Платформа сама скачает страницу, извлечёт из неё текст и добавит в базу. Если вы введёте адрес без https://, он подставится автоматически.

Совет: добавляйте конкретные информативные страницы (страница с программами, ценами, условиями), а не главную страницу сайта целиком — так агент получит более чистые и полезные данные.

Что происходит после загрузки (статусы)

Обработка идёт в фоне и занимает от нескольких секунд до пары минут — это нормально. Платформа разбирает документ на части, превращает их в «понятный для AI» вид и сохраняет.

Что происходит «под капотом»:

1. Извлечение текста — из PDF/Word/HTML или со страницы по ссылке.
2. Нарезка на фрагменты (их называют чанки) — документ делится на небольшие куски, чтобы поиск был точным.
3. Создание эмбеддингов — каждый фрагмент превращается в числовой «отпечаток смысла».
4. Сохранение в векторную базу в персональном пространстве вашего агента.

У каждого документа в списке отображается статус:

Рядом с каждым документом видно, на сколько чанков он разбит, его размер и дату загрузки. Общее число чанков по всем документам показано в статистике на общей странице «База знаний».

[скриншот: список документов со статусами «Готово»/«Обработка» и количеством чанков]

Если документ получил статус «Ошибка» или вы обновили содержимое сайта по ссылке — используйте кнопку «Переиндексировать» рядом с документом. Платформа заново скачает и обработает источник.

Как работает поиск по базе (RAG)

Когда клиент пишет агенту, происходит умный смысловой поиск (технология называется RAG — Retrieval-Augmented Generation, «генерация ответа с опорой на найденные данные»):

1. Вопрос клиента превращается в такой же «отпечаток смысла».
2. Платформа находит в базе самые близкие по смыслу фрагменты ваших документов — даже если клиент сформулировал вопрос другими словами.
3. Эти фрагменты передаются агенту как проверенные факты, и он составляет ответ строго по ним.

Главное преимущество: поиск идёт по смыслу, а не по точному совпадению слов. Если в документе написано «стоимость абонемента», а клиент спросил «сколько стоит ходить к вам» — нужный фрагмент всё равно найдётся.

Каждый агент видит только свою базу

Данные строго изолированы: документы одного агента не попадают в ответы другого агента и тем более — другого партнёра. У каждого агента своё отдельное пространство в базе (agent_{идентификатор агента}). Это гарантирует, что школа A никогда не увидит в ответах данные школы B.

Многоуровневый поиск

Поиск устроен «от частного к общему»:

1. Сначала платформа ищет ответ в вашей базе знаний (документы конкретного агента).
2. Если в вашей базе нашлось достаточно уверенное совпадение — используется только оно.
3. Если в вашей базе ничего подходящего нет или совпадение слабое — система может дополнить ответ общей базой знаний платформы (общие справочные материалы Algorithmika). При этом ваши собственные данные всегда имеют приоритет над общими.

На практике это значит: если вы загрузили свои документы — агент отвечает по ним. Общая база — это «страховка» на случай, когда по конкретному вопросу у вас ничего не загружено.

Лимиты и ограничения

Если файл больше 50 МБ — разбейте его на части или сожмите PDF. Если при пакетной загрузке часть файлов не подошла (неверный формат, слишком большой) — корректные файлы всё равно загрузятся, а по неподходящим вы увидите, что они не приняты.

Как удалить документ

Удалить документ можно как со страницы агента, так и с общей страницы «База знаний» — кнопкой с корзиной. После подтверждения платформа:

1. Удалит все фрагменты документа из поисковой базы (агент сразу перестанет их использовать).
2. Удалит сам файл и его запись.

[скриншот: кнопка удаления (корзина) рядом с документом и окно подтверждения «Удалить документ?»]

Удаление необратимо — чтобы вернуть документ, его придётся загрузить заново.

Частые вопросы

Как быстро агент начнёт использовать новый документ? Как только статус станет «Готово» — обычно в течение минуты. Если статус долго висит на «Обработка», обновите страницу.

Документ загрузился со статусом «Ошибка». Что делать? Чаще всего причина — PDF из сканов (картинки без текста), пустой файл или недоступная ссылка. Проверьте, что в файле есть выделяемый текст, и нажмите «Переиндексировать». Если не помогло — пересохраните документ (например, заново экспортируйте в PDF из исходника).

Я обновил информацию (цены, расписание). Как обновить базу? Для файла — удалите старый и загрузите новый. Для источника по ссылке — нажмите «Переиндексировать», чтобы платформа заново считала актуальную версию страницы.

Агент отвечает неточно или «не находит» информацию. Убедитесь, что нужный документ загружен именно к этому агенту и имеет статус «Готово». Полезно, чтобы информация в документах была изложена явным текстом (а не только в таблицах или картинках) и без противоречий между разными файлами.

Что лучше: загрузить один большой документ или несколько маленьких? Принципиальной разницы нет — платформа всё равно нарежет всё на фрагменты. Главное, чтобы информация была актуальной и непротиворечивой. Удобнее держать документы по темам (отдельно «Цены», «Программы», «Условия») — так легче обновлять.