イベント
記録された翻訳アクティビティを探し、テキストとその出所を確認して、どの測定で評価されたかをたどります。
イベントには、提案の追加、翻訳の変更、ローカライズの完了など、コンテンツに起きたことが記録されます。測定結果を解釈する前に、Radarが何を受信したのかを確かめたいときは、イベントを開いてください。
イベントの種類を見分けることが大切です。翻訳の提案、提案の承認、訳文の更新は、同じ文字列に関するものでも、それぞれ異なるアクティビティを表します。この三つを翻訳済みの文字列三件として数えると、作業量を実際より多く見積もることになります。
イベントを探して開く #
Radar → ログには二つのタブがあります。オーガニックには受信したすべてのイベントが、測定には測定によってイベントから算出されたすべての値が表示されます。どちらも、過去7日間、過去30日間、過去90日間、全期間で期間を指定し、言語、イベントの種類、ソースで絞り込めます。オーガニックでは、生成元で生成元の種類も選択できます。言語、ソース、生成元の選択肢に表示されるのは、組織のイベントに含まれる値と、すでに選択されている値だけです。生成元では各コードの正式名称が表示され、llmはAIモデル、humanは人、mtは機械翻訳、tmは翻訳メモリ、algoはアルゴリズムを表します。言語では、イベントのロケールが完全に一致するものだけが対象になります。時刻、各行の日付、対象期間は、監査ログと同じく、設定 → 一般で設定した組織のタイムゾーンに従います。対象期間には、今日の終わりまでを含む指定日数が含まれます。時刻にカーソルを合わせると、タイムゾーン付きの正確な時刻を確認できます。クリアを選択すると、期間はそのままで、言語とすべてのフィルターが一度に解除されます。
種類フィルター、テーブル、イベントのページでイベントの種類にカーソルを合わせると、その意味を確認できます。リファレンスには、すべてのイベントの種類と、それぞれを送信する連携が記載されています。
イベントを開き、確認できる原文、訳文、下書き、コンテキストに目を通します。ページには、種類、ロケール、生成元、実行者、発生日時、取り込み日時、単位、相関が表示され、その下に値として測定結果と、保存されたペイロードが表示されます。調査内容を共有するときは、イベントの識別情報と記録された発生日時を必ず残してください。読み取りの仕様では、eventIdと、イベントのeventAtの値をatとして使い、詳細を特定します。
イベント履歴はカーソル方式でページ分割されます。1ページあたりの件数は既定で50件、最大200件です。選択した履歴をすべて取得するには、フィルターを変えずにmeta.nextCursorを使い、次のカーソルがなくなるまで取得を続けてください。1ページに表示される行は、履歴全体の一部にすぎません。
記録の識別情報を読み取る #
| フィールド | 識別する内容 |
|---|---|
eventId, eventType | 記録された出来事とアクティビティの種類。 |
unitId, displayKey | 対象のコンテンツ単位と、人が読んで理解できる識別子。 |
locale | このアクティビティに関連付けられたロケール。 |
providerType, providerId, actorId | 取得できる生成元または実行者の情報。それぞれの役割はイベントによって異なります。 |
correlationId | 相関を示す参照情報。ない場合はヌル値。 |
eventAt, ingestedAt | ソースに基づくイベント発生日時と収集日時。その差は、ソースのタイムスタンプの規則に沿って解釈します。 |
詳細 payload | 保存されたイベントの根拠情報。利用できない場合はヌル値。 |
ソースの単位を理解する #
Lingo.devのイベントは、記録された翻訳リクエスト、またはドキュメントジョブの対象ロケール一つ分を表す場合があります。リクエスト由来のテキストには、キーとテキストを対応付けた原文と訳文のオブジェクトが含まれます。ジョブ由来のテキストでは、単位がソースファイルごとにまとめられ、完成した訳文の値が含まれます。ただし、生成モデルやトークン使用量が含まれない場合もあります。どちらの形式も、必ず一つの文字列に相当するわけではありません。
Crowdinのイベントは、プロバイダー内の文字列とロケールを識別します。原文の追加、更新、削除、訳文の変更、提案の作成、編集、削除、承認、承認取り消しが、それぞれイベントの種類に対応付けられます。変更前と変更後の訳文がどちらも空の場合、訳文の変更イベントは生成されません。複数形のオブジェクトはJSONテキストとして保持されます。
訳文が変更されると、編集に関する測定では、その文字列の直前のバージョンと比較します。比較対象は、同じ文字列とロケールについて、変更より前に行われた最も新しい訳文の作成または更新、あるいはイベントに含まれる変更前のテキストです。通常は納品された翻訳が比較対象になりますが、それ以前の編集結果の場合もあります。すべての差分を人による修正と判断する前に、比較対象の組み合わせを確認してください。同じ提案が繰り返し承認されても、記録は一度だけです。承認取り消しが繰り返された場合は、イベントの識別情報に受信日時が使われるため、再試行時の重複排除が常に保証されるわけではありません。
Crowdinの翻訳イベントと提案イベントでは、承認も含め、翻訳のcreatedAtがイベント発生日時として使われます。そのため、今日受信した承認が、過去の提案作成日で表示されることがあります。受信日時は、同じ提案に対する繰り返しの承認取り消しを区別するために使われますが、イベント発生日時に置き換わるものではありません。承認は提案ごとに一度だけ記録されます。日付フィルターと過去の評価にはeventAtが使われるため、承認日だけでなく、記録された日付で探してください。ingestedAtとの時間差には承認前の時間も含まれることがあるため、収集の遅延だけを示す測定値ではありません。ソースのタイムスタンプがない場合や無効な場合は、代わりに受信日時が使われます。
プロバイダー、生成元、評価者の識別情報も、それぞれ意味が異なります。Lingo.devのリクエストにあるモデルは生成元を示し、承認に記録されたCrowdinユーザーは、そのプロバイダー内でのアクティビティの実行者を示します。承認を確認できても、その翻訳がエクスポートされたことや、アプリケーションに読み込まれたことまでは確認できません。
結果から根拠をたどる #
イベントの測定結果を開き、評価対象のテキストとあわせて評価基準を確認します。用語の問題が疑われる場合は、その用語と使用範囲を確認してください。ルール違反の場合は、該当するルールと説明を確認してください。結果では、確認できる回答、提案、使用量、判定のトレースについて説明しています。
アルゴリズムによる測定では、結果を直接計算するため、AIリクエストが存在しない場合があります。モデルによる結果では、実際のプロンプトと応答を確認できることがあります。指摘が、与えられていないコンテキストを前提としているように見える場合は、それらを確認してください。トレースが利用できない場合、そこから追加の判断材料を得ることはできません。
エージェントに調査を支援させる場合は、読み取りを明示的に許可してください。接続されたツールは、設定の変更や新しい翻訳の送信も行えるため、再現を試みるかどうかは別途判断する必要があり、使用量が発生する場合もあります。リクエストは、元の作業の確認と新たな試行を区別するのに役立ちます。