AI-агент не должен сам решать, какой документ важнее, можно ли использовать старую презентацию и где заканчиваются его полномочия. Эти правила фиксируются до prototype.

Business situation

Команда хочет собрать AI-агента и часто начинает с действия: загрузить в платформу все документы, которые нашлись в Drive, Notion, PDF и старых презентациях. Это быстрый путь к красивому prototype, который отвечает уверенно, но неясно на чём основан.

Prepare Knowledge Base решает подготовительный слой. Страница показывает, как превратить разрозненные материалы в рабочую основу для Knowledge Pack: что можно использовать, что нельзя, где источники конфликтуют и какие вопросы проверят качество.

What you need before building an agent

До сборки агента нужны не все документы компании, а минимальный набор под один сценарий. Для Voice Lead Intake это могут быть описание услуг, FAQ, правила квалификации заявки, pricing boundaries, escalation rules и approved answers.

Главная развилка простая:

  • если вы хотите понять понятие, читайте Knowledge Pack;
  • если вы хотите подготовить документы, начинайте с Prepare Knowledge Base;
  • если вы собираете голосового агента, переходите к Voice Lead Intake.

Source Inventory Template

Source Inventory Template — первый рабочий шаблон перед Knowledge Pack. Он нужен, чтобы источник был не просто файлом, а управляемым элементом с владельцем, статусом и правилами использования.

Заполняйте по одному источнику:

source title: название документа или страницы
owner: кто отвечает за актуальность
status: approved / draft / outdated / forbidden / needs_review
priority: primary / secondary / fallback
freshness: дата review и допустимый срок обновления
risks: где источник может создать ошибку или overclaim
approved claims: какие формулировки агент может использовать
forbidden claims: что нельзя говорить без review
update frequency: когда источник нужно проверять снова

Шаблон связан с Source Evidence Policy: если source делает vendor-specific или freshness-sensitive claim, ему нужен status и review trail. Он также связан с RAG Quality: каждый eval scenario должен проверять, нашёл ли агент правильный source и что он сделал при gap, conflict или outdated answer.

После первой проверки findings переходят в RAG Quality Report: issue, evidence, severity, recommended fix, owner и status.

Step-by-step guide

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

Только после этого имеет смысл думать о платформе. Dify, AnythingLLM или другой tool могут ускорить prototype, но они не решают, какой источник прав, где нужна передача человеку и какие обещания запрещены.

Required documents

Минимальный checklist:

  • company profile / профиль компании;
  • services / услуги;
  • FAQ;
  • pricing boundaries / границы ценовых обещаний;
  • support rules / правила поддержки;
  • lead qualification fields / поля квалификации заявки;
  • approved claims / разрешённые утверждения;
  • forbidden claims / запрещённые утверждения;
  • escalation rules / правила передачи человеку;
  • source priority / приоритет источников;
  • eval questions / проверочные вопросы.

Source priority

Source priority отвечает на вопрос: какой документ главнее, если материалы конфликтуют. Например, актуальная service policy может быть выше старой презентации, а approved pricing note — выше текста из commercial proposal draft.

Если приоритет не задан, агент будет выбирать источник по случайной близости текста. Это не decision-making, а лотерея с уверенным голосом. Поэтому conflict должен вести к human review или к явному правилу приоритета.

Eval questions

Проверочные вопросы нужны до production. Они показывают, где база знаний покрывает сценарий, а где агент должен остановиться.

Минимальный набор:

  • вопрос, который точно покрыт approved source;
  • вопрос без источника;
  • вопрос с конфликтом источников;
  • вопрос про цену или срок;
  • просьба выполнить external action;
  • запрос, который должен уйти в Operator Handoff.

Common mistakes

Типовая ошибка — загрузить слишком много материалов и назвать это базой знаний. Вторая ошибка — не отделить approved source от draft. Третья — забыть forbidden claims, а потом удивляться, что агент обещает цену, срок или действие, которых никто не утверждал.

Хорошая подготовка выглядит скучнее: меньше документов, больше статусов, владельцев, дат и проверочных вопросов. Зато после этого prototype можно обсуждать предметно.

DIY path

Для самостоятельной подготовки выберите один сценарий и сделайте первый пакет за 1–2 рабочих сессии:

  1. Опишите задачу агента одним абзацем.
  2. Соберите 10–30 источников под этот сценарий.
  3. Разделите их на approved, draft, outdated, forbidden.
  4. Выпишите 10–20 проверочных вопросов.
  5. Отметьте, где агент должен сказать «данных недостаточно».
  6. Передайте результат в Knowledge Pack.

When to ask AI-Ready

AI-Ready имеет смысл подключать, когда документов много, источники конфликтуют, сценарий затрагивает клиентов или у команды нет времени отдельно проектировать answer policy, source priority, handoff и eval questions.

В таком случае работа начинается не с выбора tool, а с карты процесса: какой сценарий автоматизируется, какие источники утверждены, где агент останавливается и как проверяется качество.

Prepare Knowledge Base отвечает на вопрос «как собрать материалы». Knowledge Pack отвечает на вопрос «что такое утверждённый пакет знаний». Voice Lead Intake показывает, как этот пакет используется в первом голосовом сценарии.