Freigeben über

Copilot-Transkripte und -Interaktionsdaten herunterladen

  • Artikel

Wenn Agenten Copilot verwenden, werden Agenteninteraktionen mit Copilot wie das Kopieren von Zusammenfassungen, das Verwenden eines Antwortvorschlags, Feedback und Chat-Transkripte in den Tabellen Copilot-Interaktion (msdyn_copilotinteraction), Copilot-Interaktionsdaten (msdyn_copilotinteractiondata), Copilot-Transkript (msdyn_copilottranscript) und Copilot-Transkriptdaten (msdyn_copilottranscriptdata) in Dataverse gespeichert. Sie können die Transkripte und Interaktionsdaten mithilfe der Dataverse Web-API oder des SDK für .NET 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.

Unterhaltungszusammenfassung abrufen

Wenn ein Agent Copilot verwendet, um eine Gesprächszusammenfassung zu generieren, wird die Zusammenfassung in der msdyn_copilotinsights Tabelle gespeichert in Dataverse. In der Tabelle wird ein Datensatz mit einer eindeutigen Unterhaltungs-ID erstellt, die im msdyn_conversationid Feld gespeichert wird. Der Zusammenfassungstext wird im msdyn_copilotsummary Feld gespeichert.

Beispielsweise verwendet ein Agent nach dem Abschluss einer Konversation mit einem Kunden Copilot, um eine Gesprächszusammenfassung zu generieren. Die Gesprächszusammenfassung wird in der msdyn_copilotinsights Tabelle mit den folgenden Werten gespeichert.

Attribute Beispielwert
msdyn_conversationid 70b76ab52-120b-49e6-9dce-53f235125a01
Unterhaltungszusammenfassung Problem: Problem mit dem Brühventil an der Kaffeemaschine. Schritte zur Fehlerbehebung: Der Kunde hat das Problem gemeldet. Ergebnis: Problem zur weiteren Unterstützung gemeldet.

Sie können die Gesprächszusammenfassung wie folgt abrufen:

  1. Identifizieren Sie die eindeutige Unterhaltungs-ID der Unterhaltung in der msdyn_conversationid Tabelle msdyn_copilotinsights. In unserem Beispiel lautet dieser Wert 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. Filtern Sie die msdyn_conversationinsights Tabelle mit der erforderlichen Konversations-ID, um die Zusammenfassung zu erhalten. Verwenden Sie die folgende Web-API-Anforderung, um die Daten nach Unterhaltungs-ID zu filtern.

    
 [Organization URI]/api/data/v9.0/msdyn_conversationinsights $filter=msdyn_conversationid_value eq '<conversation-ID>'

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

     https://<yourorg>.crm.dynamics.com/api/data/v9.0/msdyn_conversationinsights?$filter=_msdyn_conversationid_value eq '70b76ab52-120b-496e-9dce-53f235125a01'

Die Beispielantwort für unser Beispiel lautet wie folgt:

{
"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."
}

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:

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

  2. 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 aus dem Datensatz lauten wie folgt.

    Attribute Definition Wert für unser Szenario
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid Gruppiert mehrere verknüpfte Copilot-Interaktionen.
    Beispiel: Ein Agent stellt Copilot eine Frage und markiert dann die erhaltene Antwort mit dem Daumen nach oben. Diese werden als zwei Interaktionen betrachtet, sind aber Teil desselben Szenarios.    		 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Bezieht sich auf die vom Agenten verwendete Funktion. Stellen Sie eine Frage
    msdyn_interactiontypename Bezieht sich auf die spezifische Agenteninteraktion mit Copilot. Generiert
    msdyn_interactionforid Der Vorgang oder die Unterhaltung, aus der heraus der Agent mit Copilot interagiert hat 1cd6023d-d326-ee11-9966-000d3a3411cf (Anfrage, von der aus die Interaktion initiiert wurde)
    msdyn_interactioncontext Zusätzlicher Kontext, z. B. Verweis auf Transkripte.
    msdyn_interactiondataid Verweist auf msdyn_copilotinteractiondata Entität, die Interaktionsdaten enthält

    Kopieren Sie den Wert der DataId aus dem 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 lautet dieser Wert 0a7a438f-c2a5-58d7-e03d-c932812b3095.

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

     [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(<Transcript: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

  4. 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 Antworten geben, die Copilot liefert. Das Feedback wird in der msdyn_copilotinteraction-Tabelle in Dataverse gespeichert.

Beispiel: Die Antwort des Copilots ist nicht korrekt und der Agent wählt das Daumen-runter-Symbol aus, um Feedback zu geben. Der Agent gibt auch wörtliches Feedback. Die Anwendung erstellt einen Datensatz in der msdyn_copilotinteraction-Tabelle, wobei msdyn_interactiontypename auf ThumbsDown festgelegt ist.

Die wichtigsten Attribute für den Datensatz lauten wie folgt.

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

Sie können das wörtliche Feedback des Agenten wie folgt erhalten.

  1. Rufen Sie den msdyn_interactiondataid-Wert aus der msdyn_copilotinteraction-Tabelle ab.

  2. 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)

  3. Dekodieren Sie die base64-codierten Daten, um das wörtliche Feedback zu erhalten. Sie können zum Dekodieren der Daten ein Online-Base64-Decodertool verwenden. In unserem Beispiel ist das wörtliche Feedback in der msdyn_verbatim-Spalte verfügbar.

    
  {
  "@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.

Beispielsweise kann eine Interaktion, dass ein Agent Copilot verwendet, um eine E-Mail und eine Anfragenzusammenfassung zu generieren. Die wichtigsten Attribute für unser Beispiel lauten wie folgt.

Attribute Wert für unser Szenario
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42ae7f8e-736f-1cea-035b-6bf970b48e9c
msdyn_scenariotype Vorgangszusammenfassung
msdyn_interactiontypename 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.

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

  2. 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_copilotinteractiondatas(f9d841e5-34e7-ee11-904c-000d3a3bb867)/msdyn_interactiondata

  3. 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.

    Screenshot der dekodierten Interaktionsdaten.

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 nutzen, um Kundenprobleme zu lösen
Copilot-Analysebericht anzeigen