翻訳パイプラインを設定する
ジョブの開始前にエンジンのステージ設定を保存し、実際に実行されるステージを確認します。
ローカライゼーションジョブでは、開始時に取得したエンジンのパイプライン設定が使われます。/startを呼び出す前に、エンジンを設定してください。その後のエンジンの変更は、今後開始するジョブにのみ適用され、実行中のジョブのスナップショットには影響しません。
Studioでエンジンのパイプラインタブを開くか、PATCH /v2/engines/:id経由でpipelineConfigを更新します。呼び出し元には、エンジンの編集権限が必要です。組織には、実行される可能性のある各ステージで必要な機能へのアクセス権が必要です。詳しくは、機能へのアクセスと料金をご覧ください。
設定全体を保存する #
既存の設定を変更する前に、GET /v2/engines/:idでエンジンを取得してください。pipelineConfigを送信すると設定全体が置き換えられ、省略したステージには既定値が適用されます。引き続き使う設定は、送信する内容に残してください。
このリクエストでは、言い換え処理を含む翻訳を設定します。省略した任意のステージは無効になります。
PATCH /v2/engines/:id
Content-Type: application/json
X-API-Key: YOUR_API_KEY{
"pipelineConfig": {
"localize": { "enabled": true },
"rephrase": { "enabled": true }
}
}アプリケーションで特定の種類のジョブに別のポリシーを適用する必要がある場合は、別のエンジンを使ってください。そのエンジンのモデルとガイダンスを設定し、該当するジョブを作成するときに、そのエンジンのIDを選択します。
ステージの設定 #
pipelineConfig内のフィールド | 設定 |
|---|---|
localize | enabled: true。翻訳は必須です。 |
preEdit, rephrase, postEdit, backTranslation | enabledは真偽値です。既定値は偽です。 |
qualityGate | enabledの真偽値とstrictness:"strict"、"medium"、または"lax"(既定値は"medium")。 |
humanEdit | enabled、正の整数のtimeoutHours(既定値は48)、およびレビューのroutes。 |
contentLength | enabledと、後述のmode。 |
後編集には、人によるレビューが必要です。後編集は人の手を経た出力を対象に実行されるため、バイパスやタイムアウトが発生すると、修正対象の出力がない場合があります。
コンテンツ長のモードは、{ "_tag": "noLongerThanSource" }(既定)、{ "_tag": "fixedCap", "maxColumns": 40 }、または{ "_tag": "matchSource", "tolerancePct": 10 }です。数値には正の整数を指定してください。これらは表示桁数の目標値であり、バイト数の上限ではなく、画面内に収まることを保証するものでもありません。
人によるレビューの振り分け先を設定する #
まず、判定プールを作成または選択します。各humanEdit.routesエントリには、プール名と、対象となる言語およびディレクトリの範囲を指定します。この設定では、新しく翻訳されたすべてのコンテンツを一つのプールに送ります。
{
"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を追加してください:
{
"qualityGate": { "enabled": true, "strictness": "medium" }
}humanEdit.enabledがfalseの状態でも、qualityGateを有効にして保存できます。Studioでは、人によるレビューをオフにしてから再びオンにしても、保存した設定は保持されます。APIを使う場合は、設定を保持するために、置き換える各pipelineConfigにqualityGateを含めてください。ゲートは、ジョブに適用されるパイプラインで人によるレビューが有効な場合にのみ実行されます。
ゲートは、ユニットごとに検出事項を保存します。"strict"では何らかの検出事項がある場合、"medium"では主要または重大な検出事項がある場合、"lax"では重大な検出事項がある場合にのみ、レビューが必要になります。ゲートで確認できなかった翻訳もレビューが必要です。すべてにするには、qualityGate.enabledをfalseに設定します。これにより、ルートの対象となる新しい翻訳がすべてレビューに送られます。再利用された翻訳が、新たなレビュー作業の対象になることはありません。
判定自体は厳しさの設定に左右されず、検出事項に対してレベルが適用されます。エンジンのレベルを変更しても、今後開始するジョブにのみ適用され、実行中のジョブで取得済みの設定には影響しません。各レベルの説明と重大度の定義については、品質ゲートのレベルを参照してください。
従来の非同期ローカライゼーションAPIは、引き続きhumanEdit.qualityThresholdを受け付けますが、その値は無視されます。人によるレビューの対象として選択された言語では、すべての翻訳がレビュー担当者に送られます。現在のパイプラインで必要な翻訳だけをレビューするには、エンジンの人によるレビュー設定でレビューレベルを設定してください。
レビューを利用できるかどうかは、組織のプランと、プールのプロバイダー接続によって決まります。ジョブの開始時に、利用できないステージ機能と、それらに依存するステージが無効になります。実際に適用されるワークフローは、ジョブの対象ステージで確認してください。公開に人の判断が必要な場合は、ダウンロードした出力を配信する前に、そのポリシーを必ず適用してください。
結果を確認する #
品質ゲートのステージでは、確認したユニットごとに次の出力を保存します。
{
"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として返します。詳しくは、人によるレビューを参照してください。レビュー担当者は、キューで翻訳の横に表示される検出事項を確認できます。
ステージの進捗では、完了、スキップ、失敗、警告のある処理を区別します。人によるレビューでは、判断と期限について説明します。パイプラインガイドでは、各ステージが役立つ理由と、後続のステージが前のステージのテキストをどのように変更しうるかを説明します。