AIとの相互作用の調査

トレースの有効化と無効化

トレース機能は、有効になっている間、すべてのエージェント型AIリクエストに関する詳細な実行情報を記録します。

トレースデータの収集を開始するには、 AI チャットウィンドウで 「トレース 」のトグルを「 オン」 に切り替えてください。 次に、分析したいシナリオを再現してください。

トレースは最大10分間有効です。 10分後、パフォーマンスへの影響を最小限に抑えるため、トレースは自動的に停止します。 また、 「トレース 」のトグルを手動で 「オフ」 に切り替えることで、トレースを停止することもできます。

収集の停止を追跡する場合、システムは収集されたトレースデータを自動的にファイル usage.json としてダウンロードします。 このファイルをTrace Viewerにインポートすることで、実行の詳細を分析し、潜在的な問題を特定することができます。

トレース・ファイルの内容

ダウンロード usage.json されたファイルには、トレースされたエージェント型AIのリクエストに関する診断情報が含まれています。 実行内容に応じて、このファイルには次のような詳細情報が含まれます：

• リクエストおよび実行のメタデータ。
• 会話の話題が変わる。
• モデルの呼び出し。
• ツールの起動と実行状況。
• 実施スケジュール。
• トークンの使用方法。
• レイテンシおよびパフォーマンス指標。
• 実行フローに関する情報。
• エラーの詳細。

この情報は「トレースビューア」で確認できるほか、問題の調査時に開発チームやサポートチームとファイルを共有することもできます。

トレースファイルをトレースビューアにインポートする

ダウンロード usage.json したファイルをTrace Viewerにインポートし、キャプチャされたデータを可視化・分析します。 トレースビューアは、ファイル usage.json に記録されたデータをインタラクティブに可視化します。

トレースファイルをトレースビューアにインポートするには、開発 Sterling Order Management System 者ツールキット（DTK）から以下の手順を実行してください。

1. チャットアプリで、ナビゲーションサイドパネルから「 トレースビューア 」を選択します。
2. 「JSONをインポート」 をクリックし、ダウンロード usage.json したファイルを選択してください。

トレースファイルが読み込まれ、分析のためにトレースビューアに表示されます。

取得したデータの確認

Trace Viewer は、リクエストがどのように処理されるかを視覚的に表示し、エージェント、モデル、およびツールがリクエストをどのように処理するかを示します。 トレースビューアでトレースデータを確認し、リクエストの処理状況を把握し、潜在的な問題を特定します。 トレースデータは、次のような点で役立ちます。

• AIエージェントがリクエストをどのように処理したかを理解する。
• 想定されたモデルやツールが使用されたことを確認してください。
• ツールの呼び出し順序を確認してください。
• 失敗した操作やタイムアウトした操作を特定する。
• 実行タイムラインとパフォーマンス指標を分析する。
• 成功したリクエストフローと失敗したリクエストフローを比較してください。
• 問題を調査する際は、開発チームやサポートチームとトレース情報を共有してください。

ベスト・プラクティス