在 Power Apps 中下載交談文字記錄

2025-04-23

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

重要

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

本文說明如何在 Power Apps 中下載交談文字記錄，以及如何使用這些文字記錄在 Power BI 中建立報表。若要直接在 Copilot Studio 中下載文字記錄，請參閱在 Copilot Studio 中下載交談文字記錄。

Power Apps 預設會下載過去 30 天的交談文字記錄。您可以變更保留期間。

注意

使用 SharePoint 作為知識來源的代理程式回應不包含在對話記錄中。

交談記錄不適合：

Microsoft Dataverse for Teams 環境
Dataverse 開發人員環境
Microsoft 365 Copilot 代理程式

先決條件

若要查看交談文字記錄，您需要記錄檢視者資訊安全角色。只有管理員才能授予文字記錄檢視者資訊安全角色。

從 Power Apps 入口網站檢視和匯出交談文字記錄

登入 Power Apps。
在側邊窗格中，選擇資料表，然後選擇全部。
在搜尋方塊中輸入「交談」。
選取 ConversationTranscript 表格。

ConversationTranscript 表的頁面將會開啟。
在頂部功能表列上，選擇匯出>匯出資料。

編譯資料以供匯出需要幾分鐘的時間。
等待 Power Apps 幾分鐘準備要匯出的資料，然後選擇下載匯出的資料。

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

了解交談文字記錄

交談記錄是 CSV (逗點分隔值) 檔案。下表說明交談文字記錄中最重要的欄位。

欄位	Description	範例
`Content`	JSON 格式的完整文字記錄	請參閱內容欄位
`ConversationStartTime`	交談的開始時間 (不是交談文字記錄寫入資料存放區的時間)	`2021-04-19T20:39:09Z`
`ConversationTranscript`	Dataverse 資料表中資料列的唯一識別碼	`28eccb77-xxxx-4a63-985f-ffaaadd6f391`
`Metadata`	包含代理程式 ID、租用戶 ID 和代理程式名稱的 JSON	`{"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}`
`Name`	透過 `ConversationId` 建立的自訂資料列的名稱，後面跟著 `BotId`，後面接著 `batch number`。當交談有多個分析工作階段時，批次號碼可表示順序。傳統機器人不包含批次編號。	`8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0`
`Bot_ConversationTranscript`	代理程式 ID	`aaaabbbb-0000-cccc-1111-dddd2222eeee`
`Created on`	文字記錄的建立日期與時間	`2021-04-20T02:40:13Z`

內容欄位

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

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

如需活動類型的詳細資訊，請參閱 Bot Framework 活動結構描述。

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

機碼	Description
`ID`	活動物件的唯一 GUID
`valueType`	活動中所儲存值的類型；指示活動提供的資訊 (常見活動值類型)
`timestamp`	產生活動時的時間戳記，以 Epoch 格式表示 (自 1970 年 1 月 1 日午夜 UTC 以來的秒數)
`type`	活動的類型；例如，`message`、`event` 或 `trace`
`replyToId`	目前活動正在回應的活動識別碼
`from`	包含欄位 `id` 和 `role`： `id` - 啟動程式的識別碼 `role` - 保留 0 或 1 0 - 活動來自代理程式 1 - 活動來自使用者與代理程式的互動注意：如果畫布傳入使用者的唯一識別碼，則 `id` 可用於計算與代理程式互動的活動使用者數量。如果畫布沒有傳遞識別碼，則每個交談都會傳遞一個唯一識別碼。出於安全性和隱私權考量，在將識別碼寫入文字記錄前，會對識別碼進行雜湊處理。
`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`	使用者到達主題中的問題節點，其中一個條件指向確認成功 CSAT 系統主題 (僅限傳統機器人) 或呼叫交談結束系統主題
`IntentRecognition`	使用者觸發了一個主題
`PRRSurveyRequest`	詢問使用者該主題是否已回答交談結束主題中的問題
`PRRSurveyResponse`	使用者對主題是否已回答交談結束主題中問題的回覆
`SessionInfo`	類型 (`unengaged` 或 `engaged`)、結果 (`Escalated`、`Resolved`、`Abandon`) 以及工作階段的輪替數
`VariableAssignment`	已將值指派給變數

增強轉錄本

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

啟用增強轉錄功能

打開您的代理程式。
轉至設定>進階。
選擇增強文字記錄，然後開啟在文字記錄中包含節點級詳細資訊。

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

節點級資料

當增強型記錄開啟時，每個主題呼叫的節點的記錄中都會出現一個 nodeTraceData 活動類型。下表描述了 nodeTraceData 活動值中的關鍵欄位。

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

自訂分析

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

Copilot Studio Kit 中的交談 KPI 解決方案會自動解析記錄，並將彙總資料填入 Dataverse 表中。

變更預設保留期間

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

取消現有的大量刪除工作

在 Power Apps 中，選取設定>進階設定。

Dynamics 365 入口網站會在新索引標籤中打開。
選取設定旁邊的插入號，然後選取系統下方的資料管理。
選取大量記錄刪除。
在檢視清單中，選取定期大量刪除系統作業。
選取大量刪除超過 1 個月的交談文字記錄工作。
在其他動作清單中，選取取消。

建立新的大量刪除工作

若要啟動批次刪除精靈，請選擇新增，然後在精靈中選擇下一步。
設定以下搜尋準則：
- 在尋找清單中，選取 ConversationTranscripts。
- 選取 ConversationStartTime，再選取 X 個月之前，然後輸入「12」。
  此設定將成績單保留 12 個月。視您的需要選擇不同的比較和值。
- 選擇 SchemaType，保留 equals，然後輸入「powervirtualagents」。
選取下一步。
輸入此工作的名稱，選取執行此工作每隔，然後輸入1。如果您不希望每天執行工作，請選擇其他排程。
選取下一步，然後選取送出。

為什麼我無法在 ConversationTranscript Power Apps 表中看到我的交談記錄？

管理員可以禁止將文字記錄儲存到 Dataverse。如需進一步了解如何儲存文字記錄以及如何管理存取權限，請參閱控制文字記錄存取權。

重要

不會儲存部署在開發者環境中的代理程式的文字記錄。

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

變數可用於儲存與代理程式內容或代理程式使用者相關的資料。剖析交談文字記錄中的變數和其值，可讓您依變數篩選或配量資料。

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

共用方式為