透過 Application Insights 擷取遙測
本文討論如何從您的 Microsoft Copilot Studio 副手擷取遙測資料，以便在 Azure Application Insights 中使用。
除了 Microsoft Copilot Studio 中的原生分析功能之外，您還可以將遙測資料傳送至 Application Insights。 遙測透過追蹤以下內容來深入解析您的副手：
- 發送至和從您的副手發送的紀錄訊息和事件
- 在使用者交談期間觸發的主題
- 可以從您的主題傳送的自訂遙測事件
重要
Application Insights 是 Azure 監視器的一項功能，可擴展應用程式效能管理 (APM) 工具，可讓您監控實際應用程式。 它需要訂閱 Microsoft Azure。
將您的 Copilot Studio 副手連接至 Application Insights
若要將您的副手連接至 Application Insights，首先您需要將您的檢測金鑰新增至專案。
瀏覽至設定底下的 Copilot 詳細資訊頁面。
切換至進階索引標籤。
在 Application Insights 區段中，填入連接字串設定。 請參閱Azure 監視器文件了解如何找出您的連接字串。
或者，您可以選擇啟用下列其中一個設定。
記錄活動：如果已啟用，則會記錄內送 / 外寄郵件和事件的詳細資訊。
記錄敏感性活動屬性：如果已啟用，則記錄會包含某些可能在內送/外寄郵件和事件中視為具敏感性的屬性值。 會被視為可能具敏感性的屬性包括 userid、姓名、簡訊和發言 (簡訊和發言屬性僅適用於訊息)。
使用 Application Insights 分析機器人遙測
將機器人連接至 Application Insights 之後，便會在使用者與機器人互動時 (包括在 Microsoft Copilot Studio 中進行測試時) 記錄遙測資料。 若要查看已記錄的遙測資料，請瀏覽至 Azure 中 Application Insights 資源的記錄區段。
在這裡，您可以使用 Kusto 查詢來查詢和分析您的資料。 請參閱範例查詢。
範例查詢
查詢可以像指定單一資料表 (例如 customEvents) 一樣簡單，顯示所有從 Microsoft Copilot Studio 記錄的自訂遙測事件。 但是您也可以使用 Kusto 查詢 來進一步縮小結果範圍，包括：
- 新增時間間隔
- 使用自訂維度來擴充結果。 自訂維度是已記錄的自訂屬性，以及時間戳記或事件名稱等預建欄位
- where 子句會限制根據條件傳回的資料
- 使用更多內建 Kusto 函數來判斷資訊的顯示內容和方式
下面的範例查詢會產生折線圖，顯示過去 14 天每日有多少不同使用者與您的機器人通訊。
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
重要
根據使用的管道而定，某些欄位中的資料會有所不同且或多或少適用。 例如，只有在使用者是經過驗證的使用者，且其使用者識別碼在各交談中皆保持一致時，您才能在查詢中取得正確的不重複使用者計數。 在匿名案例中，每次交談都會產生隨機使用者識別碼，此時使用者識別碼欄位便不太實用。
從您的查詢中排除來自測試交談的遙測
您的機器人會為所有交談記錄遙測，包括 Microsoft Copilot Studio 測試畫布中發生的所有交談。 如果您想要排除測試期間收集的遙測，您可以使用在所有事件上擷取的 designMode 自訂維度來擴充查詢，並在查詢中使用 where 子句。
下列範例顯示所有自訂事件，不包括透過測試畫布所擷取的事件。
customEvents
| extend isDesignMode = customDimensions['designMode']
| where isDesignMode == "False"
自訂維度
從 Microsoft Copilot Studio 接收的大部分特定活動資料都會儲存在 customDimensions 欄位中。 您可以看到在查詢中使用的自訂維度欄位，將遙測從測試交談中排除。
| 欄位 | 描述: | 範例值 |
|---|---|---|
| type | 活動的類型 | message、conversationUpdate、event、invoke |
| channelId | 管道識別碼 | emulator、directline、msteams、webchat |
| fromId | 寄件者識別碼 | <id> |
| fromName | 來自用戶端的使用者名稱 | John Bonham、Keith Moon、Steve Smith、Steve Gadd |
| locale | 用戶端來源地區設定 | en-us、zh-cn、en-GB、de-de、zh-CN |
| recipientId | 收件者識別碼 | <id> |
| recipientName | 收件者名稱 | John Bonham、Keith Moon、Steve Smith、Steve Gadd |
| 文字 | 訊息中的文字 | find a coffee shop |
| designMode | 測試畫布中發生的交談 | True / False |
