「Bring Your Own Engine(BYOエンジン)」機能は、外部の機械翻訳(MT)エンジンをPhraseに統合し、他のMTプロバイダーと同様に翻訳ワークフローで使用できるようにします。エンジンは、ホスト型APIアダプター、またはBYOエンジン Lite(ベータ版)の場合はエンジンのAPIを記述したJSONテンプレートを介して接続します。
BYOエンジンは以下のような場合に適しています。
-
ドメイン固有のMTモデルを持つ企業。
-
独自のクライアント向けエンジンや希望するAIスタックを持つLSP。
-
特定のエンジン(Gemini、社内LLMなど)の使用を義務付ける社内ポリシーを持つ組織。
カスタムトレーニングされたエンジンを使用したり、翻訳を社内LLMやMTプロバイダーにルーティングしたりすることで、品質、プライバシー、コストを完全に管理しながら、Phraseの翻訳メモリ (TM)、用語集、品質パフォーマンススコア (QPS)、およびCATエディターのメリットを継続して享受できます。
BYOエンジンを使用できる場所
統合が完了すると、BYOエンジンを事前翻訳に使用できるようになります。Phrase Language AIプロファイルで設定し、そのプロファイルを使用して、Phrase TMSプロジェクト、Phrase Portal、Phrase Stringsプロジェクト、Phrase Studio、およびAPI経由のPhrase Language AIから事前翻訳を行います。
接続方法
BYOエンジンには3つの接続方法があります。接続方法は、エンジンの設定時に「エンジンAPI」で選択します。
|
方法 |
Phraseの呼び出し先 |
組織が提供するもの |
|---|---|---|
|
Phrase BYO APIアダプター |
BYOエンジンAPIを実装し、エンジンを呼び出すホスト型アダプター |
構築・テスト済みで、ホスティングされているアダプター |
|
事前構築済みテンプレート(Lite) |
Phraseが管理するテンプレートを使用して、エンジンのAPIを直接呼び出す |
エンジンのベースURLと認証情報 |
|
カスタムテンプレート(Lite) |
組織が作成したテンプレートを使用して、エンジンのAPIを直接呼び出す |
エンジンのベースURL、認証情報、およびJSONテンプレート |
エンジンがカスタム処理、リクエストごとの複数のアップストリーム呼び出し、またはテンプレートでは記述できないAPIを必要とする場合は、アダプターを使用してください。OpenAI互換APIなど、エンジンのAPIをそのまま使用できる場合は、テンプレートを使用してください。
BYOエンジンを設定する
アダプターを構築する
アダプターの構築は、Phrase BYO APIアダプター方式の場合にのみ必要です。事前構築済みテンプレート方式およびカスタムテンプレート方式では、アダプターは不要です。
-
組織は軽量なAPIアダプターを構築およびテストする必要があります。このアダプターにより、Phraseとエンジン間の通信が可能になります。
アダプターは以下をサポートする必要があります。
-
翻訳リクエスト
-
言語ペアのサポート
-
エンジンステータスチェック(Phraseがステータスリクエストを送信)
-
-
基盤となるインフラストラクチャ(MTエンジンまたはLLM)は、組織がホストおよび管理する必要があります。
-
Phraseがそのインフラストラクチャに接続するには権限が必要です。
-
アダプターは、セグメント数と順序が同じ翻訳を返す必要があります。
MTプロファイルへのエンジンの統合
エンジンが利用可能になると、Phrase Language AIのMTプロファイルで選択し、プロジェクトに割り当てることができます。
BYOエンジンをMTプロファイルに接続するには:
-
Phrase Language AIのMTプロファイルページから、MTエンジンを接続をクリックします。
ページが表示されます。
-
Bring Your Own(BYO)エンジンを選択します。
BYOエンジンの設定ページが開きます。
-
の下で、接続方法を選択します。
-
:ホスト型アダプター用。
-
:次に、OpenAI互換を選択します。
-
:次に、テンプレートファイルをアップロードするか、JSONをエディタに貼り付けます。
-
-
を入力します。
テンプレート方式では、URLにAPIバージョンを含めます(例:
https://api.openai.com/v1)。 -
を選択し、認証情報を入力します:
-
:(通常は
Authorization)とを入力します。Phraseは入力された値をそのまま送信するため、プレフィックス(例:Bearer)とそれに続くキーを含めてください。 -
:OAuth 2.0クライアント認証情報を入力します。
-
-
するかどうかを選択します。デフォルトで有効になっています。
過去30日以内に翻訳されたセグメントを再利用することで、トラフィックを削減し、翻訳応答を高速化します。これは呼び出しのパフォーマンス最適化のみを目的としています。翻訳コストは削減されません。通常は有効のままにし、基盤となるエンジンアダプターの開発中のみ無効にしてください。
-
必要に応じて、にエンジン用の追加情報を入力してください。
-
接続を検証をクリックして、エンジン統合が機能するか確認してください。
-
追加をクリックします。
エンジンは、プロファイルで有効にできるようになりました。
ヒント
BYOエンジンを使用する場合は、MTプロファイルで他のエンジンを有効にしないでください。これにより、事前翻訳にBYOエンジンが選択されるようになります。
BYOエンジンLite(ベータ版)
BYOエンジンLiteは、OpenAI互換APIなどのHTTP APIをすでに備えているエンジンに、ホストされたアダプターを使わずに接続します。Phraseは、リクエストとレスポンスを記述したJSONテンプレートを使用して、エンジンのAPIを直接呼び出します。
テンプレートの構造、変数、制限、およびトラブルシューティングについては、Phrase開発者ドキュメントのBYO Lite (Beta) ガイドを参照してください。
備考
BYOエンジン Liteはベータ版であり、組織ごとに有効化されます。これを有効にするには、カスタマーサクセスマネージャーまたはPhraseサポートにお問い合わせください。
事前構築済みテンプレート
OpenAI互換テンプレートは、OpenAIおよびOpenAIチャット補完APIを実装するサービスをサポートしています。ベースエンジンのURLと認証情報のみが必要です。
必要に応じて、以下のカスタムラベルを設定してください。
-
model:モデル名。OpenAI以外のサービスで必要です。 -
custom_instructions:すべての翻訳プロンプトに追加されるルール。 -
languages:エンジンが提供する言語ペアを制限するための、カンマ区切りのロケールコード(例:en,de,fr)。
カスタムテンプレート
カスタムテンプレートは、事前構築されたテンプレートではカバーできないAPI(例:異なるリクエスト形式や異なるパス)に適しています。事前構築されたテンプレートは、出発点としてダウンロードできます。接続を検証をクリックすると、Phraseがテンプレートを検証します。
BYOエンジンを編集
BYOエンジンを編集するには、エンジンタイルの編集アイコンをクリックします。
BYOエンジンを削除
BYOエンジンを削除するには:
FAQ
|
Q: |
なぜステータスリクエストが必要なのですか?これはPhraseからエンジンに送信されるものですか、それとも顧客側で処理されることが想定されていますか? |
|
A: |
Phraseは、エンジンが動作しているかどうかを確認するためにリクエストを送信します。 |
|
Q: |
1つのリクエストには、 |
|
A: |
同期呼び出しと非同期呼び出しの両方で、1〜500個のセグメントを受け入れます。実際には、エディターからの同期呼び出しには単一のセグメントが含まれますが、APIやバッチワークフロー(事前翻訳、分析)では最大500個まで送信できます。非同期フローは同じ制限を使用し、ジョブの送信と結果の取得を分離するだけです。非同期タイムアウトは約30分です。アダプターがリクエストを拒否した場合、同期から非同期へ自動的にフォールバックすることはありません。Phrase側の動作(セグメント数、エンジンの検証テスト、再試行、時間制限)の詳細については、BYOエンジンガイドを参照してください。 |
|
Q: |
用語集のすべての用語がリクエストで送信されますか、それともサブセットですか? |
|
A: |
用語集のすべての用語が送信されます。 |
|
Q: |
LLMを組み込むことはできますか? |
|
A: |
ラッパーを使用すれば可能であるはずです。エンジンがスキーマで定義されたセグメントを返す限り、Phraseは特定のエンジンやLLMを必要としません。 |
|
Q: |
カスタム品質評価(QE)は可能ですか? |
|
A: |
サードパーティのQEはサポートされていません。 |
|
Q: |
タグはどのように処理されますか? |
|
A: |
Phraseが受け取るコンテンツは前処理されます。HTMLタグはマークに変換され、それらのマークはそのまま渡されます。 |
|
Q: |
非同期アプローチのみを実装することはできますか?Phraseのすべての領域(事前翻訳、エディターなど)で正しく動作しますか? |
|
A: |
いいえ、両方のアプローチ(理想的にはすべてのエンドポイント)を実装する必要があります。同期エンドポイントは、例えばエディターで使用され、非同期エンドポイントは事前翻訳などで使用されます。 |
|
Q: |
エンジンが同時に複数のリクエストを受け取った場合、どうなりますか? |
|
A: |
エンジンはこれに対応できる必要があります。すべてのエンドポイント、特に非同期エンドポイントで、並行処理とスレッドの安全性を適切に確保してください。 |
|
Q: |
はどのように機能しますか? |
|
A: |
BYOエンジンの設定でカスタムラベルとして設定されるリクエストメタデータは、リクエストがアダプターに到達する前に解決される動的プレースホルダー( |
|
Q: |
セグメントメタデータはどのように機能しますか? |
|
A: |
現在は、スキーマの一部である必要があります。 |
|
Q: |
MT処理中、BYOエンジンはRAGを使用してコンテキストを取得しますか? |
|
A: |
いいえ、BYOEはRAGを使用しません。ユーザーはTMを活用して、どのセグメントを翻訳するかを判断できますが、MT処理そのものにTMは使用されません。これは、MTエンジンがRAGを介してTMデータを取り込むように特別に設計されている必要があり、BYOEのシナリオではエンジンの構築方法や構成方法を制御できないためです。 |
アダプターのスキーマリファレンス
アダプターは、以下のフィールド名および列挙値と完全に一致するレスポンスを返す必要があります。不一致があると、アダプター自体が200 OKレスポンスを返した場合でも、Phraseから汎用的なINTERNAL_ERRORが返されます。
-
POST /statusは、okまたはnot_okのいずれかの厳密な小文字の列挙値を持つstatusフィールドを返す必要があります。例:{ "status": "ok" } -
POST /languagesは、各エントリにsourceLanguageフィールドとtargetLanguageフィールドを含むlanguagePairs配列(キャメルケース)を返す必要があります。例:{ "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] } -
POST /translateおよびGET /translateAsyncResult/{id}は、最上位のsourceLanguageフィールドとtargetLanguageフィールド、および各セグメントにtextフィールド(エコーバックされたソーステキスト)とtranslatedTextフィールドの両方が含まれるsegments配列を返す必要があります。translatedTextのみを返すか、異なるキー名を使用すると、デシリアライズエラーが発生します。 -
POST /translateAsyncのレスポンスには、idフィールドのみが必要です。statusフィールドはこのレスポンススキーマの一部ではなく、存在しても無視されます。 -
GET /translateAsyncStatus/{id}は、3つの列挙値のいずれかを使用したstatusフィールドを返す必要があります。処理中のジョブにはrunning、正常に完了したジョブにはdone、失敗したジョブにはfailedを使用します。失敗したジョブの場合、オプションのdetailフィールドで失敗の内容を説明できます。値の例:{ "status": "running" }、{ "status": "done" }、{ "status": "failed", "detail":"Description of translation failure" }