Назад в блог

Reliability · 19 авг. 2026 г.

Защита плейсхолдеров, ссылок и идентификаторов в AI-переводе

Беглого текста недостаточно, если измененный токен может сломать страницу. Процессы перевода должны защищать функциональный контент до начала генерации.

Защита плейсхолдеров, ссылок и идентификаторов в AI-переводе

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

Переменные, URL, идентификаторы записей, ссылки на ресурсы, примеры кода и маркеры форматирования несут функцию, а не прозу. Модель может создать естественно звучащее предложение, при этом незаметно изменив один из этих элементов и нарушив связанный с ним пользовательский опыт.

Надежный AI-перевод начинается с отделения языка от структуры.

Определяйте защищенный контент до промпта

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

Защищенный контент обычно включает:

  • переменные интерполяции, такие как {first_name} или {{ total }}
  • синтаксис сообщений ICU и селекторы множественного числа
  • URL, адреса электронной почты и фрагменты маршрутов
  • HTML-атрибуты и адреса ссылок в markdown
  • ссылки на записи и ресурсы Contentful
  • встроенные фрагменты кода, огражденные блоки кода и значения API
  • названия продуктов, помеченные как непереводимые

Модель контента и тип поля должны помогать определять правила защиты. Документ rich text требует структурной обработки, отличающейся от обработки обычного текстового заголовка.

Заменяйте рискованные значения стабильными токенами

Для обычных строк один из надежных подходов — извлечь защищенные значения и заменить их однозначными временными токенами перед переводом.

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

Токены должны быть уникальными, трудно спутываемыми с естественным языком и проверяемыми перед восстановлением. Никогда не доверяйте модели воспроизводить само отображение.

Переводите rich text как структуру

Преобразование дерева rich text в markdown или HTML может стереть важные различия.

Текстовые узлы подлежат переводу. Ссылки, встроенные записи, типы узлов и маркировки являются структурными элементами. Обходите дерево документа, переводите подходящие текстовые листья и заново собирайте исходную иерархию, не затрагивая ссылки.

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

Проверяйте результат перед сохранением

Защита требует замкнутого цикла.

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

Полезные ошибки конкретны:

  • отсутствует плейсхолдер {total}
  • изменен адрес ссылки в поле ctaBody
  • недопустимый синтаксис ICU в локали de
  • неожиданное количество узлов rich text

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

Показывайте защищенные элементы при проверке

Проверяющие должны иметь возможность распознавать функциональный контент, не отвлекаясь на него.

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

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

Тестируйте на состязательных примерах

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

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

Главное

Качество перевода включает функциональную целостность.

Извлекайте защищенный контент, переводите только подходящий язык, сохраняйте структуру rich text, проверяйте результат и делайте функциональные элементы понятными во время проверки. Беглое предложение ценно только тогда, когда страница по-прежнему работает после публикации.