自分のエンジンを使用

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

Bring Your Own Engine（BYOエンジン）機能を使用すると、外部の機械翻訳（MT）エンジンをPhraseに統合し、他のMTプロバイダと同様に翻訳ワークフローで使用できます。

BYOエンジンは以下に適しています。

ドメイン固有のMTモデルを持つ企業。
カスタムクライアントエンジンや推奨のAIスタックを持つLSP。
特定のエンジン（Gemini、社内LLMなど）の使用を義務付ける社内ポリシーを持つ組織。

カスタムトレーニングされたエンジンを使用したり、翻訳を社内LLMやMTプロバイダにルーティングしたりすることで、品質、プライバシー、コストを完全に管理しながら、Phraseの翻訳メモリ（TM）、用語集、QPS（品質評価スコア）、およびCAT Editorのメリットを継続して享受できます。

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エンジンを接続ページが表示されます。
Bring Your Own (BYO) エンジンを選択します。

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

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

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

ヒント

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

自分のエンジンを使用を編集する

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

自分のエンジンを使用を削除する

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

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

FAQ

Q：	なぜステータスリクエストが必要なのですか？これはPhraseからエンジンに送信されるものですか、それともお客様が処理するものですか？
A：	Phraseは、エンジンが動作するかどうかを確認するためのリクエストを送信します。
Q：	1つのリクエストには、`セグメント`で最大500の`maxItems`が含まれる場合があります。これは、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：	Request Metadataはどのように仕事しますか？
A：	エンジンセットアップ時に定義された通り、静的である必要があります。
Q：	Segment Metadataはどのように仕事しますか？
A：	現在は、スキーマの一部である必要があります。
Q：	MT処理中、BYOEはRAGを使用してコンテキストを取得しますか？
A：	いいえ、BYOEはRAGを使用しません。ユーザーはTMを使用してどのセグメントが翻訳されるかを決定できますが、それらはMTプロセス自体の中では使用されません。これは、MTエンジンがRAGを介してTMデータを取り込むように特別に設計されている必要があり、BYOEのシナリオではエンジンの構築方法や構成方法を制御できないためです。

アダプター・スキーマ参考資料

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

POST /status は、ok または not_ok のいずれかの厳密な小文字の列挙値を持つ ステータス フィールドを返す必要があります。例: { \"status\": \"ok\" }
POST /languages は、sourceLanguage フィールドと targetLanguage フィールドを含む各エントリーを持つ languagePairs 配列（camelCase）を返す必要があります。Example: { "languagePairs": [ { "sourceLanguage": "en", "targetLanguage": "es" } ] }
POST /translate および GET /translateAsyncResult/{id} は、トップレベルの sourceLanguage フィールドと targetLanguage フィールドに加え、各セグメントに text フィールド（エコーバックされた原文）と translatedText フィールドの両方を含む セグメント 配列を返す必要があります。translatedText のみを返すか、異なるキー名を使用すると、デシリアライズの失敗を引き起こします。
POST /translateAsync は、レスポンスに ID フィールドのみを必要とします。ステータス フィールドはこのレスポンススキーマの一部ではなく、存在しても無視されます。
GET /translateAsyncStatus/{id} は、3つの列挙値のいずれかを使用して ステータス フィールドを返す必要があります。処理中のジョブには running、正常に完了したジョブには done、失敗したジョブには failed を使用します。失敗したジョブの場合、オプションの detail フィールドで失敗の内容を記述できます。値の例: { \"status\": \"running\" }、{ \"status\": \"done\" }、{ \"status\": \"failed\", \"detail\": \"Description of translation failure\" }