Команда DevRel в Битрикс24 разработала сервис DocFlow для автоматизации перевода технической документации с русского на английский язык. Система призвана минимизировать ручную доработку текстов техническими писателями, превращая процесс перевода в управляемый конвейер, который самостоятельно разбирает файлы, переводит нужные части и проверяет результат.
Чтобы ИИ не нарушил структуру документа, разработчики внедрили детерминированный слой правил и проверок. Система использует плейсхолдеры вида [[PROTECTED_0]], чтобы скрыть от модели чувствительные элементы: методы API, примеры кода, ссылки и служебную разметку в формате YFM (Yandex Flavored Markdown). Оригинальные фрагменты сохраняются в памяти и возвращаются на свои места после перевода.
Сервис обрабатывает сложные элементы отдельно: он извлекает русские фрагменты из кода на JavaScript, PHP и JSON, переводя только значения внутри строк, чтобы не затронуть синтаксис. Таблицы разбираются на ячейки, где переводится только текст, а служебные символы разметки (#|, ||, |#) остаются неизменными. Для единообразия и снижения затрат используются кэш готовых переводов и глоссарий терминов.
Для обеспечения воспроизводимости перевода моделью установлена температура 0. В систему интегрированы валидатор и набор «фиксеров» для исправления типичных ошибок. Например, CellTypeFixer восстанавливает строки с типами данных в ячейках YFM по оригиналу. Если система обнаруживает потерю плейсхолдера после перевода, модель получает повторный запрос на восстановление утраченного элемента.
