パイプラインの進捗を確認する

各ドキュメントの翻訳先ごとに、ステージの状態、ユニット数、警告、失敗の理由を確認します。

特定のファイルと言語の処理状況を把握するには、ジョブのレスポンスに含まれるdocuments[].targets[].stagesを確認します。ステージは、ジョブ開始時にエンジンの設定が記録されると表示されます。それまでは配列が空の場合があります。

各エントリにはstage、status、unitsが含まれます。以下は進捗情報の抜粋です。

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

この例では、対象の全8ユニットのうち3ユニットで、人によるレビューが完了したか、スキップされています。まだ判断が必要なユニットは、レビューで確認できます。

ステージ識別子 #

識別子処理内容
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は対象のユニット総数を表します。ドキュメントの準備前は、どちらもゼロの場合があります。これらはコンテンツのユニット数であり、モデルへのリクエスト数、経過時間、料金の見積もりを示すものではありません。

出力を採用するかどうかを判断する #

必須の翻訳処理が失敗すると、該当する出力は完了できません。任意のステージでは、警告とともに前段階のテキストを保持することがあります。そのため、公開ポリシーでレビュー、長さ、その他の品質要件を定めている場合は、ジョブが完了していても各ステージの警告を確認する必要があります。

人によるレビューがタイムアウトすると、人の承認を得ないままAI生成テキストが保持されることがあります。また、後続のステージで、人が書いた表現が変更される場合もあります。レビューポリシーを読み、公開前にダウンロードした最終ファイルを確認してください。

APIはここで進捗を返します。各ステージでのモデルの試行や詳しい実行内容を調べるには、Studioの実行ビューを使用してください。