Движок локализации — это stateful API перевода, который вы создаёте и настраиваете в Lingo.dev. Вместо того чтобы отправлять строки в универсальную LLM и надеяться, что результат оправдает ожидания, вы создаёте API, который стабильно выдаёт именно те переводы, которые вам нужны, — для любой локали и в каждом запросе.
Что делает движок локализации#
Каждый движок объединяет пять настраиваемых слоёв. Когда поступает запрос на перевод, движок автоматически применяет их все — без prompt engineering для каждого запроса и без ручного вмешательства.
| Слой | За что отвечает | Документация |
|---|---|---|
| LLM Models | Какая модель обрабатывает каждую пару локалей, с ранжированной цепочкой резервных вариантов | LLM Models → |
| Brand Voice | Как ваш продукт звучит на каждом языке — тон, формальность, стиль | Brand Voices → |
| Правила | Лингвистические соглашения для каждой локали, объединённые в наборы правил | Правила → |
| Glossary | Точные соответствия терминов для каждой локали с семантическим сопоставлением — это самый высокий приоритет в движке | Glossaries → |
| AI Reviewers | Автоматическая оценка с помощью независимой LLM после каждого перевода | AI Reviewers → |
Конфигурация принадлежит организации#
Глоссарии, наборы правил и тональность бренда принадлежат организации, а не конкретному движку. Движок подключает их через привязку — один глоссарий может управлять пятью движками, и одно изменение применится ко всем сразу. Конфигурации моделей хранятся на уровне движка.
| Контейнер | Содержит | |
|---|---|---|
| Glossary | Глоссарий | Термины |
| Правила | Набор правил | Правила |
| Brand Voice | Тональность бренда | Один текст на каждую целевую локаль |
Если удалить движок, все три объекта останутся нетронутыми. Удалить любой из них не получится, пока его использует хотя бы один движок — сначала отвяжите его.
Как взаимодействуют слои#
Движок применяет слои в заданном порядке, с чёткой иерархией приоритетов:
- Глоссарий — высший приоритет. Если термин из глоссария совпадает, он перекрывает решение модели.
- Правила — средний приоритет. Лингвистические соглашения для конкретной локали направляют модель.
- тональность бренда — задаёт общий контекст. Тон, формальность и стиль для локали.
Конфигурация модели определяет, какая LLM обрабатывает запрос, с автоматическим переключением на резервный вариант, если основная модель недоступна. AI-эвалюаторы запускаются асинхронно после завершения перевода — они никогда не блокируют ответ.
Дополняют друг друга, а не конкурируют
Глоссарий, правила и тональность бренда лучше работают в связке. Глоссарий фиксирует точные термины, правила задают соглашения конкретной локали, а тональность бренда определяет общий стиль. Если термин из глоссария противоречит правилу, побеждает глоссарий.
Задачи, отправленные через Async Localization API, также могут проходить через необязательный пайплайн — AI-предредактирование исходного текста, проверку человеком, AI-постредактирование и проверку дрейфа обратным переводом.
Настройки по умолчанию#
Когда вы создаёте новый движок, он уже предварительно настроен с моделью по умолчанию — основные модели и резервные варианты подобраны на основе трёх лет еженедельных исследований в области локализации и оптимизированы для высокого качества как на распространённых языках, так и на языках с ограниченными ресурсами. Большинству команд не потребуется ничего менять.
Настройки по умолчанию работают сразу — без лишних усилий. При этом вы можете изменить любую конфигурацию модели, сменить провайдера, добавить резервные варианты или переопределить отдельные языковые пары. Значения по умолчанию уже отражают то, что лучше всего показало себя на сотнях языковых пар. Новый движок изначально не привязан ни к глоссарию, ни к набору правил, ни к тональности бренда — подключите то, что уже есть в организации, или создайте новое по мере того, как будете понимать, что нужно продукту в каждой локали.
Как использовать движки#
Движки доступны во всех интеграциях Lingo.dev:
| Интеграция | Как подключается |
|---|---|
| CLI | Укажите engineId в .lingo/config.json — каждый lingo push будет проходить через ваш движок |
| API | Вызывайте endpoint localize с вашим API-ключом — движок автоматически применит все слои |
| CI/CD | Та же конфигурация CLI — переводы будут проходить через ваш движок в каждом pull request |
| MCP | AI-помощники для программирования могут настраивать и использовать движки прямо в ходе диалога |
Если вы не укажете engineId, будет использован движок по умолчанию в вашей организации.
Наблюдаемость#
Каждый запрос на перевод фиксируется в журнале: модель, токены, был ли задействован резервный вариант, какие термины глоссария и правила применялись. Отслеживайте производительность движка в Reports, а качество перевода — в AI Reviewers.
Тестируйте конфигурации движка до запуска в Playground — сравнивайте свой движок с исходной моделью или сопоставляйте два движка бок о бок.
