単一トレジェクトリページでは、実行データを検索可能なトレジェクトリリストに整理し、エージェント トポロジー、実行ステップ、およびステップ詳細を提供します。このトピックでは、実行を見つけて証跡をレイヤーごとに表示する方法について説明します。
前提条件
選択した形式のデータが取り込まれ、対応するトレジェクトリの処理結果とクエリ インデックスが利用できる必要があります。生データが生成された直後は、処理が完了するまでしばらくお待ちください。
トレジェクトリの検索
-
ターゲットの SessionStore を開き、[単一トレジェクトリ] を選択します。
-
時間範囲を設定します。
-
検索ボックスに SLS の検索条件を入力し、[検索 & 分析] をクリックします。条件が不要な場合は、
*を使用します。 -
または、フィルターパネルを開き、条件を設定してから [検索] をクリックします。
-
トレジェクトリリストで、対象のトレジェクトリの ID または [詳細] をクリックします。
デフォルトでは、リストにはページあたり 20 件が表示されます。ページあたり 20、50、または 100 件を選択できます。相対時間範囲を指定した新しいクエリでは時間ウィンドウが更新されますが、ページングではクエリ送信時の時間ウィンドウが使用されます。
一般的なクエリ条件
|
目的 |
例 |
|
アウタートレジェクトリ ID によるトレジェクトリの検索 |
|
|
トレース ID によるトレジェクトリの検索 |
|
|
同じセッションに属するトレジェクトリの検索 |
|
|
特定のエージェントを含むトレジェクトリの検索 |
|
|
特定のツールを含むトレジェクトリの検索 |
|
AND を使用して複数の条件を組み合わせることができます。例:
session_id:"demo-session-001" AND tool_names:"search_order"
注:トレジェクトリリストの検索ボックスは検索条件用であり、完全な SQL 分析文を入力するためのものではありません。ログ レコードをクエリしたり、現在のサービスでサポートされている SQL または SPL 文を使用したりするには、ログビューに切り替えてください。ID のみを貼り付けても、ID フィールドでの完全一致検索にはなりません。
トレジェクトリリストとログビューは、それぞれ独自のクエリと時間設定を保持しており、表示を切り替えても同じ条件が必ずしも保持されるとは限りません。同じクエリを比較するには、切り替え後に同じ検索条件を入力し、絶対時間範囲が同じであることを確認してから、[検索 & 分析] をクリックします。
構造化フィルターの使用
フィルターパネルには、エージェント、モデル、ツール、ステップ数、期間、トレジェクトリまたはセッション識別子、入力および出力コンテンツなどの条件があります。期間は、秒または分単位で、「より大きい」、「より小さい」、または範囲の条件として設定できます。
同じディメンション内の複数のモデルまたはツールの値は OR で結合され、異なるディメンションは AND で結合されます。[代表エージェント] フィルターは、実際に選択されたエージェントを含むトレジェクトリを検索するものであり、カードに表示される単一の代表エージェントに限定されません。
候補リストは、現在の時間範囲内のサンプルから取得されるため、完全なリストではありません。候補リストに表示されない値については、実際の識別子を入力してクエリを実行できます。
[検索] をクリックすると、手動で入力したクエリの末尾に条件が自動的に追加されるのではなく、新しいクエリ条件が生成されて送信されます。クエリを手動で変更した後は、保持したい条件を確認してください。フィルターをリセットしても、クエリが再度実行されるわけではありません。
入力と出力のセマンティックマッチング
現在のリソースの対象フィールドにエンベディングとベクトル インデックスがある場合、入力または出力条件でセマンティックマッチングを選択できます。対応するインデックスが存在しない場合は、代わりにキーワードマッチングが使用されます。
セマンティック距離は 0 から 1 の範囲です。距離が小さいほど類似度が高くなります。しきい値を小さくすると、再現率を向上させるのではなく、条件がより厳しくなります。セマンティックマッチングが利用可能かどうか、また対象データを取得できるかどうかは、インデックスとデータ処理のステータスにも依存します。
現在のシステム トレジェクトリ インデックスは SessionStore ページでは読み取り専用であり、このページでベクトル インデックスを有効にすることはできません。必要な場合は、サービス管理者にお問い合わせください。
トレジェクトリ詳細の確認
詳細ページは、3 つの連動するセクションで構成されています。
|
セクション |
操作 |
内容 |
|
トレジェクトリ トポロジー |
エージェントノードの選択 |
現在のスナップショットで明示的に提供されているエージェントとその関係。 |
|
実行ステップ |
ステップの選択またはステップ検索の使用 |
選択されたノードの実行イベント。ステップ検索は、現在ロードされているコンテンツのみを検索します。 |
|
ステップ詳細 |
[概要]、[リクエストパラメーター]、[結果]、[生データ] の切り替え |
現在のステップの入力と出力、ツール パラメーター、結果、および生のデータ構造。 |
セクションの幅を調整したり、セクションを最大化したりして、長い入力と出力を確認できます。
モデル、ツール、リクエスト パラメーター
[概要] タブには、収集されたデータに基づいて、モデル、トークン、期間、ツール呼び出し、ボディ テキストなどのコンテンツが表示されます。[リクエストパラメーター] タブは現在、収集されたツール パラメーターを表示するために使用されており、モデルリクエストのすべてのパラメーターが必ずしも含まれているわけではありません。
"Request Parameters Not Collected" が表示されたり、フィールドが空だったりする場合、それは現在のデータがその情報を提供していないことを示すだけです。業務上の判断として、値が欠落していることを、パラメーターがない、消費がない、または呼び出しがない、などと解釈しないでください。
履歴コンテキスト
履歴コンテキストは、以前のトレジェクトリから引き継がれたメッセージを示し、通常は折りたたまれたグループで表示されます。これは、現在のトレジェクトリが再度実行された証拠ではなく、この実行での呼び出し回数として、実際の実行ステップに単純に加算することはできません。
エージェントの関係と時間範囲
トポロジー内の集約コンテナーはデータを整理するために使用されるものであり、実際のエージェント呼び出しを表すものではありません。システムは、明示的な証拠がある関係を優先的に表示します。関係データが不完全な場合、メッセージが表示されたり、表示品質が低下したりすることがあります。
タイムラインには、現在のスナップショットで表示可能な時間範囲とステップのカバレッジが表示されます。ステップ間の間隔とカバレッジは、モデルの計算時間や完全なエージェント ライフサイクルとして直接使用することはできません。「ダウングレード」は、データの表示品質が制限されていることを示し、タスクの実行が失敗したことを意味するものではありません。
トレジェクトリスナップショット JSON の表示
[トレジェクトリスナップショット JSON] を使用して、現在選択されているレコード全体を表示します。これは、フィールドの確認や、匿名化された診断情報の提出に適しています。この機能は履歴バージョンのリストではなく、トレジェクトリのコンテンツを変更するために使用することはできません。
リストと詳細画面の違い
同じトレジェクトリが複数のスナップショットを生成することがあります。現在の時間範囲と検索結果内で、トレジェクトリリストは各トレジェクトリのより新しいスナップショットを選択し、古いスナップショットと新しいスナップショットのノードを組み合わせて完全な実行として表示することはありません。
したがって、次の点にご注意ください:
-
リスト内のトレジェクトリの数は、ログビューのレコード数と異なる場合があります。1 つのトレジェクトリが複数のスナップショット ログに対応することがあります。
-
検索条件が古いスナップショットにしか一致しない場合、そのトレジェクトリがリストに表示されても、最新の状態が依然として条件を満たしているとは限りません。
-
トレジェクトリの詳細を開くと、データが再度クエリされます。詳細画面の内容は、リストに表示されているスナップショットよりも新しい場合があります。正確な履歴状態をトラブルシューティングするには、レコード時間と処理バージョンを確認してください。
ページの状態と終了時間だけでは、業務処理の成功を証明することはできません。実際の入力と出力、ツールの結果、および業務側のレコードに基づいて判断してください。