Как отслеживать ход выполнения пайплайна
Отслеживайте состояние этапов, количество единиц контента, предупреждения и причины сбоев для каждого целевого варианта документа.
Смотрите documents[].targets[].stages в ответе задания, чтобы понять, что происходит с конкретным файлом на выбранном языке. Этапы появляются после того, как при запуске задания фиксируется конфигурация движка. До этого массив может быть пустым.
Каждая запись содержит stage, status и units. Фрагмент данных о ходе выполнения:
{
"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.