> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wandb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Compare evaluations

> 2 つ以上の評価を視覚的に比較して、Runs 全体でのリグレッション、改善、スコアリングの差異を把握します

W\&B Weave の **Compare evaluations** ビューでは、ログされた 2 つ以上の評価を並べて確認できます。これを使用すると、プロンプト、モデル、または scorer を変更したときに Runs 間でメトリクスがどのように変化するかを確認でき、結果から結論を出す前に、データセットや scorer の不整合を見つけることができます。

このガイドは、Weave UI でログされた評価を比較したい Weave ユーザー向けです。Compare evaluations ビューを開く方法、サマリーチャートと結果テーブルに表示される内容、さらにベースラインの設定、評価の並べ替え、比較対象からの評価の削除など、比較を調整するために実行できる操作について説明します。

<div id="access-the-compare-evaluations-view">
  ## Compare evaluations ビューを開く
</div>

Compare evaluations ビューを開くには、次の手順に従います。

1. Weave のプロジェクトのサイドバーで、**Evals** を選択します。
2. 評価の表で、比較する 2 つ以上の評価のチェックボックスを選択します。
3. 評価の表のツールバーで、**Compare** を選択します。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/DfptAvSS0cJ1VmPo/weave/guides/evaluation/img/eval-compare-select.png?fit=max&auto=format&n=DfptAvSS0cJ1VmPo&q=85&s=e45155378ada64109471343a56d5a125" alt="3 つの評価が選択された評価の表。評価の表のツールバーで Compare アクションが強調表示されています。" width="1359" height="573" data-path="weave/guides/evaluation/img/eval-compare-select.png" />
</Frame>

**Compare evaluations** ビューが開き、選択した各評価がページ上部の*比較バー*に token として表示されます。デフォルトでは、左端の評価がベースラインとなり、他の各評価はそれと比較されます。

<div id="review-the-comparison">
  ## 比較結果を確認する
</div>

Compare evaluations view には 2 つのタブがあります。

* **Summary**: 比較対象の各評価について、各メトリクスの集計チャートが表示され、その下にプロパティとメトリクスの表が続きます。
* **Dataset results**: サンプルごとの結果をまとめた表で出力を行単位で比較できるほか、2 つの評価を比較する場合は差異を見つけるための散布図も表示されます。

<Frame>
  <img src="https://mintcdn.com/wb-21fd5541/DfptAvSS0cJ1VmPo/weave/guides/evaluation/img/eval-compare.png?fit=max&auto=format&n=DfptAvSS0cJ1VmPo&q=85&s=ac18f3f64f29f0e6cc006050757fd701" alt="3 つの評価を比較している Compare evaluations view。Summary タブには、上部に集計チャート、下部にプロパティとメトリクスの表が表示されています。" width="1377" height="955" data-path="weave/guides/evaluation/img/eval-compare.png" />
</Frame>

<div id="summary-tab">
  ### Summary タブ
</div>

**Summary** タブはデフォルトで開きます。ここには 2 つの領域があります。

* **Charts**: 比較対象の評価全体にわたるすべてのメトリクス値をプロットしたレーダーチャートと、それに続くメトリクスごとのチャート (数値メトリクスは棒グラフ、pass/fail メトリクスはカバレッジチャート) 。
* **Properties and metrics table**: チャートの下にある表で、各評価の設定と集計スコアを一覧表示します。

Properties and metrics table には、比較対象の各評価について次の情報が表示されます。

* **Evaluation**: 評価 ID。
* **Model**: その評価でスコア付けされたモデルのバージョン。
* **Dataset**: 評価の実行に使用したデータセットのバージョン。
* **Properties**: 評価に記録された追加のプロパティ。
* **Metrics**: 評価の Scorer によって生成された各メトリクスの集計値。

数値メトリクスでは、ベースラインとの差分が値の横に色付きのバッジで表示されます。色は、その変化がそのメトリクスにとって好ましい方向か不利な方向かを示します。デフォルトでは、値が高いほど良いと見なされるため、緑のバッジは増加、赤のバッジは減少を表します。値が低いほど良いように設定されたメトリクスでは、色は逆になります。

比較対象のすべての評価で同一のプロパティとメトリクスを非表示にするには、**Diff only** をオンにします。

Weave は、比較の解釈に影響する可能性がある差異を検出すると、表内にインライン警告を表示します。

* **Dataset inconsistency detected**: 比較対象の評価間でデータセットが異なっています。集計メトリクスは直接比較できない可能性があり、Dataset results タブは各データセットの共通部分に含まれる examples に限定されます。
* **Scoring inconsistency detected**: 比較対象の評価間で scorer が異なっています。評価ごとに scoring ロジックが異なるため、結果を比較する際は注意してください。

Weave は、サマリーを見やすく保つために、比較対象のすべての評価で共通していない score フィールドも非表示にします。フィールドが非表示になっている場合は、ビュー上部の情報バナーにその数が表示されます。表示するフィールドを選択するには、**Manage fields** を選択します。

<div id="dataset-results-tab">
  ### Dataset results タブ
</div>

選択した評価間で個々のデータセット例を比較するには、**Dataset results** を選択します。各行は 1 つのデータセット例に対応し、データセットの入力と各評価の出力、および Scorer のメトリクスが並べて表示されるため、特定の例でどこに差異があるかを確認できます。行を選択すると、左右に並べた詳細ビューが開きます。

比較する評価がちょうど 2 つの場合、このタブには表の上に 2 つの散布図が表示されます。各プロットでは、各点が 1 つのデータセット例を表し、2 つの評価それぞれにおけるメトリクス値に基づいて配置されるため、評価間で差異のある例が目立ちます。点の領域を選択 (ブラッシング) して、表に表示する例をフィルターできます。また、各プロットの **Dimension** メニューで、表示するメトリクスを選択できます。

Dataset results タブでは、比較対象の評価が同じデータセット行を共有している必要があります。データセットに共通の行がない場合、結果の表は表示されません。

<div id="customize-the-compare-evaluations-view">
  ## Compare evaluations view をカスタマイズする
</div>

Compare evaluations view では、評価の並び順や、比較に含める評価を調整できます。以下のセクションでは、使用できる操作について説明します。

<div id="set-a-baseline">
  ### ベースラインを設定する
</div>

デフォルトでは、比較バーの左端にある評価がベースラインとなり、ほかのすべての評価はそれと比較されます。すべての比較の基準として特定の評価を使いたい場合は、その評価をベースラインに指定できます。

評価をベースラインとして設定するには、次の手順を実行します。

1. 比較バーで、ベースラインに設定したい評価にポインターを合わせます。

2. ID の右側にある **action (<Icon icon="ellipsis-vertical" iconType="solid" />)** メニューをクリックします。

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541/DfptAvSS0cJ1VmPo/weave/guides/evaluation/img/comparison-evals-baseline.png?fit=max&auto=format&n=DfptAvSS0cJ1VmPo&q=85&s=48721d7ebc00f45e0d50dfa80509e500" alt="比較バーで選択した評価に対して Make baseline オプションが表示されている Compare evaluations ビュー。" width="1086" height="250" data-path="weave/guides/evaluation/img/comparison-evals-baseline.png" />
   </Frame>

3. リストで **Make baseline** を選択します。UI が更新され、ベースラインの評価が比較バーの左端に表示され、ID の横に `Baseline` が表示されます。

   <Frame>
     <img src="https://mintcdn.com/wb-21fd5541/DfptAvSS0cJ1VmPo/weave/guides/evaluation/img/comparison-evals-baseline-set.png?fit=max&auto=format&n=DfptAvSS0cJ1VmPo&q=85&s=c4a9c5c2151917ef60130847375b8f02" alt="選択したベースライン評価が比較バーの左端に表示されている Compare evaluations ビュー。" width="1091" height="164" data-path="weave/guides/evaluation/img/comparison-evals-baseline-set.png" />
   </Frame>

<div id="change-the-comparison-order">
  ### 比較順序を変更する
</div>

比較バーで評価をドラッグして並べ替えます。これにより、比較表内の対応する列の順序も並べ替えられます。

比較順序を変更するには、次の手順を実行します。

1. 比較バーで、並べ替えたい ID にポインタを合わせます。
2. ID の左側にある 6 つのドットをクリックしたまま、必要に応じて左右にドラッグします。
3. ID を目的の位置に配置します。比較データが更新され、新しい比較順で表示されます。

<div id="remove-from-comparison">
  ### 比較から削除
</div>

このオプションは、3 つ以上の評価を比較している場合にのみ利用できます。

比較から評価を削除するには、次の手順に従います。

1. 比較バーで、比較から削除する評価を見つけます。
2. ID の右側にある **action (<Icon icon="ellipsis-vertical" iconType="solid" />)** メニューをクリックします。
3. 一覧で **Remove from comparison** を選択します。UI が更新され、削除した評価を含まない表が表示されます。
