了解從 Power Apps 下載的交談文字記錄

您可以在 Power Apps 和 Copilot Studio 中查看、匯出和下載與 Agent 的客戶互動記錄。 每個應用程式匯出的資訊略有不同。

重要

具有環境建立者角色的製作者不會自動獲得文字記錄的存取權限。

本文涵蓋在 Power Apps 中下載對話記錄，以及如何使用這些記錄在 Power BI 中建立報表。 要直接在 Copilot Studio 中下載對話記錄，請參閱在 Copilot Studio 中下載對話記錄。

預設情況下，Power Apps 會下載過去 30 天的對話記錄。 您可以變更保留期間。

注意

當 SharePoint 做為知識來源使用時，交談謄本會包含問題，以及用於產生回應之來源文件的內容 (search_results 欄位)。 但答案不會納入 (標記為 REDACTED)。

交談記錄不適合：

  • Microsoft Dataverse for Teams 環境
  • Dataverse 開發人員環境
  • Microsoft 365 Copilot Agent

先決條件

從 Power Apps 入口網站查看和匯出對話記錄

  1. 登入 Power Apps。

  2. 在側邊窗格中，選擇資料表，然後選擇全部。

    已選取全部的資料表節點螢幕擷取畫面。

  3. 在搜尋方塊中輸入「交談」。

  4. 選取 ConversationTranscript 表格。

    ConversationTranscript 表的頁面將會開啟。

  5. 在頂端功能表列中，選擇匯出>匯出資料。

    編譯匯出資料需要幾分鐘的時間。

    顯示帶有匯出資料選項的匯出功能表的螢幕擷取畫面。

  6. 請等候幾分鐘,讓 Power Apps 準備匯出資料,然後選取下載匯出的資料。

    該檔案將以 ZIP 存檔形式儲存到瀏覽器的預設下載位置。

了解交談文字記錄

交談記錄以 Dataverse 資料表的形式存在,您可以將其下載為 CSV (逗號分隔值) 檔案。 系統決定何時以及如何將資訊記錄到交談記錄的邏輯如下:

  • 系統會在閒置 30 分鐘後,將交談儲存為交談記錄。 如果交談在非使用狀態時間後繼續進行，系統會將新活動儲存至新記錄，其 Name 值保持不變，但 ConversationStartTime 為新值。
  • 對於已發佈至電話語音管道的 Agent，交談會在結束交談事件後三分鐘逾時。
  • 每筆記錄的交談記錄上限為 1 MB (Content 資料欄)。 當交談記錄超過這個上限時,系統會將交談記錄分割成多筆記錄,這些記錄的 Name 與 ConversationStartTime 值都相同,但 Metadata.BatchId 值不同。
  • 若要合併交談記錄,請取出 Name 與 ConversationStartTime 值皆相同的所有記錄,然後依 BatchId 排序這些記錄。

下表說明交談文字記錄中最重要的欄位。

欄位 描述 範例
Content JSON 格式的完整文字記錄 請參閱內容欄位
ConversationStartTime 交談的開始時間 (不是交談文字記錄寫入資料存放區的時間) 2021-04-19T20:39:09Z
ConversationTranscript Dataverse 表中列的唯一識別碼 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata 包含 Agent 識別碼、租用戶識別碼、Agent 名稱及批次識別碼的 JSON {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name 由 ConversationId 後面加上 BotId 建立的自訂資料列名稱 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript Agent ID aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on 交談記錄建立的日期與時間 2021-04-20T02:40:13Z

內容欄位

Content 此欄位是使用者與 Agent 進行的所有活動的原始記錄。 一般活動類型包括訊息和事件：

  • 訊息活動呈現交談中顯示的內容。 訊息活動可能包含文字、語音、互動卡和二進位或未知附件。
  • 事件活動將編程資訊從用戶端或通道傳遞給 Agent 。

有關活動類型的更多資訊，請參閱 Bot Framework 活動結構描述。

下表說明內容 JSON 中的一些索引鍵欄位：

機碼 描述
ID 活動物件的唯一 GUID
valueType 活動中所儲存值的類型；指示活動提供的資訊 (常見活動值類型)
timestamp 產生活動時的時間戳記，以 Epoch 格式表示 (自 1970 年 1 月 1 日午夜 UTC 以來的秒數)
type 活動的類型；例如，message、event 或 trace
replyToId 目前活動正在回應的活動識別碼
from 包含欄位 id 和 role：
  • id叫用者的 ID
  • role - 取值為 0 或 1
    • 0 - 活動來自 Agent
    • 1 - 活動來自使用者與 Agent 的互動
注意：
如果畫布傳入使用者的唯一識別碼，則 id 可用於計算與 Agent 互動的活動使用者數量。 如果畫布沒有傳遞識別碼，則每個交談都會傳遞一個唯一識別碼。
基於安全性與隱私權考量,系統會先對識別碼進行雜湊處理,再將其寫入交談記錄。
channelId 活動來源管道的識別碼；例如 directline、msteams 或 facebook
textFormat 文字的格式；例如，plain 或 markdown
attachments 與活動相關聯的動態豐富型資料；例如，AdaptiveCards、HeroCards 或 Carousel data
text message 活動的文字
value 根據值類型的活動特定欄位；此欄位是大多數實用資訊所在的位置
channeldata 包含管道資料：
  • 訊息：
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (包含指派給變數的值)
    • CurrentMessageDetail
  • 事件：
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name 事件活動的名稱；例如，SetPVAContext

一般活動值類型

活動值類型 Description
ConversationInfo 對話是否來自 Copilot Studio 測試面板 (isDesignMode) 以及對話的語系
CSATSurveyRequest 向使用者顯示客戶滿意度 (CSAT) 問卷
CSATSurveyResponse 使用者回覆 CSAT 問卷
DialogRedirect 將使用者重新導向至其他主題
ImpliedSuccess 使用者到達主題中的問題節點,其中一個條件指向 Confirmed Success CSAT 系統主題 (僅限傳統機器人),或呼叫 End of Conversation 系統主題
IntentRecognition 使用者觸發了一個主題
PRRSurveyRequest 詢問使用者該主題是否已回答交談結束主題中的問題
PRRSurveyResponse 使用者對主題是否已回答交談結束主題中問題的回覆
SessionInfo 類型 (unengaged 或 engaged)、結果 (Escalated、Resolved、Abandon)、工作階段開始與結束時間 (startTimeUtc、endTimeUtc),以及工作階段的回合數
VariableAssignment 已將值指派給變數

增強轉錄本

您可以將 Agent 設定為產生包含節點層級資料的增強型交談記錄。 這些資料有助於追蹤某個主題內的交談流程。 例如，在管理訂單主題中，使用者可以選擇提交新訂單或擷取現有訂單。 節點級資料可以分析這些選項中的使用者行為。

啟用增強轉錄功能

  1. 打開您的 Agent。

  2. 前往設定>進階。

  3. 選取增強交談記錄,然後開啟在交談記錄中包含節點層級詳細資料。

顯示增強文字記錄設定頁面的螢幕擷取畫面。

節點級資料

開啟增強型交談記錄後,交談記錄會針對主題叫用的每個節點,納入 nodeTraceData 活動類型。 下表描述了 nodeTraceData 活動值中的關鍵欄位。

機碼 Description
nodeID 節點識別碼
nodeType 節點類型，例如，SendActivity 或 SearchAndSummarizeContent
startTime 節點被叫用的時間戳記
endTime 節點執行完畢的時間戳記
topicDisplayName 叫用節點的主題

自訂分析

某些情境，例如根據自訂變數篩選交談，需要自訂方法進行分析。 若要建置自訂分析解決方案,客戶可以將原始交談記錄擷取到自己的資料管線中,或使用附加元件,例如 Copilot Studio Kit。

Copilot Studio Kit 中的 Conversation KPIs 解決方案會自動剖析交談記錄,並將匯總資料填入 Dataverse 資料表。

變更預設保留期間

Power Apps 大量刪除作業會自動移除超過 30 天的 Agent 交談記錄。 若要讓文字記錄保留較長的時間，請取消現有的工作，並建立執行不同排程的新工作。

注意

如果您變更預設的 Dataverse 保留期間,只會影響自訂分析。 Copilot Studio 中分析頁面的保留期間不受影響。

取消現有的大量刪除工作

  1. 在 Power Apps 中，選擇設定>進階設定。

    Dynamics 365 入口網站會在新索引標籤中打開。

    Power Apps 設定功能表螢幕擷取畫面，強調顯示進階設定。

  2. 選取設定旁邊的插入號。 在系統底下,選取資料管理。

    設定功能表的螢幕擷取畫面，其中醒目顯示資料管理。

  3. 選取大量記錄刪除。

  4. 在檢視清單中，選取定期大量刪除系統作業。

    定期大量刪除工作清單的螢幕擷取畫面。

  5. 選取大量刪除超過 1 個月的交談文字記錄工作。

    大量刪除工作的清單螢幕擷取畫面，第一個工作醒目提示。

  6. 在其他動作清單中，選取取消。

    [其他動作] 清單的螢幕擷取畫面，並醒目顯示取消。

建立新的大量刪除工作

  1. 選取新增,即可啟動大量刪除精靈。 在精靈中，選取 [下一步]。

  2. 設定以下搜尋準則：

    • 在尋找清單中，選取 ConversationTranscripts。
    • 選取 ConversationStartTime，再選取 X 個月之前，然後輸入「12」。
      此設定將成績單保留 12 個月。 如有需要,您可以選擇不同的比較方式與值。
    • 選取 SchemaType,保留 equals,然後輸入「powervirtualagents」。

    大量刪除作業搜尋準則設定的螢幕擷取畫面。

  3. 選取下一步。

  4. 輸入此工作的名稱，選取執行此工作每隔，然後輸入1。 如果您不希望每天執行工作，請選擇其他排程。

    大量刪除作業名稱和執行設定的螢幕擷取畫面。

  5. 選取下一步，然後選取送出。

為什麼我在 ConversationTranscript Power Apps 表中看不到我的對話記錄？

管理員可以阻止將對話記錄儲存至 Dataverse。 如需交談記錄的儲存方式與存取權管理方式的詳細資訊,請參閱控制交談記錄存取權。

重要

部署在開發人員環境中的 Agent 不會儲存交談記錄。

充分利用交談文字記錄的訣竅

使用變數儲存與您的 Agent 內容相關的資料,或 Agent 使用者的資料。 透過剖析交談記錄中的變數及其值,您可以依變數篩選或切割資料。

交談文字記錄可能僅透過 ID 參考內容。 例如，在重新導向節點中，目的主題僅透過其 ID 來參考。 若要取得該主題的名稱，請在 Agent 內容中尋找其 ID。

  • Last updated on