Del via


Forstå downloadede samtaletransskriptioner fra Power Apps

Du kan se, eksportere og downloade afskrifter af kundeinteraktioner med din agent i både Power Apps og Copilot Studio. De oplysninger, som de enkelte appeksporter eksporterer, er en anelse forskellige.

Vigtige oplysninger

Oprettere med rollen Miljøopretter har ikke automatisk adgang til afskrifter.

I denne artikel beskrives, hvordan du henter afskrifter af samtaler i Power Apps og bruger dem til at oprette rapporter i Power BI. Hvis du vil downloade afskrifter direkte i Copilot Studio, skal du se Downloade samtaleafskrifter i Copilot Studio.

Henter som standard Power Apps-samtaleafskrifter fra de seneste 30 dage. Du kan skifte standardopbevaringsperioden.

Bemærk

Agentsvar, der bruger SharePoint som videnkilde, medtages ikke i samtaleafskrifter.

Samtaleafskrifter skrives ikke til:

  • Microsoft Dataverse for Teams-miljøer
  • Dataverse-udviklermiljøer
  • Microsoft 365 Copilot-agenter

Forudsætning

Se og eksportere samtaleafskrifter fra Power Apps-portalen

  1. Log på Power Apps.

  2. Vælg Tabeller i sideruden og derefter Alle.

    Skærmbillede af Tabeller-noden med Alle valgt.

  3. Skriv "samtale" i feltet Søg.

  4. Vælg tabellen ConversationTranscript.

    Der åbnes en side til tabellen ConversationTranscript.

  5. Vælg Eksportér>Eksportér data på den øverste menulinje.

    Det tager et par minutter at kompilere dataene til eksport.

    Skærmbillede, der viser menuen Eksporter med indstillingen Eksporter data.

  6. Vent et par minutter på, at Power Apps forbereder dataene til eksport, og vælg derefter Download eksporterede data.

    Filen gemmes som et ZIP-arkiv på browserens standardplacering for overførsler.

Om samtaleafskrifter

Samtaletransskriptionen eksisterer som en Dataverse-tabel, du kan downloade som en CSV (komma-separerede værdier) fil. Logikken, der bestemmer, hvornår og hvordan systemet registrerer information til samtaletransskriptioner, er:

  • Systemet gemmer en samtale til en transskriptionspost efter 30 minutters inaktivitet. Hvis samtalen genoptages efter inaktivitetstiden, gemmer systemet de nye aktiviteter til en ny post med samme Name værdi, men med en ny ConversationStartTime værdi.
  • For agenter offentliggjort på Telephony-kanalen, går samtalerne ud tre minutter efter en Slut Samtale-begivenhed .
  • Hver post har en grænse på 1 MB for udskriften (Content kolonnen). Når en udskrift er større end denne grænse, opdeler systemet udskriften i flere poster, alle med samme Name og ConversationStartTime værdier, men med forskellige Metadata.BatchId værdier.
  • For at sammenflette transskriptioner skal du tage alle poster med samme Name og ConversationStartTime værdier, og derefter sortere disse poster efter BatchId.

Følgende tabel beskriver de vigtigste felter, du kan finde i dine samtaleafskrifter.

Felt Beskrivelse Eksempel
Content Hele afskriften i JSON-format Se Feltet Indhold
ConversationStartTime Det tidspunkt samtalen startede (ikke det tidspunkt, hvor afskriftsposten blev skrevet til datalageret) 2021-04-19T20:39:09Z
ConversationTranscript Det entydige id for rækken i Dataverse-tabellen 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON, der inkluderer agent-ID, lejer-ID, agentnavn og batch-ID {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Navnet på den brugerdefinerede række, der oprettes fra ConversationId , efterfulgt af BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
Bot_ConversationTranscript Agent-id'et aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Den dato og det klokkeslæt, da afskriftsposten blev oprettet 2021-04-20T02:40:13Z

Feltet Indhold

Feltet Content er en rå log over alle de aktiviteter, brugerne har med agenten. Almindelige aktivitetstyper omfatter meddelelse og hændelse:

  • Aktiviteter af typen Meddelelse repræsenterer indholdet i en samtale. Meddelelsesaktiviteter kan indeholde tekst, tale, interaktive kort og binære eller ukendte vedhæftede filer.
  • Hændelsesaktiviteter kommunikerer programmeringsoplysninger fra en klient eller kanal til agenten.

Du kan finde flere oplysninger om aktivitetstyper i Bot Framework-aktivitetsskema

I følgende tabel beskrives nogle af nøglefelterne i content JSON:

Tast Beskrivelse
ID Aktivitetsobjektets entydige GUID
valueType Den værditype, der gemmes i aktiviteten, bestemmer, hvilke oplysninger aktiviteten leverer (Almindelige typer af aktivitetsværdier)
timestamp Det tidsstempel for, hvornår aktiviteten blev genereret i Epoch-format (antallet sekunder siden midnat UTC 1. januar 1970)
type Aktivitetstypen: f.eks. message, event eller trace
replyToId Id'et for den aktivitet, som den aktuelle aktivitet svarer på
from Indeholder felterne id og role:
  • id - id for invokeren
  • role - indeholder 0 eller 1
    • 0 – aktiviteten kommer fra agenten
    • 1 – aktiviteten kommer fra den bruger, der kommunikerer med agenten
Bemærk:
id kan bruges til at beregne antallet af aktive brugere, der kommunikerer med agenten, hvis lærredet overføres med et entydigt id for brugeren. Hvis et id ikke overføres med lærredet, overføres et entydigt id pr. samtale.
Af hensyn til sikkerhed og privatliv hasher systemet ID'et, før det skriver ID'et til udskriften.
channelId ID for den kanal, hvor aktiviteten kommer fra - for eksempel directline, msteams, eller facebook
textFormat Tekstens format: f.eks. plain eller markdown
attachments Dynamiske "rich data", der er knyttet til aktiviteten: f.eks. AdaptiveCards, HeroCards eller Carousel data
text Teksten til message-aktiviteter
value Felter, der er specifikke for aktiviteten baseret på værditypen. Dette felt er det sted, hvor de fleste nyttige oplysninger findes
channeldata Indeholder kanaldata:
  • til meddelelser:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (indeholder den værdi, der er tildelt til en variabel)
    • CurrentMessageDetail
  • til hændelser:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Navnet på hændelsesaktiviteten: f.eks. SetPVAContext

Almindelige typer af aktivitetsværdier

Aktivitetsværditype Beskrivelse
ConversationInfo Om samtalen er fra Copilot Studio-appens testrude (isDesignMode) og landestandarden for samtalen
CSATSurveyRequest Brugeren får vist en kundetilfredshedsundersøgelse (CSAT)
CSATSurveyResponse Brugeren besvarer en CSAT-undersøgelse
DialogRedirect Brugeren omdirigeres til et andet emne
ImpliedSuccess Brugeren har nået en spørgsmålsnode i emnet, hvor en af betingelserne peger på CSAT-systememnet Bekræftet succes (kun klassiske robotter) eller kalder emnet Slut på samtalesystem
IntentRecognition Et emne blev udløst af brugeren
PRRSurveyRequest Brugeren blev spurgt, om han eller hun har fået svar på sit spørgsmål via emnet Slut på samtale
PRRSurveyResponse Brugerens svar på, om han eller hun har fået svar på sit spørgsmål via emnet Slut på samtale
SessionInfo Typen (unengaged eller engaged), resultatet (Escalated, Resolved, Abandon), Sessionens start- og sluttidspunkt (startTimeUtc, endTimeUtc) og turn count for sessionen
VariableAssignment Der er tildelt en værdi til en variabel

Forbedrede afskrifter

Du kan konfigurere agenter til at generere forbedrede transkripter, der inkluderer node-niveau data. Disse data hjælper med at spore strømmen af en samtale inden for et emne. I et emne om administration af ordrer kan brugerne f.eks. vælge mellem at sende en ny ordre eller hente en eksisterende. Data på nodeniveau gør det muligt at analysere brugeradfærd på tværs af disse indstillinger.

Aktivere udvidede afskrifter

  1. Åbn din agent.

  2. Gå til Indstillinger>Avanceret.

  3. Vælg Forstærk Transkripter, og slå derefter Inkluder node-niveau detaljer i transskriptioner til.

Skærmbillede, der viser siden med indstillinger for udvidede afskrifter.

Data på nodeniveau

Når du slår forbedrede transkripter til, indeholder transskriptionen en nodeTraceData aktivitetstype for hver node, som et emne påkalder. Følgende tabel beskriver nøglefelterne i nodeTraceData aktivitetsværdi.

Tast Beskrivelse
nodeID Node-identifikator
nodeType Node-typen som f.eks. SendActivity eller SearchAndSummarizeContent
startTime Det tidsstempel, da noden blev kaldt
endTime Det tidsstempel, da nodens udførsel blev afsluttet
topicDisplayName Det emne, der aktiverer noden

Tilpassede analyser

Nogle scenarier, f.eks. filtrering af samtaler baseret på en brugerdefineret variabel, kræver en brugerdefineret fremgangsmåde til analyse. For at bygge skræddersyede analyseløsninger kan kunder indtaste de rå transskriptioner i deres datapipelines eller bruge et add-on som Copilot Studio Kit.

Conversation KPIs-løsningen i Copilot Studio Kit parser automatisk transskriptioner og udfylder aggregerede data i Dataverse-tabeller.

Skift standardopbevaringsperioden

Et Power Apps-masse-slettende job fjerner automatisk agenttransskriptioner, der er ældre end 30 dage. Hvis du vil bevare afaskrifter længere tid, skal du annullere det eksisterende job og oprette et nyt, der kører efter en anden tidsplan.

Annullere det eksisterende masseslettejob

  1. I Power Apps skal du vælge Indstillinger>Avancerede indstillinger.

    Dynamics 365-portalen åbnes på en ny fane.

    Skærmbillede af menuen Indstillinger i Power Apps med Avancerede indstillinger fremhævet.

  2. Vælg caret ved siden af Indstillinger. Under System, vælg Datahåndtering.

    Skærmbillede af menuen Indstillinger med Dataadministration fremhævet.

  3. Vælg Massesletning af poster.

  4. Vælg Tilbagevendende massesletningsjob i listen Vis.

    Skærmbillede af listen over tilbagevendende massesletningsjob.

  5. Vælg jobbet Massesletning af poster for samtaleafskrifter, der er ældre end 1 måned.

    Skærmbillede af en liste over massesletningsjob med det første fremhævet.

  6. Vælg Annuler på listen Flere handlinger.

    Skærmbillede af listen Flere handlinger med Annuller fremhævet.

Opret et nyt job til massesletning

  1. Vælg Ny for at starte Bulk Deletion Wizard. I guiden vælger du Næste.

  2. Indstil følgende søgekriterier:

    • Vælg ConversationTranscripts på listen Søg efter.
    • Vælg ConversationStartTime, vælg Ældre end X måneder, og angiv "12".
      Denne indstillinger bevarer afskrifterne i 12 måneder. Vælg en anden sammenligning og værdi, hvis du vil.
    • Vælg SchemaType, hold dig lige, og indtast "powervirtualagents".

    Skærmbillede af indstillingerne for massesletningsjobsøgningskriterier.

  3. Vælg Næste.

  4. Angiv et navn for jobbet, vælg Kør dette job efter hver, og skriv 1. Vælg en anden tidsplan, hvis jobbet ikke skal køres hver dag.

    Skærmbillede af indstillingerne for massesletningsjobbets navn og kørselsindstillinger.

  5. Vælg Næste, og vælg derefter Send.

Hvorfor kan jeg ikke se mine samtaleafskrifter i Power Apps-tabellen ConversationTranscript?

Administratorer kan forhindre, at afskrifter gemmes i Dataverse. For mere information om, hvordan transskriptioner gemmes, og hvordan du håndterer adgang, se Control transcript access.

Vigtige oplysninger

Transskriptioner gemmes ikke for agenter, der er deployeret i udviklermiljøer.

Tip til, hvordan du får mest muligt ud af samtaleafskrifter

Brug variable til at gemme data, der er relevante for dit agentindhold eller agentbruger . Ved at parse variablen og dens værdi fra samtaletransskriptionen kan du filtrere eller skære dataene efter variablen.

Samtaleafskrifter kan kun referere til indhold ud fra id. F.eks. i en omdirigeringsnode refereres der kun til destinationsemnet via dets id. Du kan hente navnet på emnet ved at slå dets id op i agentindholdet.