Dela via

Hämta konversationstranskriptioner i 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.

Obs

Handläggarsvar som använder SharePoint som kunskapskälla ingår inte i konversationstranskriptioner.

Konversationstranskriptioner skrivs inte för:

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

Förutsättningar

Visa och exportera transkriptioner 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ärmbild med All markerade på noden Tabeller.

  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 innan data kompileras för export.

    Skärmbild som visar exportmenyn med alternativet Exportera data.

  6. Vänta några minuter så att Power Apps kan förbereda 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 är en CSV-fil (fil med kommaavgränsade värden). Följande tabell beskriver de viktigaste fälten i konversationstranskriptionerna.

Fält Description 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 innehåller agent-ID, klientorganisations-ID och agentnamn {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name Namnet på den anpassade raden som skapas från ConversationId följt av BotId följt av ett batch number. Batchnumret anger ordern när det finns flera analyssessioner för konversationen. Klassiska robotar inkluderar inte batchnumret. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
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:

Key Description
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.
I säkerhets- och sekretessyfte hashas ID:t innan det skrivs till transkriptionen.
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 Description
ConversationInfo Oavsett om konversationen är från Copilot Studio-appens testfönster (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å CSAT-systemämnet Bekräftad framgång (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), resultatet (Escalated, Resolved, Abandon) och sessionens varvräkning
VariableAssignment Ett värde tilldelats en variabel

Förbättrade transkriptioner

Agenter kan konfigureras för att generera förbättrade transkriptioner som innehåller data på nodnivå. 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 avskrifter, aktivera sedan Inkludera information på nodnivå i avskrifter.

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

Data på nodnivå

När förbättrade transkriptioner är aktiverade visas en nodeTraceData aktivitetstyp i avskriften för varje nod som anropades av ett ämne. Följande tabell beskriver nyckelfälten i nodeTraceData aktivitetsvärde.

Key Description
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. Kunder som skapar anpassade analyslösningar kan mata in råa avskrifter i sina datapipelines eller till exempel använda ett tillägg, Copilot Studio-paket

Konversations-KPI-lösningen i Copilot Studio-paketet tolkar automatiskt transkriptioner och fyller i aggregerade 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.

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

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

  2. Välj textmarkören bredvid Inställningar och sedan, under System, väljer du 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 konversationstranskriptioner ä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. Starta guiden Massborttagning genom att välja Ny och sedan Nästa i guiden.

  2. Ange följandfe 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 ett annat värde om du vill.
    • Välj SchemaType, låtlika med vara som det är och ange ”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. Mer information om hur transkriptioner sparas och hur du hanterar åtkomst finns i Kontrollera transkriptionsåtkomst.

Viktigt

Avskrifter 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

Variabler kan användas för att lagra data som är relevanta för agentinnehållet eller agentanvändaren. Genom att parsa variabeln och dess värde från konversationstranskriptionen kan du filtrera eller skära ut data med 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.