Application Insights を使用してテレメトリを取り込む

この記事では、Copilot Studio エージェントから遠隔測定データを取得して Azure Application Insightsで使用する方法について説明します。

Copilot Studio 内のネイティブな分析機能に加えて、テレメトリ データを Application Insights に送ることができます。 テレメトリは、次の追跡によってエージェントに関する分析情報を提供します。

• エージェントとの間で送受信されたメッセージとイベントを記録します
• ユーザーとの会話中にトリガーされるトピック
• トピックから送信可能なカスタム テレメトリ イベント

Copilot Studio エージェントを Application Insights に接続する

エージェント を Application Insights に接続するには、まずエージェントの構成にインストルメンテーション キーを追加する必要があります。

1. エージェントの設定ページに移動し、詳細を選択します。

2. Application Insights セクション内で、接続文字列 設定を入力します。 接続文字列の検索方法については、Azure Monitor ドキュメント を参照してください。

3. 必要に応じて、次のいずれかの設定を有効にすることができます。

   • ログ活動: 有効化すると、受信/送信のメッセージとイベントの詳細がログに記録されます。

   • 機密性の高いアクティビティ プロパティをログに記録する: 有効にすると、受信/送信のメッセージとイベントで機密性が高いと見なされる特定のプロパティの値がログに含まれます。 潜在的に機密性が高いと見なされるプロパティは、userid、name、text、speak です (text と speak プロパティはメッセージにのみ適用されます)。

Application Insights を使用してボット テレメトリを分析する

ボットを Application Insights に接続すると、Copilot Studio 内でのテスト中を含め、ユーザーがボットと対話するときにテレメトリ データがログに記録されます。 ログに記録されたテレメトリ データを表示するには、Azure にある Application Insights リソースの ログ セクションに移動します。

ここでは Kusto クエリ を使用して、データのクエリと分析を行うことができます。 クエリの例 を参照してください。

クエリの例

クエリは、Copilot Studio から記録されたすべてのカスタム テレメトリ イベントを示す customEvents など、単一のテーブルを指定するのと同じくらい簡単にできます。 ただし、Kusto クエリ を使用して、以下のような結果をさらに絞り込むこともできます;

• 時間間隔を追加する
• カスタム ディメンション を使用して結果を拡張します。 カスタム ディメンションは、タイムスタンプやイベント名などの事前に作成されたフィールドとともにログに記録されるカスタム プロパティです
• 条件に基づいて返されるデータを制限する where 句
• より多くの組み込み Kusto 関数を使用して、情報の表示内容や表示方法を決定します

以下のクエリの例では、過去 14 日間にボットと通信した 1 日あたりの個別のユーザーの数を示す折れ線グラフが表示されます。

let queryStartDate = ago(14d);
let queryEndDate = now();
let groupByInterval = 1d;
customEvents
| where timestamp > queryStartDate
| where timestamp < queryEndDate
| summarize uc=dcount(user_Id) by bin(timestamp, groupByInterval)
| render timechart

テスト会話からのテレメトリをクエリから除外する

ボットは、テスト中に Copilot Studio 内で発生した会話も含め、すべての会話のテレメトリを記録します。 テスト中に収集されたテレメトリを除外する場合は、すべてのイベントでキャプチャされる designMode カスタム ディメンションを使用してクエリを拡張し、クエリで where 句を使用できます。

以下の例は、テスト キャンバスを通じてキャプチャされたものを除く、すべてのカスタム イベントを示しています。

customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"

カスタム ディメンション

Copilot Studio から受信した特定の活動データの多くは、customDimensions フィールドに保存されます。 クエリで 使用されているカスタム ディメンション フィールドを確認 して、テスト会話からテレメトリを除外することができます。

監視結果の表示 (プレビュー)

Copilot Studio ダッシュボード ビューでは、Azure Monitor Application Insights からのシグナルを使用して、Azure ブックを使用してクエリを実行し、視覚化を作成します。

これらのビューは、会話の合計、待機時間、例外、ツールの使用状況、トピック分析などの主要なメトリックを 1 つのビューにまとめるように設計されています。 単一のビューでは、運用の正常性と品質を追跡し、傾向を理解し、継続的に評価してアプリケーションを改善できるように、チームに透明性が提供されます。

Application Insights の組み込みの監視ビューにアクセスして利用するには、次の手順に従います。

1. Application Insights に移動します。
2. 左側のナビゲーション ウィンドウから [ 監視 ] タブを選択します。
3. [ 監視 ] タブで [ ワークブック ] を選択し、ブック ギャラリーから Copilot Studio ダッシュボードを開きます。

ダッシュボードをカスタマイズして共有する

Application Insights は、アプリケーションの正常性とパフォーマンスに関する分析情報を提供する、アプリケーション パフォーマンス監視 (APM) 用の強力なツールです。

ダッシュボードが編集可能なワークブックとして開き、必要に応じてワークブックをカスタマイズして保存できます。

1. コマンド バーで、[編集] を選択します。

1. ユース ケースに必要に応じて要素を変更します。 編集、追加、移動、サイズ変更、複製、または削除する要素で 、[ ... ] を選択します。 たとえば、KQL を使用してタイルを追加して、収集するカスタム属性を追跡できます。この属性は、組み込みビューには表示されません。

1. [保存] を選択して、最新の変更を保存し、必要に応じて別のビューを作成 します。

1. コマンド バーの [共有] アイコンを選択して、チームと 共有 します。