Как настроить пайплайн перевода
Сохраните настройки этапов движка перед запуском задания и проверьте, какие этапы действительно выполняются.
Задание локализации использует конфигурацию пайплайна движка, зафиксированную на момент запуска. Настройте движок перед вызовом /start. Дальнейшие изменения движка повлияют на будущие запуски, но не на сохранённую конфигурацию уже выполняющегося задания.
Откройте вкладку Пайплайн движка в Studio или обновите pipelineConfig через PATCH /v2/engines/:id. Вызывающей стороне нужны права на редактирование движка. Организации нужен доступ к возможностям, которые требуются для запуска соответствующих этапов. См. доступ к возможностям и тарифы.
Сохраните полную конфигурацию #
Прежде чем менять существующую конфигурацию, получите данные движка с помощью GET /v2/engines/:id. Отправка pipelineConfig полностью заменяет конфигурацию: для неуказанных этапов применяются настройки по умолчанию. Не забудьте включить настройки, которые хотите сохранить.
Этот запрос настраивает перевод с этапом перефразирования. Необязательные этапы, не указанные в запросе, отключены:
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}Используйте отдельный движок, если приложению нужны другие правила для определённой категории заданий. Настройте его модели и рекомендации, а затем указывайте его ИД при создании таких заданий.
Настройки этапов #
Поле в pipelineConfig | Настройки |
|---|---|
localize | enabled: true. Этап перевода обязателен. |
preEdit, rephrase, postEdit, backTranslation | enabled — логическое значение. По умолчанию — false. |
qualityGate | Логическое значение enabled и strictness: "strict", "medium" или "lax" (по умолчанию "medium"). |
humanEdit | enabled, timeoutHours — положительное целое число (по умолчанию — 48) и routes для проверки. |
contentLength | enabled и mode, описание см. ниже. |
Для постредактирования нужна ручная проверка: этот этап дорабатывает её результат. Если проверка пропущена или время ожидания истекло, дорабатывать может быть нечего.
Режимы длины контента: { "_tag": "noLongerThanSource" } (по умолчанию), { "_tag": "fixedCap", "maxColumns": 40 } или { "_tag": "matchSource", "tolerancePct": 10 }. Числовые значения должны быть положительными целыми числами. Это целевая ширина текста в экранных колонках, а не ограничения в байтах и не гарантия того, что текст поместится в интерфейсе.
Настройте маршруты ручной проверки #
Сначала создайте или выберите группы проверяющих. Каждая запись humanEdit.routes указывает группу, а также языки и каталоги, которые она охватывает. Эта конфигурация отправляет весь новый переведённый контент в одну группу:
{
"pipelineConfig": {
"localize": { "enabled": true },
"humanEdit": {
"enabled": true,
"timeoutHours": 48,
"routes": [
{
"pool": "YOUR_DECISION_POOL_ID",
"match": { "locales": [] }
}
]
}
}
}Пустой массив locales охватывает все языки. Добавьте "path": ["emails/**"] в match, чтобы охватить документы в этом каталоге: значение сопоставляется с key документа. В путях указываются точные имена каталогов, за которыми следует /**. Маршрут без path действует для всех каталогов. Более точные совпадения по каталогу и локали имеют приоритет. Конфликтующие маршруты отклоняются.
Чтобы проверять переводы выборочно, включите ручную проверку и добавьте маршрут для переводов, которые нужно проверить. Добавьте qualityGate внутри pipelineConfig, оставив остальные настройки без изменений:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}Вы можете сохранить qualityGate во включённом состоянии, даже если humanEdit.enabled имеет значение false. Studio сохраняет эту настройку, когда вы отключаете и снова включаете ручную проверку. При работе с API передавайте qualityGate при каждой замене pipelineConfig, чтобы сохранить настройку. Этап проверки запускается, только если ручная проверка включена в итоговом пайплайне задания.
Контроль качества сохраняет замечания для каждой единицы перевода. "strict" требует проверки при любых замечаниях, "medium" — при серьёзных или критических, а "lax" — только при критических. Если контроль качества не смог проверить перевод, ручная проверка всё равно потребуется. Установите для qualityGate.enabled значение false, чтобы выбрать Всё: тогда каждый новый перевод, охваченный маршрутом, будет отправлен на проверку. Повторно использованные переводы не создают новых задач для проверки.
Сама оценка не зависит от строгости: выбранный уровень применяется к найденным замечаниям. Изменение уровня в движке влияет на будущие запуски заданий, но не на зафиксированную конфигурацию уже выполняющегося задания. Описание уровней и определения серьёзности замечаний см. в разделе уровни контроля качества.
Устаревший Асинхронный API локализации по-прежнему принимает humanEdit.qualityThreshold, но игнорирует его. Каждый перевод на язык, выбранный для ручной проверки, отправляется проверяющим. Чтобы настроить выборочную проверку в текущем пайплайне, задайте Уровень проверки в настройках Ручная проверка движка.
Доступность проверки зависит от плана организации и подключения провайдера группы проверяющих. При запуске задания недоступные функции этапов отключаются вместе с этапами, которые от них зависят. Посмотрите целевые этапы задания, чтобы узнать, какой рабочий процесс будет выполняться на самом деле. Если для публикации нужно решение человека, убедитесь, что это правило соблюдено, прежде чем передавать скачанный результат.
Проверьте результат #
Этап контроля качества сохраняет следующие данные для каждой проверенной единицы перевода:
{
"findings": [
{
"span": "Pay €20",
"reason": "The translation changes the source amount from €10 to €20.",
"category": "accuracy",
"severity": "critical"
}
]
}span — дословная цитата из перевода, оценённого на этапе контроля качества. reason — одно предложение на английском. Категории: accuracy, terminology, guidance, fluency и style. Уровни серьёзности: critical, major и minor. Пустой массив findings означает, что контроль качества не нашёл ошибок. Единицы ручной проверки возвращают эти данные в quality. См. ручная проверка. Проверяющие видят замечания рядом с переводом в разделе Очередь.
В разделе Ход выполнения этапов можно отличить завершённую работу от пропущенной, завершившейся с ошибкой или с предупреждениями. В разделе Ручная проверка описаны решения и сроки. Руководство по пайплайну объясняет, чем может быть полезен каждый этап и как последующие этапы могут менять текст, полученный на предыдущих.