自分のエンジンを使用

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

BYOエンジン機能は、外部の機械翻訳 (MT) エンジンを Phrase に統合し、他の MT プロバイダーと同様に翻訳ワークフローで利用できるようにします。

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エンジンの設定

アダプターの構築

組織は、軽量な API アダプターを構築およびテストする必要があります。このアダプターにより、Phrase とエンジン間の通信が可能になります。

アダプターは以下をサポートする必要があります。
- 翻訳リクエスト
- 言語ペアのサポート
- エンジンステータスの確認 (Phrase がステータスリクエストを送信)
基盤となるインフラストラクチャ (MT エンジンまたは LLM) は、組織によってホストおよび保守される必要があります。
Phrase がそのインフラストラクチャに接続するには権限が必要です。
アダプターは、同じセグメント数と順序で翻訳を返す必要があります。

MTプロファイルへのエンジンの統合

APIアダプターが実装およびデプロイされると、BYOエンジンがPhrase Language AIで利用可能になり、MTプロファイルで選択してプロジェクトに割り当てることができるようになります。

BYOエンジンをMTプロファイルに接続するには：

Phrase Language AIのMTプロファイルページから、MTエンジンを接続をクリックします。

MTエンジンを接続ページが表示されます。
BYOエンジンを選択します。

BYOエンジンの設定ページが開きます。
ベースエンジンURLを入力します。
認証方法（HTTPヘッダーまたはクライアント資格情報（OAuth 2.0））に応じて資格情報を提供します。
翻訳キャッシュを使用するかどうかを選択します。デフォルトで有効

過去30日以内に翻訳されたセグメントを再利用することで、トラフィックを削減し、翻訳の応答を高速化します。これは呼び出しのパフォーマンス最適化のみであり、翻訳コストを削減するものではありません。デフォルトで有効のままにし、基盤となるエンジンアダプターがアクティブに開発されている間のみ無効にしてください。
必要に応じて、カスタムラベルの下にエンジンの追加情報を提供します。
接続を検証をクリックして、エンジン統合が機能するかどうかを確認します。
追加をクリックします。

これで、プロファイルでエンジンを有効にできるようになりました。

ヒント

BYOエンジンを使用する場合、MTプロファイルで他のエンジンを有効にしないでください。これにより、事前翻訳でBYOエンジンが確実に選択されるようになります。

BYOエンジンの編集

BYOエンジンを編集するには、エンジンタイルの編集アイコンをクリックします。

BYOエンジンを削除

BYOエンジンを削除するには：

エンジンタイルの編集アイコンをクリックします。
BYOエンジンを削除をクリックします。

よくあるご質問

Q：	なぜステータスリクエストが必要なのですか？それはPhraseからエンジンに送信されるのですか、それとも顧客が処理することを想定しているのですか？
A：	Phraseは、エンジンが動作するかどうかを確認するためにリクエストを送信します。
Q：	1つのリクエストには、500 の `maxItems` が `segments` 内に含まれる場合があります。これは、500のソース文をリアルタイムで翻訳しなければならないことを意味しますか？
A：	同期呼び出しには最大5セグメントまでしか含まれませんが、非同期呼び出しにはそれ以上、最大500セグメントまで含めることができます。また、非同期のタイムアウトは約30分です。
Q：	用語集の全用語がリクエストで送信されるのですか、それとも一部ですか？
A：	用語集の全用語が送信されます。
Q：	LLMをプラグインすることは可能ですか？
A：	ラッパーを使用すれば可能であるはずです。エンジンがスキーマで定義された通りにセグメントを返す限り、Phraseは特定のエンジンやLLMを必要としません。
Q：	カスタム品質評価（QE）は可能ですか？
A：	サードパーティのQEはサポートされていません。
Q：	タグはどのように処理されますか？
A：	Phraseが受け取るコンテンツは前処理されています。HTMLタグはマークに変換され、それらのマークはそのまま渡されます。
Q：	非同期アプローチのみを実装することは可能ですか？すべてのPhrase領域（事前翻訳、エディターなど）で正しく機能しますか？
A：	いいえ、両方のアプローチ（理想的にはすべてのエンドポイント）を実装する必要があります。同期エンドポイントは例えばエディターで使用され、非同期エンドポイントは事前翻訳などの領域で使用されます。
Q：	エンジンが同時に複数のリクエストを受け取った場合、どうなりますか？
A：	エンジンはこれに対応できる必要があります。すべてのエンドポイント、特に非同期エンドポイントにおいて、同時実行性とスレッドセーフティが適切に処理されるようにしてください。
Q：	リクエストメタデータはどのように機能しますか？
A：	エンジン設定時に定義された通り、静的である必要があります。
Q：	セグメントメタデータはどのように機能しますか？
A：	現在は、スキーマの一部である必要があります。
Q：	MT処理中、BYOエンジンはRAGを使用してコンテキストを取得しますか？
A：	いいえ、BYOエンジンはRAGを使用しません。ユーザーはTMを活用してどのセグメントが翻訳されるかを判断できますが、それらはMTプロセス自体の中では使用されません。これは、MTエンジンがRAGを介してTMデータを取り込むように特別に設計されている必要があり、BYOエンジンのシナリオではエンジンの構築方法や構成方法を制御できないためです。

アダプタースキーマリファレンス

アダプターは、以下のフィールド名および列挙値と厳密に一致する応答を返す必要があります。不一致が発生すると、アダプター自体が200 OK応答を返した場合でも、Phraseから一般的なINTERNAL_ERRORが返されます。

POST /statusは、statusフィールドを返し、その値はokまたはnot_okのいずれかという厳密な小文字の列挙値でなければなりません。例: { \"status\": \"ok\" }
POST /languagesは、各要素にsourceLanguageフィールドとtargetLanguageフィールドを含むlanguagePairs配列（camelCase）を返す必要があります。例: { \"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\":\"翻訳失敗の記述\" }