トラジェクトリ特徴は、実行プロセスにおける識別可能な振る舞いをイベントとして整理します。これにより、ツール、エージェント、モデル、またはファイルといったディメンションで問題をフィルタリングし、特定の実行ステップに戻ってエビデンスを確認できます。
範囲と前提条件
このページでは、ツール、スキル、メモリ、ファイルの 4 種類の特徴を利用できます。この機能を使用する前に、対応する特徴処理とクエリ機能が現在の環境で利用可能であること、またリソースにイベントデータが存在することを確認してください。
|
特徴タイプ |
主な目的 |
解釈に関する注記 |
|
ツール |
ツール呼び出しと結果のステータスを表示します。 |
ツール API の呼び出しが成功しても、ビジネスタスクが成功したとは限りません。 |
|
スキル |
識別されたスキルの読み込みまたは利用の振る舞いを表示します。 |
スキルを読み込んでも、そのスキルが呼び出されたり、その指示が実行されたりしたわけではありません。 |
|
メモリ |
識別されたメモリアクセスの振る舞いを表示します。 |
メモリコンテンツが返されても、モデルがそのコンテンツを採用したとは限りません。 |
|
ファイル |
識別されたファイルアクセスの振る舞いを表示します。 |
イベントは、現在の収集および処理ソリューションで識別できる振る舞いのみを対象とします。 |
生ログやトラジェクトリが存在していても、必ずしも特徴イベントが存在するとは限りません。特に、スキルとメモリの識別には、収集されたコンテンツと処理設定のマッチングが必要です。このページは既存のイベントのクエリに使用するもので、一般的な特徴ルール設定ウィザードや AI プロセッサー設定ウィザードは提供しません。
イベントのクエリ
-
対象の SessionStore を開き、[トラジェクトリ特徴] を選択します。
-
時間範囲を設定し、[特徴リスト] を選択してイベントを表示します。
-
必要に応じてタイプ、エージェント、モデル、ステータスを設定するか、検索ボックスに検索条件を入力します。
-
検索ボックスを使用する場合は、[検索 & 分析] をクリックします。構造化フィルターを変更すると、更新がトリガーされます。
-
結果からイベントを開き、その詳細とエビデンスを表示します。
次の例では、ツールのイベントを検索します。現在のデータには、対応するフィールドが含まれている必要があります。
event_type:"tool" AND agent_tool_name:"search_order"
トラジェクトリのイベントをクエリするには、次のステートメントを使用します。
trajectory_id:"demo-trajectory-001"
注:特徴フィールドは、トラジェクトリリストのフィールドと完全に同じではありません。たとえば、ツールイベントの名前はagent_tool_nameを使用しますが、トラジェクトリ内のツールのセットはtool_namesを使用します。最初にイベント JSON またはクエリと分析のプロパティを表示して、実際のフィールドを確認してください。特徴内のエージェントは、イベントが属するノードを示しており、必ずしもトラジェクトリの代表的なエージェントではありません。
結果の編成モードの切り替え
特徴リストは、次の編成モードをサポートしています。
|
モード |
目的 |
|
イベント詳細 |
レコードごとに特定の振る舞いを表示します。時間の並び順を変更できます。 |
|
トラジェクトリ別のサマリー |
イベント数が多かったり、障害が集中していたりするトラジェクトリを検索します。 |
|
エージェント別のサマリー |
異なるエージェントのイベント分布を比較します。 |
|
モデル別のサマリー |
関連するモデルのイベント分布を比較します。 |
サマリー結果は、イベント数、障害数、およびその他のメトリクスで並べ替えることができます。詳細とサマリーの両方がページネーションをサポートしています。現在のオプションは、1 ページあたり 20、50、100 エントリです。
フィルターオプション候補の横にあるカウントは、正式な結果とは異なる範囲を使用する場合があるため、正確な合計として使用しないでください。一致するイベントの数を確認するには、クエリを送信した後の結果を参照してください。
ログビューの表示
イベントレコードの特定のフィールドを確認するには、[ログビュー] に切り替え、時間範囲とクエリ条件を確認してから、クエリを再度実行します。ログビューは、アプリケーションの生ログではなく、処理済みの特徴イベントをクエリします。イベントに複数のバージョンがある場合、ログの数が特徴リスト内の重複排除されたイベントの数と異なることがあります。
表示モードが異なると、それぞれ独自のクエリ状態が保持される場合があります。切り替えた後は、再度条件を確認してください。
集計レポートの表示
[集計レポート] に切り替えると、現在の時間範囲とフィルター条件におけるイベント統計 (合計イベント数、関連するトラジェクトリ、ツールイベント、失敗したイベントなど) と、タイプ、ステータス、ツール、エージェント、モデル、ファイル別の分布を表示できます。
レポートの統計は、現在表示されているリストページの単純な合計ではありません。ランキングチャートには上位の項目のみが表示される場合があり、表示されていないオブジェクトにイベントがないとは限りません。
範囲に関する以下の違いにご注意ください。
-
傾向はイベントの記録時間によって整理されており、ビジネスアクションの実際の発生時間の分布として直接使用しないでください。
-
グループ化された結果からドリルダウンしてからレポートに切り替える場合は、フィルター条件を再度確認してください。グループの制限が自動的にレポートの条件になると想定しないでください。
-
現在のレポートは、ダッシュボードテンプレートの選択や編集をサポートしていません。自由に配置できる完全なダッシュボードとして使用しないでください。
イベントからの実行エビデンスの表示
-
イベントリストでイベントを開きます。
-
[詳細] タブで、イベントのタイプ、名前、ステータス、および関連する識別子を表示します。
-
[エビデンス] タブで、利用可能なコンテンツを表示し、ページ上のエントリを使用して実行ステップを特定するか、生のトラジェクトリを開きます。
-
[イベント JSON] を表示します。
同じツール呼び出しが、ファイル、スキル、またはメモリのイベントに同時に関連付けられる場合があります。関連するイベントを使用して操作を理解できますが、それらすべてをツール呼び出し回数として合計することはできません。
イベントのエビデンスには、対応するバージョンのトラジェクトリレコードが必要です。ページにエビデンスが見つからない旨のプロンプトが表示されたり、対象のバージョンが存在しなかったり、アクセス権限がなかったりする場合は、代わりに新しいバージョンを使用して過去の結論を導き出さないでください。
イベントステータスと更新の理解
|
ステータスまたは事象 |
意味 |
|
成功 |
現在のイベントによって報告されたインターフェイスまたは操作が成功したことを示します。ビジネス上の結果は別途考慮する必要があります。 |
|
エラー |
現在のイベントには障害シグナルが含まれています。実行エビデンスをさらに確認できます。 |
|
完了 |
イベントは終了しましたが、ビジネス上の成否が必ずしも確定したわけではありません。 |
|
不明または情報欠落 |
対応する判断を下すにはデータが不十分です。これは成功を意味するものではなく、自動的に障害としてカウントされるべきではありません。 |
特徴クエリは、まず現在の時間と条件でイベントをフィルタリングし、次に一致したイベントのより新しいバージョンを選択します。たとえば、エラーステータスによるクエリは、その後回復した過去のエラーレコードに一致する場合があります。イベントがまだ失敗しているかどうかを確認するには、更新レコードと対応するエビデンスをさらに確認してください。
空のリストまたはリクエストの失敗
リストが空の場合は、フィルターをクリアし、時間範囲を適切な範囲に拡大してから、対応するイベント処理が有効になっているかどうかを確認してください。スキルまたはメモリのイベントが存在しないからといって、アプリケーションに関連する振る舞いがないとは限りません。
ページにリソースが存在しない、または権限エラーが発生したと明示的に報告された場合は、まずリソースと権限の問題を解決してください。リクエストの失敗をイベントがゼロであると解釈しないでください。同様に、レポートでは、取得に失敗した統計の代わりに空の結果を使用しないでください。