リクエスト

翻訳ステージでのモデルの試行、ソースバッチ、生の出力、エラー、使用量を確認します。

リクエストの記録には、翻訳ステージ内でモデルが行った1回の試行の詳細が含まれます。プロバイダーの障害や予期しない出力を調査する際に役立ちます。1回の実行に複数のドキュメント、ロケール、ステージが含まれ、各ステージでモデルへのリクエストが複数回行われることもあります。

Studioで実行を開き、該当するドキュメントとロケールを展開して、ステージを選択します。そのステージの一覧からリクエストを開くと、試行の詳細を確認できます。

確認している試行を特定する #

フィールド確認できる内容
プロバイダーとモデルこの試行で使用されたモデル。
キー記録がある場合、リクエストにプラットフォームのキーと組織の接続のどちらが使われたか。
ステータスこのモデルの試行が完了したか、失敗したか。
操作、試行、バッチこの試行が属する操作とバッチ、および一連の試行の中での順番。
トークンリクエスト全体について記録された入力・出力のトークン使用量。
所要時間と開始日時この試行の所要時間と開始日時。
コスト記録がある場合、プロバイダーの利用にかかったコスト。

試行が失敗しても、その後のフォールバックが成功することがあります。プロバイダーのエラーで翻訳先全体の処理が失敗したと判断する前に、同じバッチ内の試行を比較してください。また、モデルの処理が完了していても、返された翻訳に修正が必要な場合があります。

1つのリクエストで、複数のドキュメントやロケールを処理することがあります。1つの翻訳先からリクエストを開いた場合でも、表示される使用量とコストはバッチ全体のものです。そのため、同じリクエストが複数の翻訳先に表示されることがあります。コストを合算する際は、同じ識別子のリクエストを1回だけ数えてください。

入力と生の出力を比較する #

入力には、記録されたソースバッチが含まれます。生の出力には、パイプラインの残りの処理が完了する前のモデルの応答が含まれます。どちらも参照できるとは限りません。ペイロードがないからといって、ソースが空だったことや、リクエストで何も処理されなかったことの証拠にはなりません。

ソースのキーを使って調査対象の箇所を見つけ、意味、プレースホルダー、構造を生の出力と比較してください。プロバイダーで障害が発生した場合は、コンテンツやモデルの選択を変更する前に、エラーの詳細を確認してください。

この画面には、システムプロンプトの全文や、生成時に使用された用語集とルールの完全なスナップショットは含まれていません。保存されたソースのリビジョン、送信されたコンテキスト、エンジンの設定履歴から、当時どのような指針を利用できたかを確認してください。現在の用語集の内容だけでは、過去の試行にどの用語が渡されたかを証明できません。指針の選択方法については、コンテキストの取得で説明しています。

後続ステージでの結果を追跡する #

モデルの生の出力は、処理途中の状態を示すものです。翻訳先が再構築されるまでに、言い換え、人によるレビュー、ポストエディット、コンテンツの長さの調整、逆翻訳によってテキストが変わることがあります。ステージの進行状況を確認したうえで、完成した翻訳先をダウンロードし、呼び出し元が実際に利用できる内容を確かめてください。

レビューを調査する際は、レビュー担当者に提示されたテキストと、担当者が送信した判断を照らし合わせてから、最終的な翻訳先を確認してください。後続の処理による変更を、レビュー担当者による変更とみなさないようにしてください。判断、タイムアウト、外部レビューによる引き継ぎについては、Inboxのレビューで説明しています。

逆翻訳では、モデルが逆方向に翻訳したテキストを使い、意味に重大な影響を及ぼすずれがないかを確認し、修正を試みることがあります。モデルによる追加の処理が発生するほか、逆翻訳自体が誤っている可能性もあります。ステージが成功しただけで意味が同等だと判断せず、元のソースと最終的な翻訳先を照らし合わせながら結果を確認してください。

測定と実行を切り分ける #

レーダーの測定では、生成後のローカライズイベントを調べます。測定の回答は翻訳先の処理が完了した後に届くこともあり、モデルへのリクエストが成功したかどうかを示すものではありません。選択方法と回答の確認場所については、Lingo.devの翻訳をレビューするで説明しています。

元の試行を把握できたら、再現実行で変更案を検証できます。新しいジョブの識別子、ソースのリビジョン、エンジンの設定、出力を記録してください。再現実行は使用量が発生し得る新たな実行であり、元の試行後に設定が変わっていれば、結果も変わる可能性があります。問題のある翻訳をデバッグするでは、調査から修正までの流れを説明しています。