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

# 評価

> FailproofAI Observability 評価機能のドキュメント。

品質の問題が自動的に検出されるようになり、ユーザーからのクレームで初めて気づくということがなくなります。独自のスコアリングサービスを一度接続するだけで、FailproofAI Observability がすべての完了済み実行を自動的に評価します。ユーザーが問題を感じる前に、ヘルプフルネスの低下やハルシネーションの急増を自分で発見できます。

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/sessions-list.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=0c4d38e49a3c0e2b02bba06b2db5a2b2" alt="スコア列を持つセッションのグリッド: 各実行には評価ステータスのピルと、色分けされたヘルプフルネス・正確性・ツール効率のバッジが表示されている" width="3200" height="2000" data-path="agenteye/images/sessions-list.png" />

*セッショングリッドのすべての実行にスコアが表示されます。赤・黄・緑のバッジにより、1件もトランスクリプトを開かずに問題のある実行が一目でわかります。*

## 手動サンプリングから解放される

これまではいくつかの実行をスポットチェックして、残りは問題ないと願うしかありませんでした。今では、完了したすべてのセッションが終了した瞬間に、あなたが重視する指標でスコアリングされます。ヘルプフルネス・ツール効率・正確性・安全性など、品質基準として設定したあらゆる項目が対象です。スコアのキーはあなたが定義し、FailproofAI Observability はエバリュエーターが返すデータを保存・トレンド表示します。スコアリングを免れる実行はなく、サポートチケットで初めて回帰に気づくということもなくなります。

スコアは **`/<org-slug>/sessions`**（サイドバー → *observe* → *sessions*）のセッショングリッドに表示され、各行にバッジクラスターが付きます。基準を下回った実行だけを確認したい場合は、スコア範囲でグリッドをフィルタリングできます。たとえばヘルプフルネスが 0.5 未満の実行を絞り込めば、読む価値のある実行だけが表示されます。スコアの閲覧には `evaluations:read` 権限が必要です。

## 低スコアの原因を把握する

数値は実行が弱いことを示しますが、詳しい原因はセッションページで確認できます。任意の実行を開くと、右パネルの冒頭にサマリーが表示され、各指標のバーとともにエバリュエーター独自の理由が示されます。「正確性が 0.4 だった」という状況から、具体的に誤った主張が何だったかを数秒で特定できます。

<img src="https://mintcdn.com/exosphere/kH8rXaL6tCSRWEFy/agenteye/images/session-detail.png?fit=max&auto=format&n=kH8rXaL6tCSRWEFy&q=85&s=32faaadcccf4e46964a8d1cfd84889e4" alt="セッションの右パネル: 上部に評価サマリー、次に各指標のスコアバーと理由の記述、そして完全なイベントタイムラインが並んで表示されている" width="3200" height="2000" data-path="agenteye/images/session-detail.png" />

*セッション詳細ビュー: サマリー・各指標のスコアバー・各スコアの理由が、実行のイベントタイムラインの隣に表示されます。*

より精度の高いエバリュエーターをリリースした場合や、スコアリング前にクラッシュした実行を確認したい場合は、**再評価**ボタン（`evaluations:trigger` が必要）でその場でセッションを再スコアリングできます。最新の結果がタイムラインに追記され、以前のスコアは履歴として残ります。このボタンは **`/<org-slug>/sessions/<session-id>`** にあります。

## フリート全体の品質トレンドを監視する

1件の実行のスコアが低いのはノイズですが、コホート全体が下落しているのはシグナルです。保存したダッシュボードでスコアをトレンドとして一目で確認できます。今週と先週の平均ヘルプフルネス、エージェント別・環境別の比較などが可能です。

<img src="https://mintcdn.com/exosphere/RgxYS1UZshqb4m7m/agenteye/images/dashboard-quality.png?fit=max&auto=format&n=RgxYS1UZshqb4m7m&q=85&s=0cbe5452995b2ff187f72b8978716bb3" alt="品質ダッシュボード: エバリュエーターの指標ごとの平均スコアバーと時系列トレンドが並んで表示されている" width="2880" height="1800" data-path="agenteye/images/dashboard-quality.png" />

*保存した品質ダッシュボードは指定したスコアキーをトレンド表示するため、インシデントになる前にゆるやかな下落を早期に検知できます。*

ダッシュボードは **`/<org-slug>/dashboards`**（サイドバー → *analyze* → *dashboards*）にあり、組織全体で共有されます。各カードは対象セッションを集計し、件数・各指定スコアの平均・トレンドのスパークラインを表示します。「セッションで開く」をクリックすると、任意の数値の背後にあるフィルタリング済みの実行に直接移動できます。閲覧には `dashboards:read` と `evaluations:read` の両方が必要です。

## エバリュエーターを一度接続する

スコアリングはオプトイン制で、FailproofAI Observability をスコアラーに向けるまで完全に無効です。小さな HTTP サービスを立ち上げ（Observability にはコピーして使える参照実装が含まれています）、サーバーに 2 つの値を設定すれば、それ以降のすべての実行が自動的にスコアリングされます。詳細なウォークスルー・スコアリングの仕様・SDK は詳細ガイドに記載されています。

## 関連ドキュメント

* [評価スイート](/ja/agenteye/evaluation-suite): エバリュエーターの接続・スコアリングの仕様・SDK。
* [セッション](/ja/agenteye/sessions): スコアが表示される実行ごとのグリッド。
* [ダッシュボード](/ja/agenteye/dashboards): 組織全体の品質トレンドを保存・共有。
* [監査](/ja/agenteye/audits): クロスセッション調査向けの Observability のもう一つの自動品質機能。
