От нуля до работающего AI-продукта с оплатой за 10 недель — Рома РайтРаздел 11 · урок 1 из 5
12345уроки раздела 11
Раздел 11. Встроенная база знаний, сдача проекта клиенту, договоры и упаковка кейса

Встроенная база знаний и контекстная справка — генерация ролевых гайдов агентом

≈ 6 минРома Райт

Представь утро понедельника на фулфилмент-складе после запуска новой ERP. На смену выходит новый кладовщик: перед ним открыт экран приёмки, нужно срочно принять поставку и напечатать этикетки, а он не понимает, какой статус выбрать. Если на экране есть иконка «?», сотрудник за минуту открывает пошаговый регламент под свою роль и закрывает задачу сам; если справки нет — через пять минут он звонит управляющему, а управляющий пишет тебе.

Даже в Yoolip.ai, где интерфейс кажется мне очевидным, новые пользователи каждый день задают одни и те же базовые вопросы просто потому, что не знают логику продукта. У создателя вся схема в голове, а у команды заказчика — чистый лист. Сдать систему без встроенной документации значит подписаться на бесконечные созвоны с объяснением кнопок.

Почему внешние инструкции в Google Docs никто не читает и зачем встраивать базу знаний внутрь продукта

Классическая ошибка после разработки — накидать ссылку на Google Docs и отправить руководителю в чат. В реальной работе документ теряется в переписке на второй день, а через пару недель после правок интерфейса ещё и устаревает. Когда вопрос возникает посреди смены, никто не пойдёт искать файл на диске.

Поэтому база знаний — обязательная часть любого B2B-продукта с несколькими ролями. Она должна отвечать на семь прикладных вопросов прямо внутри интерфейса:

  • как устроена конкретная страница и за что отвечает каждый блок;
  • что означает каждый статус заказа, поставки или счёта;
  • как завести нового клиента, товар, заявку или коммерческое предложение;
  • в какой последовательности выполнять ежедневные операции;
  • что делать при возникновении типовой ошибки;
  • где смотреть ключевую информацию и финансы;
  • какие системные ограничения действуют на этом этапе.

Писать десятки статей руками с нуля не нужно. Claude Code уже знает карту страниц, схему базы данных и бизнес-логику приложения, поэтому за один прогон собирает основу всей базы примерно за полчаса.

Генерация ролевых пользовательских гайдов из исходного кода: промпт для Claude Code

Сначала спланируй движок базы знаний в Claude Cowork и передай план в Claude Code, причём не пиши текстовый редактор с нуля — встрой готовое решение вроде Tiptap с поддержкой Markdown. Разметка Markdown сразу даёт заголовки, списки, ссылки, вставку скриншотов и видеоуроков.

Когда раздел создан, запускаем наполнение. В качестве эталона структуры удобно взять публичную справку сервиса WEEEK, где статьи аккуратно разбиты по категориям и легко читаются. Ниже — базовый запрос для Claude Code в корне проекта (при желании в режиме /goal), чтобы агент сам обошёл все экраны и написал гайды.

Изучи карту страниц (Site Map), документацию в docs/ и исходный код всех роутов приложения для каждой роли: управляющий, менеджер, упаковщик и селлер (клиент).

Твоя задача:
1. Составь полный список рабочих функций и страниц для каждой роли.
2. Сгенерируй подробные статьи в формате Markdown для встроенной базы знаний по каждой функции (ориентир — минимум 30 статей).
3. Пиши понятным человеческим языком для сотрудника без технического бэкграунда: без терминов разработки, имен таблиц БД и английских названий моделей.
4. В каждой статье добавь: цель страницы, пошаговую инструкцию «1-2-3», пояснение статусов, блок «На что обратить внимание» и плейсхолдеры [СКРИНШОТ: описание экрана].
5. Распредели статьи по категориям и настрой права видимости по ролям, чтобы внешние клиенты не видели внутренние регламенты склада и финансов.
6. Загрузи статьи в локальную базу данных и выведи итоговый список по ролям.

Обрати внимание на запрет технического сленга: иначе агент вываливает в справку имена таблиц из Drizzle или Prisma, которые менеджеру ни о чём не говорят. Плейсхолдеры сразу размечают места, куда потом легко вставить реальные скриншоты — вручную или через Playwright.

После первого прогона открой статьи глазами пользователя. Если тексты вышли слишком сухими, не переписывай 30 гайдов руками: покажи агенту одну эталонную статью из WEEEK и попроси дотянуть все материалы до этого уровня. Заодно сразу проверь, чтобы в редакторе была возможность создавать, переименовывать и удалять категории — о ней на первой итерации часто забывают.

Автоскриншоты через Playwright требуют активной привязки тестового аккаунта

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

Архитектура раздела «База знаний» внутри ERP: категории по должностям, полнотекстовый поиск и чеклисты

Универсальная база знаний живёт в базе данных с поиском, фильтрацией и привязкой к URL. На старте зафиксируй четыре правила: кто редактирует статьи (обычно владелец или управляющий), какие роли какие разделы видят, какие форматы поддерживаются (Markdown, картинки, ссылки на короткие YouTube-инструкции) и где в меню лежит ссылка на раздел.

Самый чувствительный узел — разграничение прав. Упаковщику не нужна документация по финансам, а клиенту-селлеру нельзя показывать статьи «под капотом» про твой внутренний ДДС или админку. Если у роли в какой-то категории нет ни одной доступной статьи, саму категорию нужно полностью скрывать из меню.

Роль сотрудникаДоступные разделы справкиПримеры статейЧто строго скрыто
Управляющий и владелецВсе разделы и редактор базы знанийФинансы и ДДС, настройка прайсов, доступы, разбор баговНичего — полный доступ
МенеджерКлиенты, КП, поставки, коммуникацииСоздание расчёта, привязка Telegram-чата, счета, статусыСистемные настройки админки
Кладовщик и упаковщикСкладские операции, сканер, сменыПриёмка партии, сканирование, старт смены, расчёт выработкиФинансы, ДДС, база клиентов
Клиент (селлер)Кабинет, заявки, товары, магазинПодключение Ozon, создание заявки, правила маркировкиВнутренние регламенты и ДДС

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

Проверь каждую статью глазами клиента до переноса на прод

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

Контекстная иконка помощи (?) на каждом экране: мгновенный вызов инструкции для открытой страницы

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

Для этого к статье в базе данных привязывается целевой роут страницы, а в интерфейсе появляется иконка «?». По клику открывается модальное окно или боковая панель с инструкцией именно для текущего экрана:

Архитектура встроенной ролевой базы знаний: раздел /help с разграничением прав и контекстная кнопка помощи «?» по pageRoute.

  1. Привязка статьи к роуту — добавь в таблицу статей поле pageRoute (или массив маршрутов) для точного сопоставления со страницей.
  2. Размещение без конфликтов верстки — не бросай парящий знак вопроса в правый верхний угол, иначе он перекроет кнопки сохранения; выровняй его по правому краю чуть выше нижней кнопки быстрых действий.
  3. Запасной сценарий (Fallback) — если для редкой страницы ещё нет точечной статьи, кнопка «?» показывает список популярных инструкций для текущей роли.

Связка «раздел /help + контекстная помощь на каждом экране» снимает до 80% рутинных вопросов команды клиента. Проверь себя простым вопросом: если завтра на смену выйдет новый упаковщик или менеджер без созвона с тобой, найдёт ли он инструкцию на каждом рабочем экране и не увидит ли лишнего? Дальше разберём, как ускорить ежедневную работу сотрудников и забрать поток баг-репортов из лички внутрь системы.