Dela via

Förstå nedladdade konversationsavskrifter från Power Apps

Du kan visa, exportera och hämta transkription från 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 handlar om hur du hämtar konversationstranskriptionerna i Power Apps och använder dem för att skapa rapporter i Power BI. För att hämta transkriptioner direkt i Copilot Studio, se Hämta konversationstranskriptioner i Copilot Studio.

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

Anteckning

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

Konversationstranskriptioner skrivs inte för:

  • Microsoft Dataverse for Teams-miljöer
  • Dataverse-utvecklarmiljöer
  • Microsoft 365 Copilot-agenter

Förutsättningar

Visa och exportera avskrifter i konversationer 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 ett par minuter tills Power Apps förbereder datan för export, och välj sedan Ladda ner exporterad 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 transkriptet (Content kolumnen). 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 testpanelen i Copilot Studio (isDesignMode) och konversationens språk
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 bygga skräddarsydda analyslösningar kan kunder mata in råtranskriptionerna i sina datapipelines eller använda ett tillägg, som Copilot Studio Kit.

Conversation KPIs-lösningen i Copilot Studio Kit tolkar automatiskt transkriptioner och fyller i aggregerad data i Dataverse-tabeller.

Ändra förkonfigurerad kvarhållningsperiod

Ett Power Apps massborttagningsjobb tar automatiskt bort agenttranskriptioner som är ä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å Power Apps-menyn Inställningar, med Avancerade inställningar markerat.

  2. Välj caret bredvid Inställningar. Under System, välj Datahantering.

    Skärmbild på inställningsmenyn,med Datahantering 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älj 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. Välj 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 konversationstranskriptioner i Power Apps-tabellen ConversationTranscript?

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