База знаний: обзор
База знаний — центральный компонент AI-агента: она дает агенту информацию о бизнесе и данные о товарах, которые нужны для обслуживания клиентов. В этом гайде вы наполните ее источниками, привяжете к ассистенту и проверите, что агент читает перед ответом.
Прежде чем начать, вам понадобятся ассистент продаж (первый создается во время онбординга и настраивается на странице Agents, см. Создайте своего первого AI-агента), активная подписка, если вы добавляете новую базу знаний кнопкой +, и подготовленный контент: публичная ссылка на фид (XML, YML или TXT), нативная Google-таблица, нативные Google Docs, страницы сайта или файлы.
Типы базы знаний
Каждый ассистент привязан к одной базе знаний. У каждой базы знаний два раздела:
- Знания о бизнесе (раздел Business Knowledge): операционная информация, которую обычно знают менеджеры и персонал. Источники: FAQ, Business Documents, Business Files, Business Links.
- Знания о товарах (раздел Product Inventory): ваш каталог. Источники: Products (каталог, который вы ведете в приложении), Product Feed, Product Spreadsheet, Product Files.
Только Product Feed, Product Spreadsheet, Products и товары из Instagram (настраиваются в разделе Channels) попадают в поисковый индекс товаров, где агент может фильтровать. FAQ, Business Documents и загруженные файлы — фоновые знания, которые агент читает, когда отвечает. Business Links не индексируются: страницы загружаются с вашего сайта тогда, когда этого требует вопрос.
Настройка базы знаний по шагам
- Откройте Knowledge Base в приложении (страница называется Knowledge). Выберите базу знаний среди карточек вверху или добавьте новую кнопкой +, до 10 на аккаунт.
- В разделе Business Knowledge подключите FAQ для типовых вопросов, Business Documents для нативных Google Docs, Business Files для загрузки файлов (до 15 файлов, до 7 МБ каждый) или Business Links для страниц сайта.
- В разделе Product Inventory нажмите Connect на источнике. Для Product Feed укажите Product Feed URL и нажмите Connect. Для Product Spreadsheet предоставьте доступ к Google Drive, воспользуйтесь Pick file, нажмите Preview, исправьте колонки со статусом Not mapped в Map Spreadsheet Columns (ID и Product Name обязательны) и нажмите Confirm & Connect.
- Дождитесь на карточке статуса Complete – N products и сверьте Loaded products и Total categories со своим каталогом.
- Откройте Agents на боковой панели (страница Agent configuration), разверните Toolkit и выберите базу знаний в выпадающем списке блока Knowledge. Выбор сохраняется сразу.
- В Editor откройте панель Context, введите типичное сообщение клиента и проверьте, какие фрагменты знаний возвращаются. Затем задайте тот же вопрос в Test dialog; его ответы учитываются в лимите AI-сообщений вашего тарифа.
Важные параметры
Диалоги подключения Product Feed и Product Spreadsheet содержат одинаковый набор параметров:
- Feed language: язык, ближайший к описаниям товаров, чтобы поиск учитывал словоформы. Задается при подключении, как и Index images; чтобы изменить любой из них, подключите источник заново.
- Enable auto-update (включено по умолчанию): синхронизирует источник примерно раз в час.
- Index images (включено по умолчанию): строит индекс для поиска по изображению.
- Agentic Search (выключено по умолчанию): пошаговый поиск для сложного подбора товаров.
- Notify in Telegram on error (включено по умолчанию): уведомляет вашу Telegram-группу, если автообновление не удалось.
В блоке Knowledge конфигурации ассистента переключатель Strip knowledge base results from history сокращает количество входных токенов на больших каталогах. Оставьте его выключенным, если сценарий рассчитывает на повторное чтение прежних результатов поиска.
Типичные проблемы и как их исправить
- Агент отвечает по загруженным файлам, но не фильтрует товары. Файлы — это фоновые знания. Загрузите каталог как Product Feed, Product Spreadsheet или Products.
- Таблица не подключается. Используйте нативную Google-таблицу, а не XLSX-файл в Drive, и сопоставьте колонки ID и Product Name.
- Импорт завершается ошибкой. Из-за дубликатов ID не проходит весь импорт, поэтому дайте каждому товару уникальный id.
- Все товары попадают в одну категорию. Добавьте категории в фид, обычно через поле product_type. Если фид с категориями все равно сводится к одной, обратитесь в поддержку MyChatBot.
- Импорт завис. Нажмите Refresh на источнике, а затем импортируйте его повторно.
- Карточки товарных источников заблокированы. У ассистента, который использует эту базу знаний, активна интеграция Altegio.