CLI Lingo.dev связывает вашу кодовую базу с движком локализации через одно поле в конфигурации. Каждый вызов lingo.dev run проходит через ваш движок, автоматически применяя тональность бренда, глоссарий, инструкции и конфигурацию модели. Никаких изменений в коде и никаких новых зависимостей.
Что изменится#
| До | После | |
|---|---|---|
| Пайплайн перевода | Стандартный пайплайн Lingo.dev | Ваш движок локализации |
| Тональность бренда | Нет | Применяется для каждой целевой локали |
| Глоссарий | Нет | Подбирается семантически для каждого запроса |
| Инструкции | Нет | Применяются для каждой целевой локали |
| Выбор модели | По умолчанию в Lingo.dev | Ваша конфигурация модели с резервными вариантами |
| Проверка качества | Нет | Настроенные AI-оценщики запускаются автоматически |
Настройка#
Добавьте engineId в i18n.json (необязательно)
Чтобы использовать конкретный движок, добавьте поле engineId в конфигурацию i18n.json. ID вашего движка можно найти в панели управления — он начинается с eng_ (например, eng_SxjMwMsfOIsvV1wh).
{
"version": "1.15",
"locale": {
"source": "en",
"targets": ["es", "fr", "de"]
},
"buckets": {
"json": {
"include": ["[locale]/messages.json"]
}
},
"engineId": "eng_SxjMwMsfOIsvV1wh"
}Все остальные параметры конфигурации остаются без изменений: исходная локаль, целевые локали, бакеты. Если не указывать engineId, CLI будет использовать движок по умолчанию в вашей организации.
Укажите API-ключ
CLI проходит аутентификацию с помощью API-ключа Lingo.dev. Задайте его как переменную окружения:
export LINGO_API_KEY="your-api-key"Или сохраните его в ~/.lingodotdevrc:
[auth.vnext]
apiKey = your-api-keyСоздайте API-ключ на странице API Keys в панели управления.
Запустите перевод
lingo.dev runCLI отправляет запросы на перевод в ваш движок и записывает результаты обратно в файлы локалей, автоматически применяя тональность бренда, глоссарий, инструкции и конфигурацию модели.
Справочник по конфигурации#
i18n.json#
| Поле | Описание |
|---|---|
engineId | Необязательно. ID вашего движка (eng_...). Если поле не указано, используется движок по умолчанию в вашей организации. |
Все остальные поля i18n.json (version, locale, buckets) работают так же, как и в стандартной конфигурации CLI.
Переменные окружения#
| Переменная | Обязательно | По умолчанию | Описание |
|---|---|---|---|
LINGO_API_KEY | Да | - | Ваш API-ключ Lingo.dev |
LINGO_API_URL | Нет | https://api.lingo.dev | Пользовательский базовый URL API (для self-hosted или staging) |
Что ожидать#
Каждый перевод, который создаёт CLI, проходит через полный пайплайн вашего движка:
- Тональность бренда задаёт тон и уровень формальности для каждой локали
- Элементы глоссария обеспечивают точность терминологии за счёт семантического сопоставления
- Инструкции применяют языковые правила с учётом конкретной локали
- Конфигурации моделей выбирают подходящую LLM с автоматическими резервными вариантами
- AI-оценщики автоматически оценивают качество после каждого запроса
Переводы отображаются в Reports с типом триггера api — вместе с запросами из API и интеграций.
