Двуязычная база знаний — это не две независимые папки с переводами. У каждого ответа должна быть одна смысловая сущность, владелец, исходная версия, статус локализаций и дата следующей проверки. Русский и кыргызский тексты могут формулироваться естественно по-разному, но обязаны совпадать в фактах, ограничениях, цене и следующем действии.
Качество локализации измеряется не буквальной похожестью, а тем, получает ли клиент на каждом языке одинаково правильный и полезный результат.
Единица базы знаний — проверяемый ответ
Не начинайте с дерева разделов. Сначала соберите реальные вопросы клиентов и решения операторов. Одна статья должна отвечать на одну задачу: как оплатить, как изменить заказ, что подготовить для подключения, как действовать при ошибке. Для каждой сущности храните:
- уникальный идентификатор, который не зависит от языка;
- заголовок и варианты поисковых формулировок;
- краткий прямой ответ;
- пошаговую инструкцию и ограничения;
- владельца фактов и редактора языка;
- источник, версию, дату проверки и срок следующего пересмотра.
Кто за что отвечает
Владелец фактов подтверждает процесс, цену, сроки и ограничения. Редактор отвечает за понятную структуру русского оригинала. Кыргызский редактор создаёт естественную локализацию и отмечает терминологические решения. Поддержка сообщает о непонятных местах на основе реальных диалогов. AI Quality Manager допускает материал в источники Joop AI только после проверки версии и тестовых вопросов.
Один человек может совмещать роли в небольшой компании, но решения всё равно фиксируются отдельно.
Редакционный workflow
- Черновик: вопрос, прямой ответ, шаги и источник фактов.
- Экспертная проверка: владелец процесса подтверждает содержание.
- Локализация: редактор создаёт кыргызскую версию по смыслу.
- Сверка: числа, условия, ссылки и предупреждения сравниваются по полям.
- Публикация: обе готовые версии получают дату и владельца.
- Наблюдение: неудачные поиски и эскалации создают задачи на улучшение.
- Пересмотр: изменение продукта автоматически возвращает зависимые статьи на проверку.
Как управлять терминологией
Создайте небольшой глоссарий: официальный термин, допустимый разговорный вариант, нежелательный вариант и пример. Не переводите названия кнопок, если интерфейс клиента показывает их иначе; лучше указать реальную подпись и пояснение. Для новых терминов фиксируйте решение один раз, а не спорьте заново в каждой статье.
Не смешивайте языки ради технического впечатления. Заимствование допустимо, когда оно привычно аудитории или обозначает точное имя функции, но рядом должен быть понятный смысл.
Проверка качества перед публикацией
- одинаковы ли суммы, сроки, лимиты и обязательные условия;
- совпадает ли порядок действий и результат;
- нет ли на одном языке дополнительного обещания;
- все ли ссылки ведут на соответствующую локализованную страницу;
- может ли новый оператор выполнить инструкцию без устного пояснения;
- отвечает ли текст на реальный вопрос в первых двух абзацах.
Подготовка базы для AI
AI не исправляет противоречивую базу, а масштабирует её проблемы. В retrieval допускайте только утверждённые версии, сохраняйте язык, источник и дату, не смешивайте документы разных компаний. Черновик должен показывать цитаты, а отсутствие подтверждённого ответа — приводить к handoff, а не к догадке.
Метрики базы знаний
- доля вопросов, для которых найден полезный материал;
- запросы без результата и частые переформулировки;
- доля статей с просроченной проверкой;
- эскалации после использования статьи;
- исправления операторов в AI-черновиках по каждому источнику;
- разрыв качества между русским и кыргызским на одном eval-наборе.
Частые вопросы
Нужно ли сначала написать всё по-русски?
Русский может быть редакционной основой, но кыргызская версия должна создаваться как полноценный текст, а не публиковаться без проверки машинного перевода.
Можно ли публиковать только один язык?
Можно, если честно обозначить доступность и не создавать пустую страницу второго языка. Для критических инструкций лучше планировать локализацию до запуска.
Подходит ли база знаний сразу для AI?
Только после версионирования, проверки источников, разграничения доступа и тестирования вопросов на каждом языке.
Методология
Материал описывает редакционный процесс Joop.kg: единая смысловая сущность, отдельные локализации, экспертная проверка и измеряемый цикл обновления. Для пилота выберите 20–30 самых частых вопросов, а не пытайтесь сразу описать всю компанию.