分享方式：

透過 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，首先您需要將您的檢測金鑰新增至專案。

  1. 瀏覽至設定底下的 Copilot 詳細資訊頁面。

  2. 切換至進階索引標籤。

  3. 在 Application Insights 區段中，填入連接字串設定。 請參閱Azure 監視器文件了解如何找出您的連接字串。

  4. 或者，您可以選擇啟用下列其中一個設定。

    • Log activities：如果啟用，則會記錄傳入/傳出消息和事件的詳細資訊。

    • 日誌敏感活動屬性：如果啟用，則日誌中將包含某些屬性的值，這些屬性可能被視為對傳入/傳出消息和事件敏感。 會被視為可能具敏感性的屬性包括 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