База знаний для ИИ‑агента: как подготовить данные

База знаний для ИИ начинается не с загрузки всех файлов подряд, а с выбора утверждённых источников. Агент должен понимать, где действующий прайс, кто меняет условия и что делать, если ответа нет. Непроверенный старый документ опаснее пустой базы: он даёт убедительный, но неверный ответ. На своих проектах я сначала связываю вопрос с источником и только затем разрешаю автоматический ответ.

В моих проектах сначала определяю владельца каждого документа и способ обновления. Для короткого прайса годится таблица или база, для большого архива нужен поиск по фрагментам с указанием источника. Сначала важнее владелец данных, версия и проверка. Для следующего шага пригодится материал про первого ИИ‑агента.

Какие документы включать в базу знаний

Соберите только материалы, которыми сотрудники уже имеют право пользоваться: действующий прайс, описание услуги, график, правила передачи сложных вопросов. Отложите черновики, переписки без контекста и документы с чужими данными. У каждого источника укажите дату обновления и человека, который утверждает изменения. Если два файла спорят о цене, решите конфликт до подключения агента. Технология поиска не способна сама выбрать, какое обещание компании действительно.

Как разделить факты и инструкции

Пример структуры показывает, что источник факта и правило поведения лежат отдельно:

knowledge/
  prices.md        # актуальные условия, владелец и дата
  services.md      # описание услуг
  handoff.md       # когда передать человеку
  checks.md        # контрольные вопросы и ожидаемые ответы

Факт отвечает на вопрос «какая цена» или «когда открыто». Инструкция определяет действие: уточнить услугу, передать человеку, не давать медицинский совет. Эти сущности стоит хранить отдельно. Обновление прайса сохраняет прежние правила поведения агента. Изменение правила передачи оставляет цены как были. Удобная структура помогает сотруднику быстро найти причину ошибки.

Как агент должен отвечать без данных

Пустой результат поиска или противоречивые сведения не дают права угадывать. Агент сообщает, что уточнит условие, и создаёт задачу ответственному. В интерфейсе желательно видеть источник использованного факта. Если ответ строится на нескольких документах, проверьте, относятся ли они к одному периоду и одной услуге. Старая цена в архиве не должна побеждать новую только потому, что сформулирована подробнее.

Как обновлять знания без расхождений

Назначьте единый источник для каждого типа данных. Прайс меняется в рабочем месте, затем попадает в индекс или подключённый поиск. После обновления старую версию нужно убрать из активной выдачи и повторить контрольные вопросы. Если на сайте одна цена, а в чате другая, архитектура не выдержала простого изменения. Регламент обновления должен быть коротким и понятным сотруднику, который не пишет код.

Как учитывать персональные данные и доступ

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

Как оценивать пользу базы знаний

Сравните ответы на одном наборе вопросов до и после подключения источников. Отмечайте точность, полноту, ошибочную уверенность и передачу человеку. Процент ответов без просмотра качества вводит в заблуждение. В моём проекте ИИ‑продавец встроен в цепочку обращений, поэтому знания оцениваются вместе со следующим действием: клиент получил ответ, а менеджер увидел, что делать дальше.

Где хранить знания для первого помощника

Небольшой список правил проекта можно держать в CLAUDE.md: какие папки есть, как запускать проверку и что агенту запрещено менять. Для ответов клиентам этот файл не подходит. Рабочие цены, услуги и расписание должны читаться из системы, где их обновляет ответственный сотрудник. Если фактов мало, достаточно таблицы или записей в базе данных. Большой архив документов можно искать по фрагментам, но каждый найденный фрагмент должен иметь ссылку на исходный документ и дату обновления.

Сначала соберите десять реальных вопросов. Для каждого укажите источник допустимого ответа. При расхождении документов назначьте владельца правила, который утвердит действующую версию. Когда сведений нет, корректный ответ сообщает об ограничении и передаёт вопрос человеку. Это можно проверить на выдуманной услуге: помощник не должен уверенно назвать её цену.

В строительном кейсе Radomir ИИ‑продавец отвечает на обращения с Авито и передаёт клиента менеджеру. Скриншот ниже показывает диалог, но не устройство хранения знаний. Для своего агента проверьте отдельно каждую связь: изменение в прайсе, ответ в переписке, запись в CRM и действие менеджера. Ошибка на любом шаге даёт клиенту устаревшее обещание.

Как это выглядит в работе

Если помощник использует поиск по документам, сохраняйте идентификатор найденного источника вместе с ответом. Это помогает разбирать спор: модель неверно прочитала актуальное правило или нашла старую версию. Первую базу знаний можно собрать на тестовых данных во время обучения, а запускать на клиентах после проверки доступа и обновлений.

Как принимать базу после обновления

Обновление документа ещё не означает обновления ответа. Возьмите вопрос, по которому раньше действовало старое правило, и задайте его агенту после изменения. Сохраните рядом исходный пункт, время обновления и ответ. Если в выдаче осталось старое значение, проверьте индекс поиска и кеш. Исторические документы помечайте как архивные, чтобы поиск не выдавал их наравне с действующими.

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

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

Сначала отберите действующие материалы и уберите персональные и устаревшие данные.

Нужна ли отдельная база данных?

Способ хранения зависит от объёма. Для первого сценария важнее качество источника и порядок обновления.

Что делать при противоречии документов?

Назначить ответственного, утвердить одну версию и убрать старую из активного поиска.

Как проверить ответ?

Сверить его с конкретным источником и посмотреть, какое действие агент сделал после ответа.

Как часто обновлять?

Каждый раз при изменении условий; контрольные вопросы помогают заметить устаревшую версию.

Что сделать дальше

Начните с одного источника, одного владельца и десяти проверочных вопросов. Если ответы расходятся после обновления, сначала исправьте путь данных. На живой встрече можно разобрать структуру базы для вашего помощника.