利用應用程式洞察捕捉遙測資料

本文說明如何從您的Copilot Studio代理擷取遙測資料，用於 Azure 應用程式 Insights。

除了 Copilot Studio 內建的分析功能外，你還可以將遙測資料傳送給 Application Insights。 遙測透過追蹤以下內容來深入了解您的代理程式：

• 發送至您的 Agent 或從您的 Agent 發送的記錄訊息和事件
• 使用者對話中可觸發的主題
• 你可以從主題項目發送的自訂遙測事件

這很重要

Application Insights 是 Azure 監視器 的功能，這是一個可擴充的應用程式效能管理（APM）工具，您可以用來監控即時應用程式。 需要訂閱Microsoft Azure。

將您的 Copilot Studio 代理程式連接到應用程式洞察

要將您的代理程式連接到 Application Insights，首先將您的儀器金鑰加入代理程式的設定中。

1. 前往 Agent 的設定頁面，然後選擇進階。

2. 在 「應用洞察 」區塊中，輸入 連接字串。 請參閱Azure 監視器 文件以了解如何定位連接字串。

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

   • 記錄活動：若啟用，系統會記錄進發訊息與事件的詳細資訊。

   • 日誌敏感活動屬性：若啟用，日誌會包含某些屬性的值，這些屬性可能被視為對接收與發出訊息及事件敏感。 被視為潛在敏感的屬性有 userid、 name、 text、 （ speak 文字與語音屬性僅適用於訊息）。

使用 Application Insights 分析機器人遙測

當你將機器人連接到 Application Insights 後，使用者與機器人互動時，包括在 Copilot Studio 測試期間，它會記錄遙測數據。 要查看已記錄的遙測資料，請前往 Azure 中的 Application Insights 資源中的 Logs 區塊。

在這裡，您可以使用 Kusto 查詢來查詢和分析您的資料。 請參閱範例查詢。

範例查詢

查詢可以很簡單，只需指定一個表格，例如 customEvents，顯示所有從 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

這很重要

根據使用的管道而定，某些欄位中的資料會有所不同且或多或少適用。 例如，只有當使用者經過認證且使用者 ID 在對話中保持一致時，你才會正確統計查詢中的獨特使用者數量。 在匿名情境中，每次對話中隨機產生使用者 ID，使用者 ID 欄位的實用性較低。

在查詢中排除測試對話中的遙測資料

你的機器人會記錄所有對話的遙測數據，包括測試期間在 Copilot Studio 內發生的對話。 如果你想排除測試期間收集的遙測資料，可以用所有事件捕捉的 designMode 自訂維度來擴展查詢，並在查詢中加入 where 子句。

下列範例顯示所有自訂事件，不包括透過測試畫布所擷取的事件。

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

自訂維度

從 Copilot Studio 收到的大部分特定活動資料都儲存在 customDimensions 欄位中。 您可以看到在查詢中使用的自訂維度欄位，將遙測從測試交談中排除。

領域	描述	範例值
型別	活動的類型	message、conversationUpdate、event、invoke
頻道ID	管道識別碼	emulator、directline、msteams、webchat
fromId	寄件者識別碼	<id>
fromName	來自用戶端的使用者名稱	John Bonham、Keith Moon、Steve Smith、Steve Gadd
地區設定	用戶端來源地區設定	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

檢視監視結果 （預覽版）

這很重要

本文包含 Microsoft Copilot Studio 預覽版文件，內容可能有所變更。

預覽功能不供生產時使用，而且可能功能受限。 這些功能是在正式發行前先行推出，讓您能夠搶先體驗並提供意見反應。

如果你正在打造一個準備好上線的代理程式，請參考 Microsoft Copilot Studio 概述。

Copilot Studio 儀表板檢視是使用 Azure 監視器 Application Insights 中的訊號。 它透過 Azure 工作簿查詢應用程式洞察並建立視覺化。

這些檢視將總對話數、延遲、例外、工具使用及主題分析等關鍵指標整合於單一檢視中。 單一檢視為團隊提供透明度，以便他們能夠追蹤營運狀況和品質、了解趨勢並持續評估以改進其應用程式。

要存取並使用應用程式洞察中內建的監控檢視，請依照以下步驟操作：

1. 移至您的 Application Insights 資源。
2. 從左側導覽窗格中選取 [監視] 索引標籤。
3. 在 「監控 」標籤下，選擇 「工作簿」。 從工作簿畫廊開啟Copilot Studio儀表板。

自訂並分享你的儀表板

Application Insights 是一款強大的應用程式效能監控工具（APM），能提供您應用程式健康狀況與效能的洞察。

儀表板會以可編輯的工作簿形式開啟，你可以根據需求自訂並儲存。

1. 在指令列選擇 編輯 。

   

2. 根據你的使用情境調整元素。 選取三個點（...）作為元素，以便編輯、新增、移動或調整大小、克隆或移除。 例如，你可以新增一個使用 KQL 來追蹤你正在收集的自訂屬性的圖塊，而此自訂屬性不會在內建檢視中顯示。

   

3. 選擇 儲存 以儲存最新的變更，並根據需要建立不同的檢視。

   

4. 在指令列中選擇 「分享 」圖示與你的團隊分享。

   備註

   當你與團隊成員分享此工作簿時，他們必須至少具備連接的應用程式洞察資源的閱讀者角色，才能查看顯示的資訊。