仕組み
コンテンツの変更が、原文から保存済みの翻訳指針を経て、利用・確認できる翻訳結果になるまでの流れをたどります。
コンテンツを作成・修正するときは、読者に何を理解してほしいか、どこを詳しく説明すべきか、どんな論拠なら納得してもらえるかを考えます。翻訳でも、その意味と説得の意図を、別の言語で同じように正確に伝える必要があります。Lingo.devは、製品、用語、文体について保存した指針をもとに、言語モデルでコンテンツを翻訳します。
原文と必要な言語を指定し、翻訳に使うローカライゼーションエンジンを選びます。APIの呼び出し元はengineIdでエンジンを指定します。CLIや連携機能は、それぞれの設定で選択されたローカライゼーションエンジンを使用します。この選択によって、リクエストで利用できるモデルと共有の指針が決まります。翻訳されたコンテンツは、リクエストを送ったツールを通じて返され、品質測定と人によるレビューは、設定した経路に沿って行われます。
コンテンツと翻訳先の言語から始める #
提供するコンテンツが原文、各言語に翻訳されたものが訳文です。原文には、ファイル、アプリケーション内の構造化データ、接続したコンテンツシステムのデータを使用できます。リクエストで指定する原文と訳文のロケールによって、対象となる言語が決まります。
ロケールは言語を識別するもので、必要に応じて地域や文字体系も指定します。想定する読者を明確に指定しましょう。たとえばpt-BRを指定すれば、地域を未指定にするのではなく、ブラジルポルトガル語を指定できます。原文と訳文のロケールは、Lingo.devが適用する翻訳指針を選ぶ際にも使われます。照合のルールについては、ロケールの解決で説明しています。
コンテンツでは、言語だけでなく構造も重要です。アプリケーションはメッセージキーでテキストを見つけ、変数で値を挿入します。文書には見出し、リンク、書式が含まれます。APIの呼び出し元は構造化データを直接渡します。一方、CLIと形式ハンドラーは、ファイルから翻訳対象のテキストを抽出し、翻訳先のファイルを再構築します。どの経路でも、受け取り側のシステムで引き続き使える形でコンテンツを返す必要があります。
翻訳の保存時には、後から調査できるよう、対応する原文のリビジョンも出力と一緒に保管してください。作成者が原文の意味を変更すると、以前の版では正しかった翻訳でも、意図したメッセージを伝えられなくなることがあります。
今後のリクエストに必要な知識を保存する #
言語モデルは言語の扱いに長けています。ただし、製品の用語、チームで合意した要件、会社が読者に語りかける際の表現を、あらかじめ知っているわけではありません。ローカライゼーションエンジンには、使用するモデルの設定と、再利用できる指針へのリンクが保存されます。そのため、リクエストのたびにすべてを送り直さなくても、必要な知識を活用できます。
指針にはいくつかの種類があり、それぞれ異なる役割を担います。
- 用語集には、用語とその意味、推奨する表現、翻訳せずに残す名称を記録します。これにより、モデルは製品固有の概念と、同じ単語の別の用法を区別しやすくなります。
- ルールセットには、翻訳時の指示をまとめます。訳文で維持すべき意味の違いなど、用語の一覧だけでは表せない、繰り返し適用する要件を指定できます。
- ブランドボイスは、口調や丁寧さなど、会社が読者にどのように語りかけるかを定めます。
用語集、ルールセット、ブランドボイスは組織に属し、複数のローカライゼーションエンジンに関連付けられます。関連するワークフローで用語を共有しながら、必要に応じてモデルやブランドボイスを使い分けられます。共有リソースを編集すると、それを使うすべてのローカライゼーションエンジンに影響する可能性があるため、指針を変更する際は関連付け先を確認してください。
Lingo.devはリクエストごとに、選択されたローカライゼーションエンジンから、関連する用語集の用語、条件に合う指示、ブランドボイスのバリエーション、モデル候補を選びます。JSON文書では、読者や目的を説明するformat.options.contextと、個々のキーに対するformat.options.hintsも指定できます。これにより、共通の知識をローカライゼーションエンジンに保存しつつ、翻訳するコンテンツ固有の情報を補足できます。各選択肢については、翻訳コンテキストで詳しく説明しています。
作成フォームの既定値 #
ウェブアプリの作成フォームには、次の既定値が設定されています。作成を完了する前に、モデルを変更したり、既存の指針を選んだりできます。
| 設定 | フォームの既定値 |
|---|---|
| モデル | 推奨のプライマリモデルとフォールバックモデルが、すべてのロケールの組み合わせに適用されます。モデルを変更したり、特定の組み合わせを個別に設定したりできます。 |
| 用語集、ルールセット、ブランドボイス | 既定では、関連付けるリソースは選択されていません。作成時に既存のリソースを選択するか、後から関連付けてください。 |
| パイプライン | 翻訳のみです。任意で追加できるリライトと人によるレビューの段階は、初期状態では無効です。 |
| 用語集・指示への準拠の採点と提案 | 自動採点、提案の生成、提案の自動適用は、初期状態では無効です。 |
既存のローカライゼーションエンジンには、既定値とは異なる設定が保存されている場合があります。既定値のままとは限らないため、呼び出し元が実際に使用するエンジンの設定を確認してください。モデルの選択とリソースの関連付けについては、ローカライゼーションエンジンの作成と設定で説明しています。
訳文を生成して呼び出し元に返す #
選択された言語モデルに、原文と適用対象のコンテキストが渡されます。最初に設定されたモデルがリクエストを完了できない場合、ローカライゼーションエンジンはフォールバックモデルで再試行できます。フォールバックは再試行のためのものであり、両方の翻訳を比較して品質スコアの高い方を選ぶ仕組みではありません。
APIでは、翻訳ジョブを作成・開始し、完了した訳文をダウンロードします。JSON出力には文書のメッセージキーが保持され、保存先や使い方はアプリケーション側で決定します。CLIでは、プッシュとプルでこの一連のファイル処理を実行できます。連携機能には、翻訳のプルリクエストを作成するなど、それぞれ固有の書き戻し動作があります。各接続が何を読み取り、何を書き込むかについては、連携で説明しています。
返されるデータの構造が、翻訳をその後の作業につなぎます。アプリケーションでカタログを読み込めるか、変数を置換できるか、文書のリンクや書式を正しく表示できるかを確認してください。こうした確認で分かるのは、受け取り側のシステムで出力を利用できるかどうかです。言語面の品質を測定するには、別の種類の根拠が必要です。
実際に利用するワークフローで結果を確認する #
コンテンツで重視する点に合わせて、測定項目を選びましょう。意味が保たれているかを確認するには、原文と訳文に加え、作成者の意図を理解するのに十分なコンテキストが必要です。スペルチェックなら、訳文だけでも行えます。確かめたいことが異なれば、必要な根拠も異なります。何を確認したのかが分かり、その判断のもととなる箇所を確かめられてこそ、測定結果を役立てられます。
エンジンのパイプラインには、ジョブが最終出力を生成する前の段階に、人によるレビューを組み込めます。対象範囲、振り分け、タイムアウト時の動作については、レビューポリシーをご覧ください。完了した訳文でも、レビューを経ずに処理されたり、タイムアウト後に処理が続行されたりしている場合があります。品質測定は独立して別途実行されるため、翻訳の完了は、品質レポートの完成や人による承認を意味しません。
Lingo.dev以外で生成された翻訳も測定できます。既存の生成システムを使い続けながら、その出力を検査するために利用できる方法を測定で確認できます。測定は、提供されたテキストについて、あらかじめ定めた問いに答えるものです。その結果を実際の利用にあたってどう解釈するかは、チームが判断します。
レビューで用語に関する同じ問題が繰り返し見つかる場合は、現在の翻訳を修正するとともに、今後の作業に向けて用語集や指示を別途変更することも検討してください。共有の指針を更新しても、過去の翻訳がすべて書き換えられるわけではありません。指針の変更案の扱いについては、提案で説明しています。
アプリケーションからコンテンツを翻訳するには、初めてのAPIリクエストを送信してください。この手順では、少量のリクエストデータを使い、設定、翻訳、保存された訳文ファイルの確認まで進めます。原文がすでにファイルに保存されている場合は、CLIクイックスタートで、ファイルから翻訳し、訳文を取得するまでの流れを確認できます。