Stažení přepisů a dat z interakcí nástroje Copilot

Zástupci oddělení služeb zákazníkům (zástupci služeb nebo zástupci) používají funkce systému Copilot, jako je kopírování souhrnů, používání navrhované odpovědi, zpětná vazba a chat. Interakce Copilota jsou uloženy v tabulkách Interakci Copilota (msdyn_copilotinteraction), Datech interakcí Copilota (msdyn_copilotinteractiondata), Přepisu Copilota (msdyn_copilottranscript) a Datech přepisu Copilota (msdyn_copilottranscriptdata) v Dataverse. Přepisy a data interakce si můžete stáhnout pomocí webového rozhraní API Dataverse nebo sady SDK pro .NET.

Od srpna 2025 jsou interakce kopilota uloženy v tabulce msdyn_copilotevents . Tabulky msdyn_copilotinteraction a msdyn_copilotinteractiondata obsahují záznamy před srpnem.

Požadavky

  • Ujistěte se, že je v aplikaci Copilot pro dotazy a e-maily zaškrtnuto políčko Data zkušeností podpory, aby systém ukládal data transakcí a interakcí do Dataverse.
  • Ujistěte se, že jste přihlášeni s rolí správce Omnikanálu nebo supervizora Omnikanálu.

Načíst souhrn konverzace

Když zástupce servisu použije Copilot ke generování souhrnu konverzace, souhrn se uloží do msdyn_conversationinsight tabulky v Dataverse. V tabulce se vytvoří záznam s unikátním ID konverzace uloženým msdyn_ConversationId v poli. Souhrnný msdyn_copilotsummary text je uložen v poli.

Například po ukončení konverzace se zákazníkem použije zástupce servisu Copilot k vygenerování souhrnu konverzace. Souhrn konverzace je uložen v msdyn_conversationinsight tabulce s následujícími hodnotami.

Vlastnost Ukázková hodnota
ID konverzace 70b76ab52-120b-49e6-9dce-53f235125a01
Shrnutí konverzace "Problém: Potíže s ventilem spařování na kávovaru. Postup řešení potíží: Zákazník problém nahlásil. Výsledek: Problém nahlášen pro další pomoc."

Shrnutí konverzace můžete načíst následovně:

  1. Identifikujte ID konverzace, což je primární identifikátor záznamu v msdyn_ocliveworkitem tabulce. V našem příkladu je tato hodnota 70b76ab52-120b-49e6-9dce-53f235125a01.

  2. K filtrování msdyn_conversationinsight záznamu tabulky použijte následující požadavek webového rozhraní API.

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

    V našem příkladu je požadavek webového rozhraní API následující.

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

    Ukázková odpověď pro náš příklad je následující:

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

Kde jsou uloženy mé interakce kopilota

Každá interakce zástupce služby s Copilot je uložena v tabulce msdyn_copilotinteraction nebo msdyn_copilotevents s unikátním ID interakce. V následující tabulce je uvedeno, kde jsou uložena odpovídající data interakce pro každý typ interakce.

Vlastnost Tabulka
Položte otázku msdyn_copilottranscriptdata
Zpětná vazba, shrnutí případu, napsání e-mailu, návrh odpovědi msdyn_copilotinteractiondata, msdyn_copilotevents

Poznámka:

Záznamy o interakcích Copilot jsou uloženy v tabulce msdyn_copilotevents od srpna 2025. Záznamy před srpnem jsou uloženy v tabulkách msdyn_copilotinteraction a msdyn_copilotinteractiondata.

Získání msdyn_copilotinteractionid a msdyn_interactiondataid ze záznamů interakcí kopilota

Než provedete akce, jako je stažení přepisu nebo zobrazení doslovné zpětné vazby, musíte načíst hodnoty msdyn_copilotinteractionid a odpovídající hodnotu ID záznamu msdyn_copilotinteractiondata z msdyn_copilotinteraction. K získání ID interakce v msdyn_copilotinteractionid poli a interactiondataid v msdyn_interactiondataid_value poli můžete použít následující volání webového rozhraní API.

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

Získejte msdyn_copilotinteractionid z Copilot Event Records

Než stáhnete přepis nebo si prohlédnete doslovnou zpětnou vazbu, musíte načíst hodnoty msdyn_copilotinteractionid z tabulky msdyn_copilotevents. Můžete použít následující volání Web API k získání ID interakce v msdyn_copilotinteractionid poli.

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

Klíčové atributy

Klíčové atributy ze záznamu jsou následující.

Vlastnost Definice
msdyn_copilotinteractionid Jedinečný identifikátor pro instance entit
msdyn_scenariorequestid Seskupí více souvisejících interakcí s Copilotem.
Příklad: Zástupce položí společnosti Copilot otázku a poté obdrženou odpověď označí palcem nahoru. Jsou považovány za dvě interakce, ale jsou součástí stejného scénáře.
msdyn_scenariotype Odkazuje na funkci používanou zástupcem.
msdyn_interactiontype Odkazuje na konkrétní charakteristickou interakci s Copilotem.
msdyn_interactionforid ID entity odkazovaného záznamu, pro který zástupce komunikoval se systémem Copilot.
msdyn_interactionforlogicalname Logický název entity odkazovaného záznamu, pro který zástupce interagoval s nástrojem Copilot.
msdyn_interactioncontext Další kontext, jako je odkaz na přepisy.
msdyn_interactiondataid Odkazuje na entitu msdyn_copilotinteractiondata, která obsahuje data o interakci

Ukázková odpověď

Následující odpověď označuje situaci, kdy zástupce položí Copilotovi otázku a poté výběrem tlačítka palec dolů poskytne zpětnou vazbu. Hodnota msdyn_scenariorequestid, msdyn_scenariotype je stejná pro obě interakce. Hodnoty msdyn_interactiontype pro interakce jsou nastaveny na 100230305 a 100230302, což odpovídá Generováno a Palec dolů.


{
          "@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
      },

Stáhněte si přepisy chatu

Když zástupce služby položí společnosti Copilot otázku, chat se uloží jako přepis zakódovaný ve formátu kódování base64 pomocí znakové sady UTF-16LE v msdyn_copilottranscriptdata tabulce v Dataverse. Můžete si stáhnout přepisy a zkontrolovat konverzaci a odpovědi poskytnuté společností Copilot.

Například při práci na případu se zástupce servisu zeptá Copilota: "Jak si mohu rezervovat cestu?". Aplikace Copilot vygeneruje odpověď na základě článku znalostní báze. Pokud si chcete stáhnout přepis chatu, proveďte následující kroky:

  1. K získání ID interakce použijte volání webového rozhraní API.

  2. Vyfiltrujte tabulku msdyn_copilotinteraction pomocí požadovaného ID interakce, abyste se dostali k atributu Transcript.DataID from msdyn_interactioncontext . Pomocí následujícího požadavku webového rozhraní API filtrujte data podle ID interakce.

    
   [Organization URI]/api/data/v9.1/msdyn_copilotinteractions(<msdyn_copilotinteractionid>)
   Accept: application/json  
   OData-MaxVersion: 4.0  
   OData-Version: 4.0
    Vlastnost Hodnota pro náš scénář
    msdyn_copilotinteractionid F0970641-C1E7-EE11-904C-000D3A3BB867
    msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
    msdyn_scenariotype Položte otázku
    msdyn_interactiontypename Vygenerováno
    msdyn_interactionforid 1CD6023D-D326-EE11-9966-000D3A3411CF (Případ, z něhož byla interakce zahájena)
    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}

  3. Zkopírujte hodnotu Trasncript.DataId z msdyn_interactioncontext. V našem příkladu je tato hodnota a1584aaf-d5bd-357d-54a8-84dbdba547f9.

  4. Následující požadavek webového rozhraní API načte kódovaný přepis ve formátu 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

    V našem příkladu je požadavek webového rozhraní API následující.

     [Organization URI]/api/data/v9.1/msdyn_copilottranscriptdatas(a1584aaf-d5bd-357d-54a8-84dbdba547f9)/msdyn_transcriptdata

  5. Přepis získáte pomocí dekodéru base64 s možností znakové sady UTF-16LE. K dekódování dat můžete použít online dekódovací nástroj. V našem příkladu se dekódovaný přepis zobrazí následovně.

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

Získat doslovnou zpětnou vazbu

Když zástupce komunikuje se společností Copilot, může poskytnout zpětnou vazbu k odpovědím, které společnost Copilot poskytuje. Zpětná vazba je uložena ve sloupci msdyn_verbatim v tabulce msdyn_copilotinteractiondata v Dataverse.

Například odpověď kopilota není přesná a zástupce vybere ikonu palce dolů, aby poskytl zpětnou vazbu. Zástupce také poskytuje doslovnou zpětnou vazbu. Aplikace vytvoří záznam v msdyn_copilotinteraction tabulce s msdyn_interactiontypename nastavenou hodnotou ThumbsDown.

Klíčové atributy záznamu jsou následující.

Vlastnost Ukázková data pro náš příklad
msdyn_copilotinteractionid 817ff9e4-cbe7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 93893746-e203-e9b6-18b9-887d68d18daf
msdyn_scenariotype Položte otázku
msdyn_interactiontype 100230302
msdyn_interactiontypename Palec dolů
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactiondataid 807ff9e4-cbe7-ee11-904c-000d3a3bb867
partitionid 20250622-20250628-100230203

Poznámka:

PartitionID je použitelný pouze pokud používáte tabulku msdyn_copilotevents .

Doslovnou zpětnou vazbu poskytnutou zástupcem můžete získat níže.

  1. Z tabulky získáte požadovanou hodnotumsdyn_copilotinteraction ID záznamu msdyn_copilotinteractiondata.

Poznámka:

Tento krok přeskočte, pokud používáte msdyn_copilotevents tabulku. msdyn_copilotinteractiondataid je již k dispozici v tabulce msdyn_copilotevents.

  1. Spuštěním následujícího požadavku webového rozhraní API načtěte doslovnou zpětnou vazbu.

    Pokud používáte tabulku msdyn_copilotevents , použijte následující:

    [Organization URI]/api/data/v9.1/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')

    V našem příkladu je požadavek na webové API následující:

    [Organization URI]/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')

  2. Prohlédněte si doslovnou zpětnou vazbu dostupnou ve sloupci msdyn_verbatim . V našem příkladu je načtená zpětná vazba následující.

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

Stahování dat o interakci

Kromě přepisů typu "zeptej se otázky" jsou pro všechny ostatní interakce mezi zástupci a Copilot data uložena v tabulce msdyn_copilotinteractiondata nebo msdyn_copilotevents v Dataverse.

Interakcí může být například zástupce využívající aplikaci Copilot k vygenerování e-mailu nebo shrnutí případu. Klíčové atributy pro náš příklad jsou následující.

Vlastnost Hodnota pro náš scénář
msdyn_copilotinteractionid 0dd941e5-34e7-ee11-904c-000d3a3bb867
msdyn_scenariorequestid 42AE7F8E-736F-1CEA-035B-6BF970B48E9C
msdyn_scenariotype Shrnutí případu
msdyn_interactiontype 100230305
msdyn_interactiontypename Vygenerováno
msdyn_interactionforid 1cd6023d-d326-ee11-9966-000d3a3411cf
msdyn_interactioncontext {"Filters":{"AgentContextFilters":[],"DynamicFilters":{"IsApplied":false}}}
msdyn_interactiondataid f9d841e5-34e7-ee11-904c-000d3a3bb867

Data interakce si můžete stáhnout následujícím způsobem.

  1. Z tabulky získáte požadovanou hodnotumsdyn_copilotinteraction ID záznamu msdyn_copilotinteractiondata.

Poznámka:

Tento krok přeskočte, pokud používáte tabulku msdyn_copilotevents. msdyn_copilotinteractiondataid je již k dispozici v tabulce msdyn_copilotevents.

  1. Spusť následující požadavek Web API pro získání interakčních dat v base64 kódovaném formátu:

    Pokud používáte tabulku msdyn_copilotevents, použijte následující:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=<GUID>,partitionid='<partitionId>')/msdyn_interactiondata/$value

    V našem příkladu je požadavek na webové API následující:

    <org-url>/api/data/v9.2/msdyn_copilotevents(msdyn_copiloteventid=f9d841e5-34e7-ee11-904c-000d3a3bb867,partitionid='20250622-20250628-100230203')/msdyn_interactiondata/$value
  1. Dekódujte data v kódování base64 a získejte přepis. K dekódování dat můžete použít online nástroj pro dekódování base64. V našem příkladu e-mailu jsou data dekódované interakce zobrazena následovně.

Poznámka:

Funkce „položit otázku“, „navrhnout odpověď“ a „napsat koncept e-mailu“ používají kodér base64 se znakovou sadou UTF-16LE. Případ a shrnutí konverzace používají znakovou sadu UTF-8. Doporučujeme použít stejnou znakovou sadu, která byla použita ke kódování dat k jejich dekódování.

Snímek obrazovky s dekódovanými daty interakce.

Použití nástroje Copilot k řešení problémů se zákazníky
Zobrazení analytické zprávy funkce Copilot

  • Last updated on