翻訳パイプラインを設定する

ジョブの開始前にエンジンのステージ設定を保存し、実際に実行されるステージを確認します。

ローカライゼーションジョブでは、開始時に取得したエンジンのパイプライン設定が使われます。/startを呼び出す前に、エンジンを設定してください。その後のエンジンの変更は、今後開始するジョブにのみ適用され、実行中のジョブのスナップショットには影響しません。

Studioでエンジンのパイプラインタブを開くか、PATCH /v2/engines/:id経由でpipelineConfigを更新します。呼び出し元には、エンジンの編集権限が必要です。組織には、実行される可能性のある各ステージで必要な機能へのアクセス権が必要です。詳しくは、機能へのアクセスと料金をご覧ください。

設定全体を保存する #

既存の設定を変更する前に、GET /v2/engines/:idでエンジンを取得してください。pipelineConfigを送信すると設定全体が置き換えられ、省略したステージには既定値が適用されます。引き続き使う設定は、送信する内容に残してください。

このリクエストでは、言い換え処理を含む翻訳を設定します。省略した任意のステージは無効になります。

http
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY
json
{
  "pipelineConfig": {
    "localize": { "enabled": true },
    "rephrase": { "enabled": true }
  }
}

アプリケーションで特定の種類のジョブに別のポリシーを適用する必要がある場合は、別のエンジンを使ってください。そのエンジンのモデルとガイダンスを設定し、該当するジョブを作成するときに、そのエンジンのIDを選択します。

ステージの設定 #

pipelineConfig内のフィールド設定
localizeenabled: true。翻訳は必須です。
preEdit, rephrase, postEdit, backTranslationenabledは真偽値です。既定値は偽です。
qualityGateenabledの真偽値とstrictness:"strict"、"medium"、または"lax"(既定値は"medium")。
humanEditenabled、正の整数のtimeoutHours(既定値は48)、およびレビューのroutes。
contentLengthenabledと、後述のmode。

後編集には、人によるレビューが必要です。後編集は人の手を経た出力を対象に実行されるため、バイパスやタイムアウトが発生すると、修正対象の出力がない場合があります。

コンテンツ長のモードは、{ "_tag": "noLongerThanSource" }(既定)、{ "_tag": "fixedCap", "maxColumns": 40 }、または{ "_tag": "matchSource", "tolerancePct": 10 }です。数値には正の整数を指定してください。これらは表示桁数の目標値であり、バイト数の上限ではなく、画面内に収まることを保証するものでもありません。

人によるレビューの振り分け先を設定する #

まず、判定プールを作成または選択します。各humanEdit.routesエントリには、プール名と、対象となる言語およびディレクトリの範囲を指定します。この設定では、新しく翻訳されたすべてのコンテンツを一つのプールに送ります。

json
{
  "pipelineConfig": {
    "localize": { "enabled": true },
    "humanEdit": {
      "enabled": true,
      "timeoutHours": 48,
      "routes": [
        {
          "pool": "YOUR_DECISION_POOL_ID",
          "match": { "locales": [] }
        }
      ]
    }
  }
}

locales配列が空の場合は、すべての言語が対象になります。特定のディレクトリ配下の文書を対象にするには、match内に"path": ["emails/**"]を追加します。この値は文書のkeyと照合されます。パスにはディレクトリ名をそのまま記述し、末尾に/**を付けます。pathのないルートは、すべてのディレクトリに適用されます。ディレクトリとロケールの一致条件がより具体的なルートが優先され、競合するルートは拒否されます。

特定の翻訳だけをレビューするには、人によるレビューを有効にし、レビューしたい翻訳を対象とするルートを追加します。他の設定はそのままに、pipelineConfig内にqualityGateを追加してください:

json
{
  "qualityGate": { "enabled": true, "strictness": "medium" }
}

humanEdit.enabledがfalseの状態でも、qualityGateを有効にして保存できます。Studioでは、人によるレビューをオフにしてから再びオンにしても、保存した設定は保持されます。APIを使う場合は、設定を保持するために、置き換える各pipelineConfigにqualityGateを含めてください。ゲートは、ジョブに適用されるパイプラインで人によるレビューが有効な場合にのみ実行されます。

ゲートは、ユニットごとに検出事項を保存します。"strict"では何らかの検出事項がある場合、"medium"では主要または重大な検出事項がある場合、"lax"では重大な検出事項がある場合にのみ、レビューが必要になります。ゲートで確認できなかった翻訳もレビューが必要です。すべてにするには、qualityGate.enabledをfalseに設定します。これにより、ルートの対象となる新しい翻訳がすべてレビューに送られます。再利用された翻訳が、新たなレビュー作業の対象になることはありません。

判定自体は厳しさの設定に左右されず、検出事項に対してレベルが適用されます。エンジンのレベルを変更しても、今後開始するジョブにのみ適用され、実行中のジョブで取得済みの設定には影響しません。各レベルの説明と重大度の定義については、品質ゲートのレベルを参照してください。

従来の非同期ローカライゼーションAPIは、引き続きhumanEdit.qualityThresholdを受け付けますが、その値は無視されます。人によるレビューの対象として選択された言語では、すべての翻訳がレビュー担当者に送られます。現在のパイプラインで必要な翻訳だけをレビューするには、エンジンの人によるレビュー設定でレビューレベルを設定してください。

レビューを利用できるかどうかは、組織のプランと、プールのプロバイダー接続によって決まります。ジョブの開始時に、利用できないステージ機能と、それらに依存するステージが無効になります。実際に適用されるワークフローは、ジョブの対象ステージで確認してください。公開に人の判断が必要な場合は、ダウンロードした出力を配信する前に、そのポリシーを必ず適用してください。

結果を確認する #

品質ゲートのステージでは、確認したユニットごとに次の出力を保存します。

json
{
  "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として返します。詳しくは、人によるレビューを参照してください。レビュー担当者は、キューで翻訳の横に表示される検出事項を確認できます。

ステージの進捗では、完了、スキップ、失敗、警告のある処理を区別します。人によるレビューでは、判断と期限について説明します。パイプラインガイドでは、各ステージが役立つ理由と、後続のステージが前のステージのテキストをどのように変更しうるかを説明します。