Как это работает
Проследите путь изменения контента: от исходника через сохранённые рекомендации по переводу до результата, который вы можете использовать и проверить.
Когда вы пишете и редактируете контент, вы решаете, что должны понять читатели, что стоит объяснить подробнее и какие доводы их убедят. Перевод должен так же точно передавать смысл и то, в чём вы хотите убедить читателей, на другом языке. Lingo.dev переводит контент с помощью языковых моделей, опираясь на сохранённые рекомендации о вашем продукте, терминологии и тональности бренда.
Вы передаёте исходный контент, указываете нужные языки и выбираете движок локализации для перевода. При вызове API движок указывают с помощью engineId. CLI или интеграция используют движок локализации, выбранный в конфигурации. От этого выбора зависят модели и общие рекомендации, доступные для запроса. Переведённый контент возвращается через инструмент, который его запросил, а измерения качества и ручная проверка проходят по настроенным вами маршрутам.
Начните с контента и языка перевода #
Контент, который вы передаёте, — это исходник. Каждая переведённая версия — целевой вариант. Исходный контент может поступать из файла, структурированных данных приложения или подключённой системы управления контентом. Исходная и целевые локали в запросе определяют, с какого языка и на какие нужно перевести.
Локаль определяет язык, а при необходимости — регион или письменность. Явно указывайте аудиторию перевода: например, pt-BR в запросе задаёт бразильский вариант португальского, а не оставляет регион неуказанным. Исходная и целевые локали также помогают Lingo.dev подобрать подходящие рекомендации по переводу. Правила сопоставления описаны в разделе Определение локали.
Структура контента важна не меньше, чем язык. Приложение находит текст по ключам сообщений и подставляет значения с помощью переменных. В документе есть заголовки, ссылки и форматирование. При вызове API структурированные данные передаются напрямую. CLI и обработчики форматов извлекают текст для перевода из файлов и собирают переведённые версии. В любом случае контент должен вернуться в виде, с которым принимающая система сможет работать.
Сохраняйте версию исходника вместе с переводом — она пригодится, если позже понадобится разобраться в результате. Если автор изменит смысл, перевод, верный для предыдущей версии, может уже не передавать нужную мысль.
Сохраните знания для будущих запросов #
Языковая модель умеет работать с языком. Но сама по себе она не знает терминологию вашего продукта, требования, о которых договорилась команда, и то, как компания общается с читателями. Движок локализации хранит выбранные модели и ссылки на рекомендации, которые можно использовать повторно. Так каждый запрос может опираться на эти знания, и вам не нужно отправлять всё заново.
Разные виды рекомендаций отвечают на разные вопросы:
- Глоссарий хранит термины, их значения и предпочтительные формулировки, а также названия, которые не нужно переводить. Он помогает модели отличать понятие продукта от других значений того же слова.
- Набор правил содержит инструкции по переводу. В нём можно задать повторяющиеся требования, которые не выразить списком терминов, в том числе смысловые различия, которые нужно сохранить в переводе.
- Тональность бренда описывает, как компания общается с читателями, включая тон и степень формальности.
Глоссарии, наборы правил и варианты тональности бренда принадлежат вашей организации. Их можно подключать к нескольким движкам локализации. Связанные рабочие процессы могут использовать общую терминологию, а там, где нужно, — разные модели и тональность. Изменение общего ресурса может повлиять на все движки локализации, которые его используют, поэтому перед правкой рекомендаций проверьте, где он подключён.
Для каждого запроса Lingo.dev выбирает из указанного движка локализации подходящие термины глоссария, инструкции, вариант тональности и модели-кандидаты. В JSON-документе также можно передать format.options.context с описанием аудитории или назначения контента и format.options.hints для отдельных ключей. Так вы можете хранить общие знания в движке локализации, а особенности конкретного контента пояснять в запросе. Подробнее об этих возможностях — в разделе Контекст перевода.
Значения по умолчанию в форме создания #
В форме создания в веб-приложении заданы следующие значения по умолчанию. Прежде чем завершить создание, вы можете изменить модели и выбрать существующие рекомендации.
| Настройка | Значение по умолчанию в форме |
|---|---|
| Модели | Рекомендуемые основная и резервная модели используются для всех пар локалей. Вы можете изменить модели или отдельно настроить конкретную пару. |
| Глоссарии, наборы правил и тональность бренда | По умолчанию ничего не подключено. Выберите существующие ресурсы при создании или подключите их позже. |
| Пайплайн | Только перевод. Необязательные этапы переработки текста и ручной проверки по умолчанию отключены. |
| Оценка соблюдения глоссария и инструкций, предложения | Автоматическая оценка, создание предложений и их автоматическое применение по умолчанию отключены. |
У существующих движков локализации могут быть другие сохранённые настройки. Проверьте движок, который будет использоваться при вызове, — не полагайтесь на то, что его конфигурация всё ещё совпадает со значениями по умолчанию. Выбор моделей и подключение ресурсов описаны в разделе Как создать и настроить движок локализации.
Создайте перевод и верните его вызывающей стороне #
Выбранная языковая модель получает исходник и подходящий контекст. Если первая настроенная модель не может выполнить запрос, движок локализации может попробовать резервную. Резервная модель даёт ещё одну попытку, а не сравнивает два перевода, чтобы выбрать вариант с более высокой оценкой качества.
При работе с API вы создаёте и запускаете задание на перевод, а затем скачиваете готовые целевые варианты. В JSON-результате сохраняются ключи сообщений документа, а приложение решает, где его хранить или использовать. В CLI команды push и pull выполняют этот рабочий процесс с файлами за вас. У каждой интеграции свой способ записи результата, например создание пул-реквеста с переводом. В разделе Интеграции описано, какие данные читает и записывает каждое подключение.
Структура результата позволяет использовать перевод в дальнейшей работе. Проверьте, может ли приложение загрузить каталог, подставить значения переменных или отобразить ссылки и форматирование документа. Эти проверки показывают, что принимающая система может использовать результат. Для оценки качества языка нужны другие данные.
Проверьте результат в рабочем процессе, где он используется #
Выбирайте измерения с учётом того, что важно для вашего контента. Чтобы проверить сохранение смысла, нужны исходник, перевод и достаточно контекста, чтобы понять замысел автора. Для проверки орфографии может хватить одного перевода. Разные вопросы требуют разных данных. Результат полезен, когда вы видите, что именно проверялось, и можете изучить фрагмент, на котором основан ответ.
Пайплайн движка может включать ручную проверку до выдачи окончательного результата задания. В разделе Политика проверки описано, что охватывает проверка, как она направляется и что происходит при истечении времени ожидания. Готовый целевой вариант мог миновать проверку или пройти дальше после истечения времени ожидания. Независимые измерения качества выполняются отдельно, поэтому завершение перевода не означает, что отчёт о качестве готов или что человек одобрил перевод.
Измерения подходят и для переводов, созданных вне Lingo.dev. Вы можете сохранить существующую систему генерации и найти поддерживаемый способ проверки её результатов в разделе Измерение. Измерение отвечает на конкретный вопрос о переданном тексте, а ваша команда решает, что этот результат означает для дальнейшего использования перевода.
Если проверка выявила повторяющуюся проблему с терминологией, исправьте текущий перевод и отдельно подумайте, стоит ли изменить глоссарий или инструкции для будущих задач. Обновление общих рекомендаций не переписывает все предыдущие переводы. В разделе Предложения описано, как обрабатываются предложенные изменения рекомендаций.
Чтобы переводить контент из приложения, выполните первый запрос к API. В этом руководстве вы пройдёте весь путь на небольшом объёме данных: от настройки и перевода до проверки сохранённого файла с результатом. Если исходники уже хранятся в файлах, краткое руководство по CLI покажет путь работы с ними вплоть до получения переводов.