Как загрузить документы в базу знаний ИИ

Это отдельная функция от раздела «База знаний» (короткие ручные записи о продукте и ценах) - подробнее о разнице ниже, в разделе «Частые подвопросы».

Как это работает

1. Вы загружаете документ - текстом (вставить в поле) или файлом .md/.txt.
2. Strelo сразу сохраняет исходный текст и делит его на части (чанки) по смыслу - это быстро, документ появляется в списке со статусом «Обрабатывается».
3. Фоновый воркер по очереди считает вектор для каждой части. Прогресс виден в списке как счетчик «готово N из M частей».
4. Когда все части посчитаны - статус меняется на «Готово». Документ становится доступен ИИ для поиска.
5. В ноде «AI Ответ» (и в веб-чате, и в Telegram) при ответе пользователю ИИ ищет среди готовых документов несколько наиболее подходящих по смыслу фрагментов и подмешивает их в контекст ответа. Большая база документов досчитывается постепенно, за несколько проходов фонового воркера - это нормально, не ошибка. Если у Google-аккаунта временно кончилась квота на векторизацию, обработка не срывается и не теряет прогресс - просто продолжится с того же места, как только квота освободится.

Пошагово

Шаг 1. Загрузить документ

1. В боковом меню откройте «База знаний: документы».
2. Нажмите «Загрузить документ».
3. Впишите название (для себя - в поиске ИИ оно не участвует) и вставьте текст документа, либо прикрепите файл .md/.txt.
4. Нажмите «Загрузить». Документ появится в списке со статусом «Обрабатывается».

Шаг 2. Дождаться обработки

Обновите страницу или подождите - счетчик «готово N из M» растет по мере того, как фоновый воркер считает вектора. Для небольшого документа (несколько страниц) это обычно занимает от нескольких секунд до нескольких минут. Для очень больших документов - дольше, воркер работает пачками, чтобы не заблокировать очередь других клиентов.

Шаг 3. Включить базу знаний в ноде «AI Ответ»

1. Откройте нужный сценарий в конструкторе, кликните по ноде «AI Ответ».
2. Убедитесь, что общий тумблер «Память и база знаний (RAG)» включен - без него ИИ не читает вообще никакой сохраненный контекст.
3. Включите тумблер «Использовать базу знаний» (по умолчанию включен, если в проекте есть хотя бы один готовый документ).
4. Опубликуйте сценарий. Тумблер и сама база знаний работают одинаково для канала Telegram и канала «Веб-чат» - привязка идет к рабочему пространству, а не к конкретному боту или сайту.

Шаг 4. Переиндексировать при необходимости

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

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

Чем это отличается от раздела «База знаний» с короткими записями?

Существующий раздел «База знаний» (страница «Память продукта») - это короткие ручные факты вроде «Тариф Pro - 2990 руб./мес.». Он подходит для цен, условий, отдельных пунктов FAQ. «База знаний: документы» - для целых текстов: договоров, инструкций, длинных регламентов, которые неудобно дробить на записи вручную. Обе базы работают вместе в ноде «AI Ответ» и дополняют друг друга - используйте короткие записи для точечных фактов, документы - для объемных текстов.

Можно ли загрузить PDF или Word?

В текущей версии - нет, только текст (вставить вручную) или файлы .md/.txt. Поддержка PDF и DOCX запланирована позже.

Что делать, если статус документа - «Ошибка»?

Часть содержимого не удалось векторизовать (например, из-за нестандартных символов). Остальные части документа при этом уже готовы и участвуют в поиске. Нажмите «Переиндексировать» - Strelo повторит попытку по всем частям заново.

Документ долго висит в статусе «Обрабатывается» - это нормально?

Да, если документ большой или в очереди много документов от разных проектов - фоновый воркер обрабатывает частями, чтобы честно делить ресурс между всеми клиентами. Счетчик «готово N из M» должен расти при каждом обновлении страницы; если он не растет много часов подряд - обратитесь в поддержку.

ИИ все равно не использует загруженный документ

Проверьте по порядку: документ в статусе «Готово» (не «Обрабатывается» и не «Ошибка»); в ноде «AI Ответ» включен общий тумблер «Память и база знаний (RAG)»; включен тумблер «Использовать базу знаний»; вопрос пользователя действительно связан по смыслу с содержимым документа - поиск идет по семантической близости, а не по точным словам.

Если не получается

• Документ загружен, но статус не меняется с «Обрабатывается». Дайте фоновому воркеру время (для больших документов - до нескольких минут на прогон); если счетчик «готово N из M» не растет вообще - обратитесь в поддержку.
• Статус «Ошибка» у документа. Нажмите «Переиндексировать» на карточке документа - это пересчитает все части заново из сохраненного текста.
• ИИ отвечает без опоры на документ. См. «Частые подвопросы» выше - проверьте оба тумблера в ноде «AI Ответ» и статус документа.
• Не вижу раздел «База знаний: документы» в меню. Обновите страницу; если раздел не появился - обратитесь в поддержку.

Лимиты и тариф

• Загрузка документов и работа фонового воркера доступны без ограничения по числу документов в v1.
• Формат документа в v1 - текст или файл .md/.txt; PDF/DOCX не поддерживаются.
• При каждом ответе ИИ подтягивает не более 5 наиболее релевантных частей документов, как и в остальных источниках памяти ноды «AI Ответ».