Copilot-Transkripte und -Interaktionsdaten herunterladen

Artikel
12/04/2024

Wenn Agents Copilot verwenden, werden Agent-Interaktionen mit Copilot, wie das Kopieren von Zusammenfassungen, die Verwendung einer vorgeschlagenen Antwort, Feedback und Chattranskripte, in den Tabellen msdyn_copilotinteraction, msdyn_copilotinteractiondata, msdyn_copilottranscript und msdyn_copilottranscriptdata in Dataverse gespeichert. Sie können die Transkripte und Interaktionsdaten mithilfe von Web-API-Anforderungen herunterladen.

Anforderungen

Stellen Sie sicher, dass das Kontrollkästchen Agentenerfahrungsdaten im Copilot-Hilfebereich aktiviert ist, damit die Transaktions- und Interaktionsdaten vom System in Dataverse gespeichert werden.
Stellen Sie sicher, dass Sie mit der Rolle „Administrator“ oder „Vorgesetzter“ angemeldet sind.
Interaktions-ID abrufen.

Chattranskripte herunterladen

Wenn ein Agent Copilot eine Frage stellt, wird der Chat als Transkript im Base64-codierten Format in der msdyn_transcriptdata-Tabelle in Dataverse gespeichert. Sie können die Transkripte herunterladen, um das Gespräch und die Antworten von Copilot zu überprüfen.

Während der Bearbeitung eines Falls fragt der Agent beispielsweise Copilot: „Wie kann ich eine Reise buchen?.“ Copilot generiert eine Antwort basierend auf einem Wissensdatenbankartikel. Wenn Sie das Chattranskript herunterladen möchten, führen Sie die folgenden Schritte aus:

Verwenden Sie den Web-API-Aufruf, um die Interaktions-ID abzurufen.

Filtern Sie die Tabelle „msdyn_copilotinteractions“ mit der erforderlichen Interaktions-ID, um zur „DataID“ zu gelangen. Verwenden Sie die folgende Web-API-Anforderung, um die Daten nach Interaktions-ID zu filtern.


   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0

Die wichtigsten Attribute des Datensatzes sind wie folgt.

Attribute	Definition	Wert für unser Szenario
msdyn_copilotinteractionid		F0970641-C1E7-EE11-904C-000D3A3BB867
msdyn_scenariorequestid	Gruppiert mehrere verwandte Copilot-Interaktionen. Beispiel: Ein Agent stellt Copilot eine Frage und markiert die erhaltene Antwort anschließend mit einem Daumen hoch. Diese werden als zwei Interaktionen betrachtet, sind aber Teil desselben Szenarios.	93893746-e203-e9b6-18b9-887d68d18daf
msdyn_szenariotyp	Bezieht sich auf die vom Agenten verwendete Funktion.	Stellen Sie eine Frage
msdyn_Interaktionstypname	Bezieht sich auf die spezifische Agenteninteraktion mit Copilot.	Generiert
msdyn_interactionforid	Der Fall oder die Konversation, aus der der Agent mit Copilot interagierte	1cd6023d-d326-ee11-9966-000d3a3411cf (Fall, von dem aus die Interaktion initiiert wurde)
msdyn_interactioncontext	Zusätzlicher Kontext, beispielsweise Verweise auf Transkripte.
msdyn_interactiondataid	Bezieht sich auf die Entität msdyn_copilotinteractiondata, die Interaktionsdaten enthält

Kopieren Sie den Wert der DataId aus der msdyn_interactioncontext. Hier ist ein Beispiel-JSON-Kontext.


     { 
      "ResponseStatusCode": 20000, 
      "Plugins": { 
       }, 
       "Transcript": { 
       "Id": "c477c6dd-d877-c6d1-9337-31e5b54e4a1b", 
       "DataId": "0a7a438f-c2a5-58d7-e03d-c932812b3095"  
       }, 
       "Filters": { 
        "AgentContextFilters": [ 
        ], 
        "DynamicFilters": { 
          "IsApplied": false 
       } 
    } 
  }

In unserem Beispiel beträgt dieser Wert 0a7a438f-c2a5-58d7-e03d-c932812b3095.

Die folgende Web-API-Anforderung ruft das Transkript im Base64-codierten Transkript ab.

 [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Trascript:DataID>)/msdyn_transcriptdata)
 Accept: application/json  
 OData-MaxVersion: 4.0  
 OData-Version: 4.0

In unserem Beispiel lautet die Web-API-Anforderung wie folgt.

 [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(0a7a438f-c2a5-58d7-e03d-c932812b3095)/msdyn_transcriptdata

Dekodieren Sie die Base64-kodierten Daten, um das Transkript zu erhalten. Sie können zum Dekodieren der Daten ein Online-Base64-Decodertool verwenden. Für unser Beispiel wird das dekodierte Transkript wie folgt angezeigt.


{
  "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 an agent 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"
  }
}

Wörtliches Feedback abrufen

Wenn ein Agent mit Copilot interagiert, kann er Feedback zu den von Copilot bereitgestellten Antworten geben. Die Rückmeldungen werden in der msdyn_copilotinteraction Tabelle gespeichert Dataverse.

Beispielsweise ist Antwort des Copiloten nicht korrekt und der Agent wählt das Daumen-Nach-unten-Symbol aus, um Feedback zu geben. Der Agent gibt auch wörtliches Feedback. Die Anwendung erstellt einen Datensatz in der msdyn_copilotinteraction Tabelle mit der msdyn_interactiontypename Einstellung „ThumbsDown“.

Die Schlüsselattribute für den Datensatz sind wie folgt.

Attribute	Beispieldaten für unser Beispiel
msdyn_copilotinteractionid	817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	93893746-e203-e9b6-18b9-887d68d18daf
msdyn_szenariotyp	Stellen Sie eine Frage
msdyn_Interaktionstypname	ThumbsDown
msdyn_interactionforid	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext
msdyn_interactiondataid	807ff9e4-cbe7-ee11-904c-000d3a3bb867

Das wörtliche Feedback des Maklers können Sie wie folgt abrufen.

Holen Sie sich den erforderlichenmsdyn_interactiondataidWert aus der msdyn_copilotinteraction Tabelle.

Führen Sie die folgende Web-API-Anforderung aus, um das wörtliche Feedback im Base64-codierten Format abzurufen.


   [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_copilotinteractiondataid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0

In unserem Beispiel lautet die Web-API-Anforderung wie folgt.

[Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(807ff9e4-cbe7-ee11-904c-000d3a3bb867)

Dekodieren Sie die Base64-kodierten Daten, um das wörtliche Feedback zu erhalten. Sie können zum Dekodieren der Daten ein Online-Base64-Decodertool verwenden. Für unser Beispiel steht Ihnen das wörtliche Feedback in der Spalte msdyn_verbatim zur Verfügung.


  {
  "@odata.context": "https://ocrealtimeperftest001.crm.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractiondatas/$entity",
  "@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
}

Interaktionsdaten herunterladen

Für alle anderen Interaktionen zwischen Agents und Copilot werden Daten in der msdyn_copilotinteractiondata-Tabelle in Dataverse gespeichert.

Eine Interaktion kann beispielsweise darin bestehen, dass ein Agent mithilfe von Copilot eine E-Mail und eine Fallzusammenfassung generiert. Die Schlüsselattribute für unser Beispiel sind wie folgt.

Attribute	Wert für unser Szenario
msdyn_copilotinteractionid	0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid	42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_szenariotyp	Vorgangszusammenfassung
msdyn_Interaktionstypname	Generiert
msdyn_interactionforid	1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext	`{"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}`
msdyn_interactiondataid	f9d841e5-34e7-ee11-904c-000d3a3bb867

Die Interaktionsdaten können Sie wie folgt herunterladen.

Verwenden Sie den Web-API-Aufruf, um die Interaktions-ID abzurufen.

Führen Sie die folgende Web-API-Anforderung aus, um die Interaktionsdaten aus der msdyn_copilotinteraction Tabelle im Base64-codierten Format abzurufen:

 [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatas(<msdyn_interactiondataid>)/msdyn_copilotinteractiondata
 Accept: application/json  
 OData-MaxVersion: 4.0  
 OData-Version: 4.0

In unserem Beispiel lautet die Web-API-Anforderung wie folgt.

  [Organization URI]/api/data/v9.1/msdyn_copilotinteractiondatasf9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata

Dekodieren Sie die Base64-kodierten Daten, um das Transkript zu erhalten. Sie können zum Dekodieren der Daten ein Online-Base64-Decodertool verwenden. Für unser E-Mail-Beispiel werden die dekodierten Interaktionsdaten wie folgt angezeigt.

Interaktions-ID abrufen

Jede Agent-Interaktion mit Copilot wird mit einer eindeutigen Interaktions-ID in der msdyn_copilotinteraction-Tabelle gespeichert. Mit dem folgenden Web-API-Aufruf können Sie die Interaktions-ID im Feld msdyn_copilotinteractionid abrufen.

[Organization URI]/api/data/v9.1/msdyn_copilotinteractions
Accept: application/json  
OData-MaxVersion: 4.0  
OData-Version: 4.0

Die Interaktionen werden in der Antwort wie folgt angezeigt.


{
"@odata.context": "https://copilotchatorg260224.crm10.dynamics.com/api/data/v9.1/$metadata#msdyn_copilotinteractions",
"value": [
  {
    "_createdby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "createdon": "2024-03-06T06:30:58Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "78866530-afd0-ee11-904d-6045bdff74d5",
    "modifiedon": "2024-03-06T06:30:58Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-06T06:30:51Z",
    "msdyn_copilotinteractionid": "1be35d14-83db-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "78866530-afd0-ee11-904d-6045bdff74d5",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7002510,
    "@odata.etag": "W/\"7002510\""
  },
  {
    "_createdby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "createdon": "2024-03-11T04:45:40Z",
    "_createdonbehalfby_value": null,
    "importsequencenumber": null,
    "_modifiedby_value": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "modifiedon": "2024-03-11T04:45:40Z",
    "_modifiedonbehalfby_value": null,
    "msdyn_clienttimestamp": "2024-03-11T04:45:38Z",
    "msdyn_copilotinteractionid": "d44ad235-62df-ee11-904c-000d3a100664",
    "msdyn_interactioncontext": "{}",
    "_msdyn_interactiondataid_value": null,
    "msdyn_interactionforid": "f691f2d2-6fd4-ee11-904c-6045bdd8b8c9",
    "msdyn_interactionforlogicalname": "systemuser",
    "msdyn_interactiontype": 100230309,
    "msdyn_name": null,
    "msdyn_scenariorequestid": null,
    "msdyn_scenariotype": 100230201,
    "_organizationid_value": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7310986,
    "@odata.etag": "W/\"7310986\""
  },

Copilot zum Lösen von Kundenproblemen verwenden
Copilot-Analysebericht anzeigen

Freigeben über

Copilot-Transkripte und -Interaktionsdaten herunterladen

Anforderungen

Chattranskripte herunterladen

Wörtliches Feedback abrufen

Interaktionsdaten herunterladen

Interaktions-ID abrufen

Feedback

Zusätzliche Ressourcen

Freigeben über

Copilot-Transkripte und -Interaktionsdaten herunterladen

Anforderungen

Chattranskripte herunterladen

Wörtliches Feedback abrufen

Interaktionsdaten herunterladen

Interaktions-ID abrufen

Verwandte Informationen

Feedback

Zusätzliche Ressourcen