具備應用洞察的代理級遙測

本文說明如何從您以標準執行架構驅動的 Copilot Studio Agent 擷取 Agent 層級遙測資料，以用於 Azure 應用程式 Insights。

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

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

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

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

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

   • 啟用日誌：若開啟，系統會記錄進出訊息與事件的詳細資訊。

   • 記錄對話細節：包含使用者 ID、使用者名稱及訊息文字（用於訊息活動）。 啟用 OpenTelemetry 追蹤時，此設定也會控制在 span 中擷取的工具輸入引數和工具輸出結果。

   • 日誌敏感活動屬性：若開啟，日誌會包含某些屬性的值，這些屬性可能被視為對接收與輸出訊息及事件敏感。

   • 節點執行事件：每當主題內的節點被執行時，記錄一個事件。

使用 Application Insights 分析機器人遙測

當您將代理連接到 Application Insights 後，使用者與代理互動時會記錄遙測資料，包括在 Copilot Studio 內的測試期間。 要查看已記錄的遙測資料，請前往 Azure 中 Application Insights 資源的日誌區塊。 在這裡，你可以使用 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

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

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

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

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

自訂維度

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

查看監控結果（預覽）

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

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

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

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

自訂並分享你的儀表板

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

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

1. 在指令列選擇 編輯 。

   

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

   

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

   

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

   Note

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

   

停用代理級的 Application Insights 遙測

為防止開發者啟用代理層級的 Application Insights 遙測，請透過 Power Platform 管理中心的資料政策封鎖 Copilot Studio 中的 Application Insights 連接器。

開始之前，請確定您擁有：

• Microsoft Entra ID 中租用戶層級的 Power Platform 管理員或 Dynamics 365 管理員角色。
• 存取部署 Copilot Studio 代理的目標環境。

要停用代理層級的 Application Insights 遙測，請依照以下步驟操作：

1. 在 Power Platform 管理中心，選擇左側欄 選安全 ，選擇 資料與隱私，然後選擇 資料政策。
2. 建立新的資料政策或編輯現有的政策。
3. 選擇該政策必須適用的環境，並選擇 「新增到政策」。
4. 在 Connectors（新政策）或 Prebuilt connectors（現有政策）步驟中，搜尋 Copilot Studio 中的 Application Insights，並選擇它。
5. 選擇「封鎖」以將 Copilot Studio 中的應用程式洞察移至「被封鎖」連接器群組。
6. 完成剩餘的政策設定步驟並發布政策。

當資料政策被強制執行時，Copilot Studio 中的應用程式洞察連接器會被封鎖於目標環境。 使用者和製作者在政策規範的環境中無法使用此連接器。

相關資訊

• 使用 Application Insights 的遙測概觀
• 使用 Application Insights 的環境層級遙測（預覽）
• 將資料匯出至 Application Insights（應用洞察）