[Sessions] ページでは、複数の実行記録をセッション ID ごとに整理します。これにより、複数ターンのインタラクションを表示し、特定のターンの内容からエージェントと実行ステップの分析を続ける上で役立ちます。
前提条件
-
データに有効なセッション ID が含まれ、同じビジネスセッションのすべてのターンで一貫した識別子が使用されていること。
-
関連する軌跡が処理されていること。
-
表示したいインタラクションがクエリの時間範囲に含まれていること。
セッション ID がないデータは、ユーザー名、時間の近接性、またはメッセージ内容に基づいて自動的にセッションにグループ化されません。
セッションの検索
-
目的の SessionStore を開き、[Sessions] を選択します。
-
時間範囲を設定します。
-
クエリ条件を入力して [Search & Analyze] をクリックするか、フィルターパネルを使用して [Search] をクリックします。
-
[Session List] で、目的のセッションを開きます。
セッション ID によるクエリの例:
session_id:"demo-session-001"
トレース ID でセッションを検索する例:
trace_id:"demo-trace-001"
例の識別子を実際の値に置き換えてください。リストは、エージェント、モデル、ツール、期間、入出力などの条件もサポートしています。条件の組み合わせやセマンティックマッチングの前提条件に関する詳細については、「単一の軌跡のクエリ」をご参照ください。
注意: セッションリストのフィルター条件は、一致するセッションレコードを絞り込むために使用されます。詳細を開くと、関連レコードは同じタイムウィンドウ内のセッション ID によって読み込まれ、詳細はリストの条件に一致した特定のツールやキーワードに限定されません。したがって、詳細にはリストの条件に一致したレコードよりも多くの内容が含まれる場合があります。
複数ターンのインタラクションの表示
-
[Session Content] セクションで [Formatted] を選択し、インタラクションの内容を読みやすい形式で表示します。
-
[Compact List] を使用してレコードをすばやく見つけるか、[Expand All Details] を選択してより多くの内容を表示します。
-
レコードを選択すると、右側に関連するエージェントトポロジーが表示されます。
-
トポロジーノードまたは対応する軌跡の詳細エントリをクリックすると、次のレベルの詳細に移動し、実行ステップとステップの詳細を表示できます。
-
軌跡の詳細では、ディレクトリまたは前後のナビゲーションを使用して他の軌跡に切り替えます。
[Raw Trajectory Records] には、セッションに関連付けられた処理済みのレコードが表示され、収集前の生ログは表示されません。収集されたフィールドを確認するには、SessionStore の [Raw Data] ページに切り替えてください。
[Sessions] ページで [Log View] に切り替えて、処理済みのレコードを1つずつ確認することもできます。切り替えた後、時間範囲とクエリ条件を確認してください。[Log View] はセッション ID で集約されたセッションリストではないため、レコード数が異なる場合があります。
概要と統計の理解
|
ページ情報 |
正しい解釈 |
|
セッションの入出力概要 |
現在の範囲内での初期のインタラクションの内容をプレビューするために使用されます。セッション全体の最終的な回答であるとは限りません。 |
|
軌跡レコード |
現在の範囲内の軌跡レコードの数です。ユーザーの質疑応答のターン数や一意のトレース数と等しいとは限りません。 |
|
セッション期間 |
現在読み込まれているレコードの開始から終了までの期間です。実際のモデルの計算時間と等しいとは限らず、セッションの完全なライフサイクルを網羅しているとは限りません。 |
|
トークンおよびその他の合計 |
現在利用可能なレコードから計算されます。複数のスナップショット、欠損データ、異なる統計範囲などが合計値に影響を与える可能性があります。これらの値を直接、精算の根拠として使用しないでください。 |
|
不完全な概要または切り捨てメッセージ |
このクエリの読み込み範囲または数量によって制限されます。業務上、これらのレコードしか存在しないと結論付けることはできません。 |
現在のセッション概要と詳細には、最大 1,000 レコードの読み込み制限があります。不完全なメッセージが表示された場合は、時間範囲を狭めるか、期間ごとにデータを確認してください。現在のページを完全なセッションアーカイブとして扱わないでください。
セッションは長期間にわたる場合があります。最初または最後のターンが欠落している場合は、まず時間範囲を確認し、次に収集と処理を確認してください。レコードが失われたと直接結論付けないでください。
レコードのコピーと新規ウィンドウでの表示
現在のレコードのコピー
[Copy All Raw Trajectory Records] は、現在読み込まれているセッションレコードのみをコピーします。読み込まれていないデータを自動的にクエリするわけではなく、SessionStore 全体のエクスポート機能でもありません。
レコードをコピーする前に、内容に個人情報、ビジネスデータ、またはモデルプロンプトが含まれていないかを確認し、組織の要件に従って内容を匿名化してください。
軌跡を新規ウィンドウで開く
セッション内の軌跡の詳細に [Open in New Window] オプションがある場合、現在の軌跡を個別に開いて比較分析を行うことができます。
新しいウィンドウは主に、目的の SessionStore、軌跡 ID、および対応する絶対時間範囲を保持します。手動で記述したクエリ、すべてのフィルター、現在のページ番号、または選択したエージェントやステップが引き継がれるとは限らず、処理バージョンも固定されません。
注意: ウィンドウの URL をコピーしても、アクセス権限が自動的に付与されるわけではありません。受信者はログインし、必要なリソース権限を持っている必要があります。また、URL は履歴スナップショットへの不変リンクではありません。後で URL を開いたときに、データの更新、有効期限切れ、または権限の変更が結果に影響を与える可能性があります。完全なクエリ状態を共有するための汎用的な機能は現在利用できません。