Dela via

Förstå nedladdade konversationsavskrifter från Power Apps

Du kan visa, exportera och ladda ned avskrifter av kundinteraktioner med din agent i både Power Apps och Copilot Studio. Informationen som respektive app exporterar är något annorlunda.

Viktigt

Tillverkare med rollen Miljöutvecklare har inte automatiskt åtkomst till transkriptioner.

Den här artikeln beskriver hur du laddar ned konversationsavskrifter i Power Apps och använder dem för att skapa rapporter i Power BI. Information om hur du laddar ned avskrifter direkt i Copilot Studio finns i Ladda ned konversationsavskrifter i Copilot Studio.

Som standard hämtar Power Apps konversationsavskrifter från de senaste 30 dagarna. Du kan ändra kvarhållningsperioden.

Anteckning

Agentsvar som använder SharePoint som kunskapskälla och använder dokument som innehåller känsliga data ingår inte i konversationsavskriften.

Konversationstranskriptioner skrivs inte för:

  • Microsoft Dataverse för Teams-miljöer
  • Dataverse-utvecklarmiljöer
  • Microsoft 365 Copilot assistenter

Förutsättningar

Visa och exportera konversationsavskrifter från Power Apps-portalen

  1. Logga in på Power Apps.

  2. I sidorutan väljer du Tabeller och välj Alla.

    Skärmdump av Tabell-noden med Alla markerade.

  3. Skriv ”konversation” i sökrutan.

  4. Välj tabellen ConversationTranscript.

    En sida för tabellen ConversationTranscript öppnas.

  5. På den övre menyraden, välj Exportera>Exportera data.

    Det tar några minuter att kompilera datan för export.

    Skärmbild som visar exportmenyn med alternativet Exportera data.

  6. Vänta några minuter tills Power Apps förbereder data för export och välj sedan Ladda ned exporterade data.

    Filen sparas som ett ZIP-arkiv till din webbläsares standardplats för hämtning.

Förstå konversationstranskriptioner

Konversationstranskriptionen finns som en Dataverse-tabell som du kan ladda ner som en CSV (komma-separerade värden) fil. Logiken som avgör när och hur systemet registrerar information till konversationstranskriptioner är:

  • Systemet sparar en konversation till en utskriftspost efter 30 minuters inaktivitet. Om konversationen återupptas efter inaktivitetstiden sparar systemet de nya aktiviteterna till en ny post med samma Name värde men med ett nytt ConversationStartTime värde.
  • För agenter som publiceras på Telephony-kanalen går samtalen ut tre minuter efter ett Slutsamtalsevenemang .
  • Varje post har en gräns på 1 MB för transkripten (kolumnen Content). När en utskrift är större än denna gräns delar systemet upp transkriptet i flera poster, alla med samma Name and-värden ConversationStartTime men med olika Metadata.BatchId värden.
  • För att slå ihop transkriptioner, ta alla poster med samma Name och ConversationStartTime värden och sortera sedan dessa poster efter BatchId.

Följande tabell beskriver de viktigaste fälten i konversationstranskriptionerna.

Fält Beskrivning Exempel
Content Hela transkriptionen i JSON-format Se Innehållsfält
ConversationStartTime Den tidpunkt då konversationen inleddes (inte den tidpunkt då transkriptionsposten skrevs till datalagret) 2021-04-19T20:39:09Z
ConversationTranscript Unik identifierare för den i Dataverse-tabellen 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON som inkluderar agent-ID, hyresgäst-ID, agentnamn och batch-ID {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Namnet på den anpassade raden som skapats från ConversationId följt av BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript Agent-ID aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Datum och tid då transkriptionsposten skapades 2021-04-20T02:40:13Z

Fältet Innehåll

Fältet Content är en rå logg över alla aktiviteter som användare hade med agenten. Vanliga aktivitetstyper är meddelanden och händelser:

  • Meddelandeaktiviteterna representerar innehåll som visas i en konversation. Meddelandeaktiviteterna kan innehålla text, tal, interaktiva kort och binär eller okända bifogade filer.
  • Händelseaktiviteter kommunicerar programinformation från en kund eller kanal till agenten.

Mer information om aktivitetstyper finns i Bot Framework aktivitetsschemat.

I följande tabell beskrivs några av huvudfälten i innehålls-JSON:

Nyckel Beskrivning
ID Unikt GUID för aktivitetsobjektet
valueType Typ av värde som lagras i aktiviteten, och som anger vilken information som aktiviteten tillhandahåller (Vanliga aktivitetsvärdetyper)
timestamp Tidsstämpel för när aktiviteten genererades, i Epoch-format (antalet sekunder sedan midnatt UTC 1 januari 1970)
type Typ av aktivitet, till exempel message, event eller trace
replyToId ID för den aktivitet som den aktuella aktiviteten svarar på
from Innehåller fältets id och role:
  • id – ID för anroparen
  • role – innehar 0 eller 1
    • 0 – aktiviteten kommer från handläggaren
    • 1 – aktiviteten kommer från den användare som interagerar med agenten
Obs!
id kan användas för att beräkna antalet aktiva användare som interagerar med agenten om användarens unika ID passerar. Om identiteten inte passeras med ett ID-nummer skickas ett unikt ID per konversation.
För säkerhet och integritet hashar systemet ID:t innan det skriver ID:t till transkriptet.
channelId ID för kanalen som aktiviteten kommer från, till exempel directline, msteams eller facebook
textFormat Textformatet, till exempel plain eller markdown
attachments Dynamiska avancerade data som är associerade med aktiviteten, till exempel AdaptiveCards, HeroCards eller Carousel data
text Texten för message aktiviteter
value Fält som är specifika för aktiviteten baserat på värdetyp: detta fält är den plats där den mest användbara informationen finns
channeldata Innehåller kanaldata:
  • för meddelanden:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (innehåller värdet som tilldelats en variabel)
    • CurrentMessageDetail
  • för evenemang:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Namnet på händelseaktivitet, t.ex. SetPVAContext

Vanliga aktivitetsvärdetyper

Aktivitetsvärdestyp Beskrivning
ConversationInfo Om konversationen kommer från testfönstret Copilot Studio (isDesignMode) och språket för konversationen
CSATSurveyRequest Användaren presenteras med en kundnöjdhetsundersökning (CSAT)
CSATSurveyResponse Användaren svarar på en CSAT-undersökning
DialogRedirect Användaren omdirigeras till ett annat ämne
ImpliedSuccess Användaren har kommit till en frågenod i ämnet där ett av villkoren pekar på Bekräftad framgång CSAT-systemämnet (endast klassiska robotar) eller kallar systemämnet Slut på konversation
IntentRecognition Användaren utlöste ett ämne
PRRSurveyRequest Användaren fick frågan om ämne besvarade frågan i ämnet Avsluta konversation
PRRSurveyResponse Användarens svar till om ämnet besvarade frågan i ämnet Avsluta konversation
SessionInfo Typen (unengaged eller engaged), utfall (Escalated, Resolved, ), Abandonstart- och sluttid för sessionen (startTimeUtc, endTimeUtc), samt antalet turer för sessionen
VariableAssignment Ett värde tilldelats en variabel

Förbättrade transkriptioner

Du kan konfigurera agenter för att generera förbättrade transkript som inkluderar nodnivådata. Dessa data hjälper till att spåra flödet i en konversation inom ett ämne. I ett ämne om att hantera beställningar kan användarna till exempel välja mellan att skicka en ny beställning eller hämta en befintlig. Data på nodnivå möjliggör analys av användarbeteende för dessa alternativ.

Aktivera förbättrade transkriptioner

  1. Öppna din agent.

  2. Gå till Inställningar>Avancerad.

  3. Välj Förbättra transkriptioner och slå sedan på Inkludera nodnivådetaljer i transkriptioner.

Skärmbild som visar inställningssidan för förbättrade transkriptioner.

Data på nodnivå

När du aktiverar förbättrade transkript innehåller transkriptet en nodeTraceData aktivitetstyp för varje nod som ett ämne anropar. Följande tabell beskriver nyckelfälten i nodeTraceData aktivitetsvärde.

Nyckel Beskrivning
nodeID Nodens identifierare
nodeType Nodtypen, till exempel, SendActivity eller SearchAndSummarizeContent
startTime Tidsstämpeln när noden anropades
endTime Tidsstämpeln när noden slutförde körningen
topicDisplayName Ämnet som anropar noden

Anpassa analyser

Vissa scenarier, till exempel filtrering av konversationer baserat på en anpassad variabel, kräver en anpassad metod för analys. För att skapa anpassade analyslösningar kan kunderna mata in rådataavskrifterna i sina datapipelines eller använda ett tillägg, till exempel Copilot Studio Kit.

Lösningen Conversation KPI:er i Copilot Studio Kit parsar automatiskt avskrifter och fyller i aggregerade data i Dataverse-tabeller.

Ändra förkonfigurerad kvarhållningsperiod

Ett massborttagningsjobb i Power Apps tar automatiskt bort agentavskrifter äldre än 30 dagar. Om du vill ha längre transkriptioner avbryter du det befintliga jobbet och skapar ett nytt jobb som körs enligt ett annat schema.

Avbryt det befintliga massborttagningsjobbet

  1. I Power Apps väljer du Inställningar>Avancerade inställningar.

    Dynamics 365-portalen öppnas på en ny flik.

    Skärmbild på menyn Power Apps Inställningar med Avancerade inställningar markerade.

  2. Välj markören bredvid Inställningar. Under System väljer du Data Management.

    Skärmbild på menyn Inställningar med Data Management markerat.

  3. Välj Massradering av poster.

  4. I listan Visa väljer du Återkommande systemjobb för massborttagning.

    Skärmbild på listan med återkommande massborttagningsjobb.

  5. Välj jobbet Massborttagning av konversationsavskrifter äldre än 1 månad.

    Skärmbild på en lista över massborttagningsjobb, med det första markerat.

  6. I listan Fler åtgärder väljer du Avbryt.

    Skärmbild av listan Fler åtgärder med Avbryt markerat.

Skapa ett nytt massborttagningsjobb

  1. Välj Ny för att starta Bulk Deletion Wizard. I guiden väljer du Nästa.

  2. Ange följande sökkriterier:

    • I listan Sök efter väljer du ConversationTranscripts.
    • Välj ConversationStartTime, väljÄldre än X månader och ange ”12”.
      Denna inställning sparar transkriptionerna i 12 månader. Välj en annan jämförelse och värde om du vill.
    • Välj SchemaType, behåll lika med och skriv in "powervirtualagents".

    Skärmbild på inställningarna för sökvillkor för massborttagning av jobb.

  3. Klicka på Nästa.

  4. Ange ett namn på jobbet, välj Kör detta jobb efter var och ange 1. Välj ett annat schema om du inte vill att jobbet ska köras varje dag.

    Skärmbild på inställningarna för namn och körning för massborttagning av jobb.

  5. Välj Nästa, och välj Skicka.

Varför kan jag inte se mina konversationsavskrifter i tabellen ConversationTranscript Power Apps?

Administratörer kan förhindra att utskrifter sparas i Dataverse. För mer information om hur transkript sparas och hur man hanterar åtkomst, se Kontrollera transkriptåtkomst.

Viktigt

Transkriptioner lagras inte för agenter som distribueras i utvecklarmiljöer.

Tips om hur du får ut så mycket som du kan av konversationens transkription

Använd variabler för att lagra data som är relevant för ditt agentinnehåll eller agentanvändare . Genom att tolka variabeln och dess värde från konversationstranskriptionen kan du filtrera eller skära upp datan efter variabeln.

Konversationstranskriptioner kan referera till innehåll endast med ID. Till exempel, i en omdirigeringsnod refereras målämne endast av dess ID. För att få namnet på detta ämne, slå upp dess ID i agentinnehållet.

  • Last updated on