客戶服務代表（服務代表或代表）使用 Copilot 功能，例如複製摘要、使用建議的回復、反饋和聊天。 Copilot 互動會儲存在 Dataverse 的 Copilot 互動 (msdyn_copilotinteraction)、Copilot 互動資料 (msdyn_copilotinteractiondata)、Copilot 文字記錄 (msdyn_copilottranscript) 和 Copilot 文字記錄資料 (msdyn_copilottranscriptdata) 資料表中。 您可以使用 Dataverse Web API 或 適用於 .NET 的 SDK 下載文稿和互動資料。
先決條件
- 確保在 Copilot 中為問題和電子郵件選中支援體驗資料複選框，以便系統將交易和交互數據存儲在 Dataverse 中。
- 確保您已使用全管道管理員或全管道主管角色登錄。
檢索對話摘要
當服務代表使用 Copilot 生成對話摘要時，摘要將存儲在 msdyn_conversationinsight Dataverse 的表中。 在表中創建一條記錄，並將唯一的對話ID存儲在 msdyn_ConversationId 字段中。 摘要文本存儲在 msdyn_copilotsummary 欄位中。
例如，在結束與客戶的對話后，服務代表使用 Copilot 生成對話摘要。 對話摘要以以下值存儲在 msdyn_conversationinsight 表中。
| 屬性 | 範例值 |
|---|---|
| 交談識別碼 | 70b76ab52-120b-49e6-9dce-53f235125a01 |
| 交談摘要 | “問題：咖啡機上的沖泡閥有問題。 故障排除步驟：客戶報告了問題。 結果：報告問題以便獲得進一步協助。 |
您可以按如下方式檢索對話摘要：
識別對話ID，這是
msdyn_ocliveworkitem表格中的記錄的主要識別碼。 在我們的示例中，此值為 70b76ab52-120b-49e6-9dce-53f235125a01。使用以下 Web API 請求篩選
msdyn_conversationinsight表記錄。[Organization URI]/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '<conversation-ID>'在我們的範例中，Web API 請求如下所示。
https://<yourorg>.crm.dynamics.com/api/data/v9.2/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '70b76ab52-120b-496e-9dce-53f235125a01'我們示例的範例回應如下所示：
{ "status": { "code": 20000, "message": "Successfully fetched summary from insights" }, "summary": "Issue: Trouble with the brew valve on the coffee machine.\nTroubleshooting steps: \n- Customer reported the issue.\nOutcome: Issue reported for further assistance." }
我的 Copilot 互動儲存在哪裡
每次服務代表與 Copilot 的交互都會存儲在 msdyn_copilotinteraction 表中，並具有唯一的交互 ID。 下表列出了每種交互類型的相應交互數據的存儲位置。
| 特徵 / 功能 | 表 |
|---|---|
| 詢問問題 | msdyn_copilottranscriptdata |
| 反饋、案例摘要、寫電子郵件、建議回復 | msdyn_copilotinteractiondata |
從 Copilot 互動記錄中取得 msdyn_copilotinteractionid 和 msdyn_interactiondataid
執行下載文字記錄或檢視逐字意見反應之前，您必須從 msdyn_copilotinteraction 擷取 msdyn_copilotinteractionid 的值以及對應的 msdyn_copilotinteractiondata 記錄識別碼值。 您可以使用以下 Web API 調用來獲取在msdyn_copilotinteractionid欄位中的互動 ID 和在msdyn_interactiondataid_value欄位中的互動資料 ID。
[Organization URI]/api/data/v9.1/msdyn_copilotinteractions
Accept: application/json
OData-MaxVersion: 4.0
OData-Version: 4.0
記錄中的關鍵屬性如下。
| 屬性 | 定義 |
|---|---|
| msdyn_copilotinteractionid | 實體實例的唯一標識碼 |
| msdyn_scenariorequestid | 將多個相關的 Copilot 互動組成群組。 例如：代表向 Copilot 提出一個問題，然後用豎起大拇指標記收到的回應。 雖然視為兩個互動，但屬於同一個案例。 |
| msdyn_scenariotype | 指代表使用的特徵。 |
| msdyn_interactiontype | 指特定代表與 Copilot 的互動。 |
| msdyn_interactionforid | 代表與 Copilot 互動的參考記錄的實體識別碼。 |
| msdyn_interactionforlogicalname | 代表與 Copilot 互動的參考記錄的實體邏輯名稱。 |
| msdyn_interactioncontext | 其他內容，例如文字記錄的參考。 |
| msdyn_interactiondataid | 指的是包含互動資料的 msdyn_copilotinteractiondata 實體 |
範例回應
以下回應表示代表向 Copilot 提問，然後選擇「拇指向下」按鈕以提供反饋的場景。 msdyn_scenariorequestid、msdyn_scenariotype 對於兩種互動都是一樣的。 msdyn_interactiontype 互動的值設定為 100230305 和 100230302，分別對應 Generated 和 Thumbs down。
{
"@odata.etag": "W/\"17413914\"",
"msdyn_interactiontype": 100230305,
"msdyn_clienttimestamp": "2025-03-19T08:00:34Z",
"modifiedon": "2025-03-19T08:00:34Z",
"msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
"overriddencreatedon": null,
"msdyn_scenariotype": 100230201,
"importsequencenumber": null,
"_modifiedonbehalfby_value": null,
"msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
"statecode": 0,
"msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
"_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
"versionnumber": 17413914,
"utcconversiontimezonecode": 190,
"_msdyn_interactiondataid_value": null,
"_createdonbehalfby_value": null,
"_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"createdon": "2025-03-19T08:00:34Z",
"msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}",
"msdyn_name": null,
"statuscode": 1,
"msdyn_copilotinteractionid": "c49dc43b-9804-f011-bae2-6045bd014292",
"_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"timezoneruleversionnumber": 0
},
{
"@odata.etag": "W/\"17413983\"",
"msdyn_interactiontype": 100230302,
"msdyn_clienttimestamp": "2025-03-19T08:00:37Z",
"modifiedon": "2025-03-19T08:00:41Z",
"msdyn_interactionforlogicalname": "msdyn_ocliveworkitem",
"overriddencreatedon": null,
"msdyn_scenariotype": 100230201,
"importsequencenumber": null,
"_modifiedonbehalfby_value": null,
"msdyn_interactionforid": "2cc5ea06-a4fd-4f83-8e75-0324383b953f",
"statecode": 0,
"msdyn_scenariorequestid": "cbdc1bef-6099-7f9a-f1fe-dab02e36315b",
"_organizationid_value": "7eede269-bbb1-ef11-8a64-000d3a350e1a",
"versionnumber": 17413983,
"utcconversiontimezonecode": 190,
"_msdyn_interactiondataid_value": null,
"_createdonbehalfby_value": null,
"_modifiedby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"createdon": "2025-03-19T08:00:41Z",
"msdyn_interactioncontext": "{\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"IsEmbed\":false,\"IsStandalone\":false}",
"msdyn_name": null,
"statuscode": 1,
"msdyn_copilotinteractionid": "cb9dc43b-9804-f011-bae2-6045bd014292",
"_createdby_value": "864a96d6-6bb0-ef11-a730-000d3a59065a",
"timezoneruleversionnumber": 0
},
下載聊天記錄
當服務代表 向 Copilot 提問時，聊天將保存為使用 Dataverse 表中的 UTF-16LE 字元集 msdyn_copilottranscriptdata 以 base64 編碼格式編碼的記錄。 您可以下載轉錄內容以查看 Copilot 提供的對話和回復。
例如，在處理案例時，服務代表會詢問 Copilot「如何預訂行程？ Copilot 根據知識庫文章生成回應。 如果要下載聊天記錄，請執行以下步驟：
使用 Web API 呼叫 取得互動 ID。
使用所需的互動識別碼篩選 msdyn_copilotinteraction 資料表，從
msdyn_interactioncontext屬性取得Transcript.DataID。 使用以下 Web API 請求按交互 ID 篩選數據。[Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>) Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0屬性 我們的方案的價值 msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867 msdyn_scenariorequestid 93893746-E203-E9B6-18B9-887D68D18DAF msdyn_scenariotype 詢問問題 msdyn_interactiontypename 已產生的 msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf (起始互動的案例) msdyn_interactioncontext {\"OcSessionId\":\"28dea393-c175-4788-9494-07fd42ee0884\",\"ResponseStatusCode\":20000,\"Plugins\":{\"IsContentRedacted\":false},\"Transcript\":{\"Id\":\"8d1d70e6-3297-644a-4e86-00d8973223a0\",\"DataId\":\"a1584aaf-d5bd-357d-54a8-84dbdba547f9\"},\"Filters\":{\"AgentContextFilters\":[],\"AutomatedFilters\":[]},\"Streaming\":{\"State\":\"GENERATED\"},\"ResponseSource\":{\"category\":\"KnowledgeSearch\",\"subCategory\":\"KnowledgeSearch\"},\"IsAutoPrompt\":true,\"AutoPromptTrigger\":\"follow-up-prompt\",\"IsAutoExpanded\":false,\"IsSuggestedPrompt\":false,\"IsEmbed\":false,\"IsStandalone\":false}將
msdyn_interactioncontext中的Trasncript.DataId值複製。 在我們的示例中，此值為 a1584aaf-d5bd-357d-54a8-84dbdba547f9。以下 Web API 請求以 base64/UTF-16LE 格式檢索編碼的轉錄文本。
[Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Transcript:DataID>)/msdyn_transcriptdata Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0在我們的範例中，Web API 請求如下所示。
[Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdata使用帶有UTF-16LE字元集選項的base64解碼器解碼編碼數據，以獲取轉錄文本。 您可以使用線上解碼器工具對數據進行解碼。 對於我們的示例，解碼的轉錄顯示如下。
{ "messages": [ { "id": "283c2269-b131-dac2-3aed-847bd99402e7", "requestId": "93893746-e203-e9b6-18b9-887d68d18daf", "message": "How can I book a trip?", "sequence": 0, "user": "user", "timestamp": 1711052758750, "isActivityError": false, "context": {} }, { "id": "eba9e9d5-71e2-9502-0bca-9387246fb094", "requestId": "93893746-e203-e9b6-18b9-887d68d18daf", "message": "To book a trip, follow these steps:\n\n1. Go to the travel portal.\n2. Click on \"Travel\" and then select \"Book a Trip\".\n3. Fill in your name, contact information, and the dates of your trip.\n4. Choose your destination from the drop-down menu. Here's the data you'll be working with:\n\n```json\n{\n \"id\": \"11bb11bb-cc22-dd33-ee44-55ff55ff55ff\",\n \"title\": \"Booking Travel\",\n \"source\": \"internal_kb\"\n}\n```\n\n5. Select a hotel from the drop-down menu and specify the check-in and check-out dates. If you don't want to book a hotel, you can check the \"I do not want to book a hotel\" box.\n6. Choose the type of rental car you want. If you don't want to rent a car, you can check the \"I do not want to rent a car\" box.\n7. Click \"Submit\".\n\nOnce you've submitted your booking request, you will receive a follow-up communication from a representative with a quote. You can also add any notes or additional information by clicking on the case from the My Bookings screen.", "sequence": 1, "user": "bot", "timestamp": 1711052776968, "isActivityError": false, "sources": [ { "id": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff", "title": "Booking Travel", "source": "internal_kb" } ], "context": { "customerIntent": "How to book a trip?" } } ], "context": { "chatId": "21b27e83-299d-a639-3e4a-8dcd6332e184", "sessionId": "session-id-2", "entityId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff", "entityName": "knowledgearticle" } }
檢索逐字反饋
當代表與 Copilot 互動時，他們可以提供有關 Copilot 提供的回應的反饋。 反饋存儲在 msdyn_verbatim Dataverse 表中的 msdyn_copilotinteractiondata 列中。
例如，Copilot 的回應不準確，代表選擇大拇指向下圖示來提供反饋。 該代表還提供逐字反饋。 應用程式在 msdyn_copilotinteraction 表中創建一條記錄，並將 msdyn_interactiontypename ThumbsDown 設置為。
記錄的主要屬性如下。
| 屬性 | 示例數據 |
|---|---|
| msdyn_copilotinteractionid | 817ff9e4-cbe7-ee11-904c-000d3a3bb867 |
| msdyn_scenariorequestid | 93893746-E203-E9B6-18B9-887D68D18DAF |
| msdyn_scenariotype | 詢問問題 |
| msdyn_interactiontype | 100230302 |
| msdyn_interactiontypename | ThumbsDown |
| msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
| msdyn_interactiondataid | 807ff9e4-cbe7-ee11-904c-000d3a3bb867 |
您可以獲取代表提供的逐字反饋，如下所示。
從
msdyn_copilotinteraction表中獲取所需的 msdyn_copilotinteractiondata 記錄 ID 值。運行以下 Web API 請求以檢索逐字反饋。
[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>) Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0在我們的範例中，Web API 請求如下所示。
[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)查看
msdyn_verbatim欄位中的逐字反饋。 對於我們的示例，檢索到的反饋如下所示。{ "@odata.etag": "W/\"29538313\"", "_owningbusinessunit_value": "0e9ec0a2-eb6a-ed11-9561-000d3a336228", "statecode": 0, "statuscode": 1, "_createdby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "msdyn_copilotinteractiondataid": "807ff9e4-cbe7-ee11-904c-000d3a3bb867", "_ownerid_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "modifiedon": "2024-03-21T21:42:21Z", "msdyn_verbatim": "Article is outdated", "_owninguser_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "_modifiedby_value": "586cb7a8-eb6a-ed11-9561-000d3a336228", "versionnumber": 29538313, "createdon": "2024-03-21T21:42:21Z", "msdyn_interactiondata_name": null, "overriddencreatedon": null, "importsequencenumber": null, "_modifiedonbehalfby_value": null, "msdyn_interactiondata": null, "utcconversiontimezonecode": null, "_createdonbehalfby_value": null, "msdyn_name": null, "_owningteam_value": null, "timezoneruleversionnumber": null }
下載交互數據
除了提問記錄外，對於代表與 Copilot 之間的所有其他交互，數據存儲在 msdyn_copilotinteractiondata Dataverse 的表中。
例如，交互可以是使用 Copilot 生成電子郵件或案例摘要的代表。 我們示例的關鍵屬性如下。
| 屬性 | 我們的方案的價值 |
|---|---|
| msdyn_copilotinteractionid | 0dd941e5-34e7-ee11-904c-000d3a3bb867 |
| msdyn_scenariorequestid | 42ae7f8e-736f-1cea-035b-6bf970b48e9c |
| msdyn_scenariotype | 案例摘要 |
| msdyn_interactiontype | 100230305 |
| msdyn_interactiontypename | 已產生的 |
| msdyn_interactionforid | 1cd6023d-d326-ee11-9966-000d3a3411cf |
| msdyn_interactioncontext | {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}} |
| msdyn_interactiondataid | f9d841e5-34e7-ee11-904c-000d3a3bb867 |
您可以按如下方式下載交互數據。
從
msdyn_copilotinteraction表中獲取所需的 msdyn_copilotinteractiondata 記錄 ID 值。執行以下 Web API 請求，以 base64 編碼格式從
msdyn_copilotinteractiondata表中檢索互動資料：[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)/msdyn_interactiondata Accept: application/json OData-MaxVersion: 4.0 OData-Version: 4.0在我們的範例中，Web API 請求如下所示。
[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(f9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata解碼base64編碼的數據以獲取轉錄文本。 您可以使用線上 base64 解碼器工具對數據進行解碼。 對於我們的電子郵件示例，解碼的交互數據顯示如下。
備註
提出問題、建議回復和起草電子郵件功能使用帶有 UTF-16LE 字元集的 base64 編碼器。 案例和對話摘要使用UTF-8字元集。 我們建議您使用用於對數據進行編碼的相同字元集來解碼數據。
