Как отслеживать ход выполнения пайплайна

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

Смотрите documents[].targets[].stages в ответе задания, чтобы понять, что происходит с конкретным файлом на выбранном языке. Этапы появляются после того, как при запуске задания фиксируется конфигурация движка. До этого массив может быть пустым.

Каждая запись содержит stage, status и units. Фрагмент данных о ходе выполнения:

json
{
  "stage": "humanEdit",
  "status": { "_tag": "Running" },
  "units": { "finished": 3, "total": 8 }
}

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

Идентификаторы этапов #

ИдентификаторЧто делает этап
preEditУлучшает исходный текст перед переводом.
localizeСоздаёт перевод на целевой язык.
rephraseУлучшает формулировки перевода.
qualityGateНаходит ошибки и по их серьёзности определяет, нужна ли ручная проверка.
humanEditОжидает внутренней или внешней проверки.
postEditУлучшает текст после проверки.
contentLengthМеняет формулировки, чтобы приблизить длину текста к заданным ограничениям.
backTranslationПроверяет смысл с помощью обратного перевода и вносит исправления.

Настройте этапы в движке. В списке показаны только включённые этапы, зафиксированные при запуске задания.

Статус этапа #

status._tagЗначение и дополнительные поля
PendingРабота ещё не началась.
PlanningИдёт подготовка к работе.
WaitingОжидание завершения предыдущей работы.
RunningРабота выполняется. Ручная проверка может оставаться в этом статусе, пока ожидаются решения.
CompletedРабота завершена. Есть поле finishedAt.
CompletedWithWarningsРабота завершена, предупреждения сохранены. Есть поле finishedAt и непустое поле warnings.
SkippedВыполнение не потребовалось. Есть поле finishedAt и непустое поле reasons.
CancelledРабота остановлена. Есть поле finishedAt и непустое поле reasons.
FailedСбой этапа. Есть поле finishedAt и непустое поле messages.

finishedAt — метка времени в формате ISO. units.finished — количество завершённых или пропущенных единиц контента, а units.total — количество единиц контента в целевом варианте. До подготовки документа оба значения могут быть нулевыми. Эти счётчики показывают количество единиц контента, а не запросов к модели, затраченное время или примерную стоимость.

Как решить, принимать ли результат #

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

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

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