パイプラインの進捗を確認する
各ドキュメントの翻訳先ごとに、ステージの状態、ユニット数、警告、失敗の理由を確認します。
特定のファイルと言語の処理状況を把握するには、ジョブのレスポンスに含まれるdocuments[].targets[].stagesを確認します。ステージは、ジョブ開始時にエンジンの設定が記録されると表示されます。それまでは配列が空の場合があります。
各エントリにはstage、status、unitsが含まれます。以下は進捗情報の抜粋です。
{
"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の実行ビューを使用してください。