> ## 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.

# セッション

> エージェント実行の完全な記録から調査を始めましょう。

セッションは、エージェントが予期しない動作をした際の最適な調査起点です。1回の実行に属するモデルのリクエスト・レスポンス、ツール呼び出し、人間との対話、エラー、評価、ポリシー判断をまとめて確認できます。

<div style={{ position: "relative", width: "100%", paddingBottom: "56.25%", height: 0, overflow: "hidden", borderRadius: "12px", margin: "1.5rem 0" }}>
  <iframe src="https://www.youtube.com/embed/VWxukZc5k7s?rel=0&playsinline=1" title="Agent tracing with Failproof AI" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture; fullscreen" allowFullScreen style={{ position: "absolute", top: 0, left: 0, width: "100%", height: "100%", border: 0 }} />
</div>

エージェントの1回の実行を、目標設定からモデル呼び出し、ツール使用、最終レスポンスまで一連の流れで追跡できます。

## セッションを見つける

<Tabs>
  <Tab title="ダッシュボード">
    1. クラウドのサイドバーで **Observe → Sessions** に移動します。
    2. 時間範囲を設定し、環境・ステータス・エージェント・セッションIDでフィルタリングします。
    3. 品質・コスト・トークン数・レイテンシで絞り込む場合は、スコアやメトリクスの範囲を追加します。
    4. 行を選択してトレースを開きます。セッションIDの横にあるコピーボタンを使うと共有が簡単です。

           <img src="https://mintcdn.com/exosphere/WgPwQzedeDNwJBTy/images/dashboard/sessions-list.png?fit=max&auto=format&n=WgPwQzedeDNwJBTy&q=85&s=f1fb545746143e87b8b5daedabfc5559" alt="環境・エージェント・ステータス・評価スコアのフィルターとともに、実行ごとに1行表示されるセッション一覧。" width="3200" height="2000" data-path="images/dashboard/sessions-list.png" />
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    fp sessions --env production --since 24h
    fp sessions --status error,timeout --agent-id checkout-agent
    fp --json sessions --session-id <session-id>
    ```

    マルチエージェント実行を展開するには `--agents`、全件取得するには `--all`、出力カラムを選択するには `--fields` を追加します。
  </Tab>
</Tabs>

## できること

* エージェント・環境・時間・モデル・イベント種別・エラー状態でセッションを検索する。
* ある結果を生み出した正確なイベントの順序を追う。
* 成功した実行と失敗した実行を比較する。
* 監査結果やアラートインシデントで使用されたエビデンスを確認する。
* オフライン記録が必要な場合にセッションをエクスポートする。

## 効果的な調査の手順

1. セッションの目標と環境を確認する。
2. 最終的な失敗だけでなく、最初のエラーや予期しない判断を特定する。
3. その直前のモデルコンテキストとツールの入力内容を確認する。
4. リトライ・レイテンシ・人間による割り込みを確認する。
5. 評価スコアとポリシー判断をレビューする。

<Card title="トレースを読む" icon="route" href="/ja/sessions/read-a-trace">
  セッションのサマリーから結果の原因となったイベントへの追い方を学びましょう。
</Card>
