共用方式為

使用交談文字記錄

  • 發行項

重要

在對生成式 AI 進行大量投資並增強 Microsoft Copilot 的整合後，Power Virtual Agents 的功能和特性現已成為 Microsoft Copilot Studio 的一部分。

當我們更新文件和培訓內容時，某些文章和螢幕擷取畫面可能會參考 Power Virtual Agents。

您可以在 Power Apps 和 Microsoft Copilot Studio 中查看、匯出和下載客戶與副手互動的文字記錄。 每個應用程式匯出的資訊略有不同。 本文說明如何在 Power Apps 中下載交談文字記錄，以及如何使用這些文字記錄在 Power BI 中建立報表。 在 Microsoft Copilot Studio 中下載副手工作階段文字記錄。

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

注意

如果您無法存取您的環境，您需要在 Power Platform 系統管理中心建立支援要求。

先決條件

從 Power Apps 入口網站查看和匯出副手交談文字記錄

您也可以從 Power Apps 入口網站查看和匯出副手交談文字記錄。

首先，您需要使用您的認證登入 https://www.powerapps.com。

檢視交談文字記錄

  1. 在側窗格中選取表格節點。 在頂端選取全部。

    顯示表格節點上選取全部的螢幕截圖。

  2. 在右上端的搜尋文字方塊中輸入交談。 選取表格底下的 ConversationTranscript。

    顯示選取交談文字記錄的螢幕擷取畫面。

  3. 將會打開 ConversationTranscript 表格的頁面，並顯示可供查看的資料清單。

    顯示使用交談文字記錄展開的螢幕擷取畫面。

匯出交談文字記錄

  1. 在側窗格中，選取表格節點。 在頂端選取全部。

    在表格節點上選取全部。

  2. 在右上端的搜尋文字方塊中，輸入交談。 選取表格底下的 ConversationTranscript。

    選取要匯出的文字記錄。

  3. 展開畫面最上方的匯出功能表項目，並選取匯出資料。 資料可能需要數分鐘編譯才能匯出。

    從匯出功能表中選取匯出資料。

  4. 選取下載匯出的資料以下載內容。

    下載匯出的資料。

下載副手對話文字記錄

  1. 在 Power Apps 導覽功能表中，選取 Dataverse，然後選取資料表。

  2. 全選。

  3. 在右上角的搜尋文字方塊中，輸入交談。

  4. 選取 ConversationTranscript 表格。

    Power Apps 資料表頁面的螢幕擷取畫面，其中反白顯示 ConversationTranscript 表格。

  5. 選取匯出，然後選取匯出資料。

    ConversationTranscript 表格匯出資料選項的螢幕擷取畫面。

  6. 等待 Power Apps 幾分鐘來準備要匯出的資料。 選取下載匯出的資料。

該檔案將作為壓縮封存儲存到瀏覽器的預設下載位置。

了解交談文字記錄

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

欄位 描述 範例
Content JSON 格式的完整文字記錄 請參閱內容欄位區段。
ConversationStartTime 交談的開始時間 (不是交談文字記錄寫入資料存放區的時間) 2021-04-19T20:39:09Z
ConversationTranscript Dataverse 資料表中資料列的唯一識別碼 28eccb77-xxxx-4a63-985f-ffaaadd6f391
中繼資料 包含副手識別碼、租用戶識別碼和副手名稱的 JSON {"BotId": "198eca5f-xxxx-4ae6-8c08-835d884a8688", "AADTenantId": "72f988bf-xxxx-41af-91ab-2d7cd011db47", "BotName": "Test Bot"}
姓名 根據 ConversationId 建立的自訂資料列名稱，後面接著 BotId 和 batch number。 當交談有多個分析工作階段時，批次號碼可表示順序。 傳統機器人不包含批次號碼。 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript 副手識別碼 198eca5f-xxxx-4ae6-8c08-835d884a8688
建立時間 文字記錄的建立日期與時間 2021-04-20T02:40:13Z

內容欄位

內容欄位是使用者與副手所有活動的資料列記錄。 一般活動類型包括訊息和事件：

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

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

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

機碼 描述
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

一般活動值類型

活動值類型 描述
ConversationInfo 交談是否來自 Microsoft Copilot Studio 應用程式的測試窗格 (isDesignMode)，以及交談的地區設定
CSATSurveyRequest 向使用者顯示客戶滿意度 (CSAT) 問卷
CSATSurveyResponse 使用者回覆 CSAT 問卷
DialogRedirect 將使用者重新導向至其他主題
ImpliedSuccess 使用者已來到主題中的問題節點，其中一個條件指向「確認成功」CSAT 系統主題，或呼叫「交談結束」系統主題
IntentRecognition 主題已由使用者觸發
PRRSurveyRequest 詢問使用者該主題是否已回答「交談結束」主題中的問題
PRRSurveyResponse 使用者對主題是否已回答「交談結束」主題中問題的回覆
SessionInfo 類型 (unengaged 或 engaged)、結果 (Escalated、Resolved、Abandon) 以及工作階段的輪替數
VariableAssignment 已將值指派給變數

從交談文字記錄建置自訂 Power BI 報表

一種從交談文字記錄組建自訂報表的方法是查看需要處理的訊息數量。

輕量型方法

使用 Power BI 資料流程將 Power BI 連線至 Dataverse。 不需要其他基礎結構，且每次重新整理時都會從 Dataverse 擷取所有記錄。

圖中顯示從 Dataverse 到 Power BI 模型的資料流程。

優點 缺點
最簡單的實作。 重新整理時間可能會隨著文字記錄的增加而增加。
Dataverse 中的儲存成本很高。

標準 Azure Data Lake Storage 方法

將 Dataverse 資料匯出到 Azure Data Lake Storage。 此方法需要 Azure Data Lake Storage 帳戶，但不需要其他 Azure 基礎結構。

使用文字記錄上的 Power Platform 資料流程來準備資料，然後將資料擷取為結構化表單。

Power BI 重新整理資料流程的資料。 Power Platform 和 Power BI 管理所有電腦基礎結構。 每次重新整理都會從 Dataverse 中擷取特定日期的記錄。

圖中顯示資料從 Dataverse 流入 Azure Data Lake Storage，然後由 Power Platform 和 Power BI 進行處理。

優點 缺點
Azure Data Lake Storage 中的低儲存成本。
實作相當簡單。
無需 Azure 計算。		 重新整理時間可能會隨著每天的文字記錄增加而增加。

Azure Data Lake Storage + Synapse 方法

標準 Azure Data Lake Storage 方法中的資料大小會造成重新整理緩慢或其他作業問題。 在這種情況下，您可以使用 Azure Synapse Analytics，將它整合至 Power BI 中。

資料從 Dataverse 流入 Azure Data Lake 後再由 Azure Synapse 和 Power Platform 進行處理的圖表。

優點 缺點
重新整理的時間是固定的。
實作相當簡單。
Azure Data Lake Storage 中的低儲存成本。		 計算 Azure Synapse 的成本。

變更預設保留期間

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

取消現有的大量刪除工作

  1. 在 Power Apps 中，選取右上角的設定齒輪圖示，然後選取進階設定。

    Power Apps 設定功能表的螢幕擷取畫面，其中反白顯示 [進階設定]。

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

  2. 選取設定旁邊的插入號，然後選取系統下方的資料管理。

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

  3. 選取大量記錄刪除。

    資料管理頁面的螢幕擷取畫面，然後醒目顯示 [大量記錄刪除] 選項。

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

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

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

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

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

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

建立新的大量刪除工作

  1. 選取新增，然後選取下一步以啟動大量刪除精靈。

  2. 設定以下搜尋準則：

    • 在尋找清單中，選取 ConversationTranscripts。
    • 選取 ConversationStartTime，選取 X 個月之前，然後類型選取 12。
      此設定將成績單保留 12 個月。 視您的需要選擇不同的比較和值。
    • 將 SchemaType 設定為等於，然後輸入 powervirtualagents。

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

  3. 選取下一步。

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

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

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

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

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

在很多地方，對話文字記錄會依照其識別碼參考內容。 例如，由目前主題重新導向到的主題識別碼僅由其識別碼參考。 若要取得主題名稱，請在副手內容中尋找其名稱。