Copilot-Transkripte und -Interaktionsdaten herunterladen

Artikel
04/15/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

Kopieren Sie den Wert von DataId. 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 
      } 
   } 
 }

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

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\": \"56d56813-04f5-ed11-8849-000d3a35dbfc\",\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": "56d56813-04f5-ed11-8849-000d3a35dbfc",
          "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": "56d56813-04f5-ed11-8849-000d3a35dbfc",
    "entityName": "knowledgearticle"
  }
}

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 oder eine Fallzusammenfassung erstellt. Die Interaktionsdaten können Sie wie folgt herunterladen:

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

Die folgende Web-API-Anforderung ruft die Interaktionsdaten aus der msdyn_copilotinteraction-Tabelle im Base64-codierten Format ab:

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

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.

Wenn Sie das vom Agent bereitgestellte Feedback herunterladen möchten, befolgen Sie dieselben Schritte. Wörtliches Feedback der Agents wird im msdyn_verbatim-Attribut in der msdyn_copilotinteractiondata-Tabelle gespeichert.

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": "ad57bad3-0bd3-ee11-9049-00224820c23e",
    "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": "ad57bad3-0bd3-ee11-9049-00224820c23e",
    "overriddencreatedon": null,
    "statecode": 0,
    "statuscode": 1,
    "timezoneruleversionnumber": 4,
    "utcconversiontimezonecode": 92,
    "versionnumber": 7310986,
    "@odata.etag": "W/\"7310986\""
  },

Siehe auch

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

Freigeben über