Gesprekstranscripties vanuit Power Apps begrijpen
U kunt transcripties van klantinteracties met uw copilot bekijken, exporteren en downloaden in zowel Power Apps en Copilot Studio. De informatie die elke app exporteert, is iets anders. Dit artikel behandelt het downloaden van gesprekstranscripties in Power Apps en het gebruik ervan om rapporten te maken in Power BI. Zie voor meer informatie het onderwerp Sessiegegevens analyseren in Copilot Studio.
Standaard worden in Power Apps transcripties van gesprekken van de afgelopen 30 dagen gedownload. U kunt de retentieperiode wijzigen.
Opmerking
Als u geen toegang meer hebt tot uw omgeving, moet u een ondersteuningsaanvraag maken in het Power Platform-beheercentrum.
Vereisten
- Om gesprekstranscripties te bekijken, hebt u de beveiligingsrol Bekijker van transcripties nodig. Alleen beheerders kunnen deze rol toekennen door De beveiligingsrol Bekijker van Copilot-transcripties toewijzen tijdens het delen van een copilot.
Transcripties van copilot-gesprekken weergeven en exporteren vanuit de Power Apps-portal
U kunt copilot-gesprekstranscripties bekijken en exporteren vanuit de Power Apps-portal.
U moet u eerst aanmelden bij https://www.powerapps.com met uw referenties.
Gesprekstranscripties weergeven
Selecteer in het zijvenster het knooppunt Tabellen en selecteer vervolgens Alle.
Typ gesprek in het vak Zoeken.
Selecteer ConversationTranscript onder Tabellen.
Er wordt een pagina voor de tabel ConversationTranscript geopend.
Gesprekstranscripties exporteren
Selecteer in het zijvenster het knooppunt Tabellen en selecteer vervolgens Alle.
Typ gesprek in het vak Zoeken.
Selecteer ConversationTranscript onder Tabellen.
Selecteer Exporteren>Gegevens exporteren.
Het duurt enkele minuten voordat de gegevens zijn gecompileerd voor exporteren.
Kies Geëxporteerde gegevens downloaden om de inhoud te downloaden.
Transcripties van copilot-gesprekken downloaden
Selecteer in het Power Apps-navigatiemenu de optie Dataverse>Tabellen en vervolgens Alle.
Typ gesprek in het vak Zoeken.
Selecteer de tabel ConversationTranscript.
Selecteer Exporteren>Gegevens exporteren.
Wacht een paar minuten zodat Power Apps de gegevens kan voorbereiden voor export en selecteer vervolgens Geëxporteerde gegevens downloaden.
Het bestand wordt opgeslagen als een gezipt archief op de standaard downloadlocatie van uw browser.
Gesprekstranscripties begrijpen
De gesprekstranscriptie is een CSV-bestand (met door komma's gescheiden waarden). In de volgende tabel worden de belangrijkste velden in uw gesprekstranscripties beschreven.
| Veld | Omschrijving | Voorbeeld |
|---|---|---|
Content |
Het volledige transcript in JSON-indeling | Raadpleeg de sectie Het veld Inhoud. |
ConversationStartTime |
Het tijdstip waarop het het gesprek is gestart (niet het tijdstip waarop de transcriptierecord naar de gegevensopslag is geschreven) | 2021-04-19T20:39:09Z |
ConversationTranscript |
De unieke id van de rij in de Dataverse-tabel | 28eccb77-xxxx-4a63-985f-ffaaadd6f391 |
Metadata |
JSON die de copilot-id, de tenant-id en de naam van de copilot bevat | {"BotId": "198eca5f-xxxx-4ae6-8c08-835d884a8688", "AADTenantId": "72f988bf-xxxx-41af-91ab-2d7cd011db47", "BotName": "Test Bot"} |
Name |
De naam van de aangepaste rij die wordt gemaakt op basis van ConversationId, gevolgd door BotId, gevolgd door een batch number. Het batchnummer geeft de volgorde aan als er meerdere analysesessies voor het gesprek zijn. Klassieke bots vermelden het batchnummer niet. |
8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0 |
Bot_ConversationTranscript |
De copilot-id | 198eca5f-xxxx-4ae6-8c08-835d884a8688 |
Created on |
De datum en het tijdstip waarop de transcriptierecord is gemaakt | 2021-04-20T02:40:13Z |
Het veld Inhoud
Het veld Content is een onbewerkt logboek voor alle activiteiten van gebruikers met de Copilot. Veelvoorkomende soorten activiteiten zijn onder meer bericht en evenement:
- Activiteiten van het type bericht staan voor de inhoud in een gesprek. Activiteiten van het type bericht kunnen tekst, spraak, interactieve kaarten en binaire of onbekende bijlagen bevatten.
- Activiteiten van het type gebeurtenis communiceren programmatische informatie van een klant of kanaal naar de copilot.
Zie Bot Framework-activiteitenschema voor meer informatie over activiteitstypen.
In de volgende tabel worden enkele belangrijke velden in de inhoud-JSON beschreven:
| Key | Omschrijving |
|---|---|
ID |
De unieke GUID van het activiteitsobject |
valueType |
Het type waarde dat in de activiteit is opgeslagen, bepaalt welke informatie de activiteit biedt (Veelvoorkomende typen activiteitswaarden) |
timestamp |
De tijdstempel van wanneer de activiteit is gegenereerd in Epoch-notatie (het aantal seconden sinds middernacht op 1 januari 1970, UTC) |
type |
Het type activiteit, bijvoorbeeld message, event of trace |
replyToId |
De id van de activiteit waarop de huidige activiteit reageert |
from |
Bevat de velden id en role:
de id kan worden gebruikt om het aantal actieve gebruikers te berekenen die interactie hebben met de copilot als het canvas een unieke id van de gebruiker doorgeeft. Als het canvas geen id doorgeeft, wordt een unieke id per gesprek doorgegeven. UIt veiligheids- en privacyoverwegingen wordt de id gehasht voordat deze naar de transcriptie wordt geschreven. |
channelId |
De ID van het kanaal waar de activiteit vandaan komt; bijvoorbeeld directline, msteams of facebook |
textFormat |
De indeling van de tekst, bijvoorbeeld plain of markdown |
attachments |
Dynamische uitgebreide gegevens die aan de activiteit zijn gekoppeld, bijvoorbeeld AdaptiveCards, HeroCards of Carousel data |
text |
De tekst voor message-activiteiten |
value |
Velden die specifiek zijn voor de activiteit op basis van het waardetype. Dit veld bevat de meeste nuttige informatie |
channeldata |
|
name |
De naam van de gebeurtenisactiviteit, bijvoorbeeld SetPVAContext |
Veelvoorkomende typen activiteitswaarden
| Type activiteitswaarde | Omschrijving |
|---|---|
ConversationInfo |
Of het gesprek afkomstig is uit het Copilot Studio-testvenster (isDesignMode) en de landinstellingen van het gesprek |
CSATSurveyRequest |
De gebruiker krijgt een klanttevredenheidsonderzoek (CSAT) te zien |
CSATSurveyResponse |
De gebruiker reageert op een klanttevredenheidsonderzoek |
DialogRedirect |
De gebruiker wordt omgeleid naar een ander onderwerp |
ImpliedSuccess |
De gebruiker heeft een vraagknooppunt bereikt in het onderwerp, waar een van de voorwaarden verwijst naar het CSAT-systeemonderwerp Bevestigd succes of het systeemonderwerp Einde van gesprek wordt aangeroepen |
IntentRecognition |
De gebruiker heeft een onderwerp geactiveerd |
PRRSurveyRequest |
De gebruiker is gevraagd of het onderwerp de vraag heeft beantwoord vanuit het onderwerp Einde van gesprek |
PRRSurveyResponse |
De gebruiker heeft gereageerd op de vraag of het onderwerp de vraag heeft beantwoord vanuit het onderwerp Einde van gesprek |
SessionInfo |
Het type (unengaged of engaged), resultaat (Escalated, Resolved, Abandon) en het aantal uitvoeringen van de sessie |
VariableAssignment |
Er is een waarde aan een variabele toegewezen |
Aangepaste Power BI-rapporten maken op basis van gesprekstranscripties
Een nuttige manier van aanpak bij het bouwen van aangepaste rapporten op basis van gesprekstranscripties is het bekijken van het aantal berichten dat moet worden verwerkt.
Lichte benadering
Verbind Power BI met Dataverse via een Power BI-gegevensstroom. Andere infrastructuur is niet vereist en bij elke vernieuwing worden alle records opgehaald vanuit Dataverse.
| Voordelen | Nadelen |
|---|---|
| Eenvoudigste implementatie. | De vernieuwingstijd kan toenemen naarmate het aantal transcripties toeneemt. Hoge kosten voor opslag in Dataverse. |
Standaard Azure Data Lake Storage-aanpak
Exporteer Dataverse-gegevens naar Azure Data Lake Storage. Voor deze methode is een Azure Data Lake Storage-account vereist, maar geen andere Azure-infrastructuur.
Gebruik een Power Platform-gegevensstroom in de transcripties om de gegevens voor te bereiden en extraheer de gegevens in een gestructureerde vorm.
Power BI vernieuwt gegevens uit de gegevensstroom. Power Platform en Power BI beheren alle computerinfrastructuur. Bij elke vernieuwing worden records voor een bepaalde dag opgehaald vanuit Dataverse.
| Voordelen | Nadelen |
|---|---|
| Lage opslagkosten in Azure Data Lake Storage. Redelijk eenvoudige implementatie. Geen Azure Compute vereist. |
De vernieuwingstijd kan toenemen naarmate transcripties elke dag toenemen. |
Azure Data Lake Storage + Synapse-benadering
De gegevensgrootte in de Standard Azure Data Lake Storage-benadering kan langzame vernieuewingen of andere operationele problemen veroorzaken. In dat geval kunt u Azure Synapse Analytics gebruiken en dit integreren in Power BI.
| Voordelen | Nadelen |
|---|---|
| Vernieuwinsgtijd is consistent. Redelijk eenvoudige implementatie. Lage opslagkosten in Azure Data Lake Storage. |
Rekenkosten voor Azure Synapse. |
De standaardretentieperiode wijzigen
Met een bulkverwijderingstaak van Power Apps worden copilot-transcripties ouder dan 30 dagen automatisch verwijderd. Als u de transcripties langer wilt bewaren, annuleert u de bestaande taak en maakt u een nieuwe die volgens een ander schema wordt uitgevoerd.
De bestaande bulkverwijderingstaak annuleren
Selecteer in Power Apps Instellingen>Geavanceerde instellingen.
De Dynamics 365-portal wordt geopend in een nieuw tabblad.
Selecteer het caret-teken naast Instellingen en selecteer bij Systeem de optie Gegevensbeheer.
Selecteer Bulkverwijdering records.
Selecteer in de lijst Weergave de optie Terugkerende bulkverwijderingssysteemtaken.
Selecteer de taak Conversietranscriptrecords van ouder dan 1 maand in bulk verwijderen.
Selecteer in de lijst Meer acties de optie Annuleren.
Een nieuwe bulkverwijderingstaak maken
Om de wizard voor bulkverwijdering te starten, selecteert u Nieuw en vervolgens selecteert u in de wizard Volgende.
Stel de volgende zoekcriteria in:
- Selecteer in de lijst Zoeken naar ConversationTranscripts.
- Selecteer ConversationStartTime, selecteer Ouder dan X maanden en voer 12 in.
Door deze instelling blijven de transcripties 12 maanden bewaard. Kies desgewenst een andere vergelijking en waarde. - Selecteer SchemaType, laat gelijk aan ongewijzigd en voer 'powervirtualagents' in.
Selecteer Volgende.
Voer een naam in voor de taak, selecteer Deze taak uitvoeren elke en voer 1 in. Kies een ander schema als u niet wilt dat de taak elke dag wordt uitgevoerd.
Selecteer Volgende en daarna Indienen.
Tips om het meeste uit uw gesprekstranscripties te halen
Variabelen kunnen worden gebruikt om gegevens op te slaan die relevant zijn voor uw Copilot-inhoud of Copilot-gebruiker. Door de variabele en de waarde uit de gesprekstranscriptie te ontleden, kunt u de gegevens filteren of opdelen op basis van de variabele.
Op veel plekken verwijzen de gesprekstranscripties naar inhoud door middel van de id. Naar de id van het onderwerp waarnaar wordt omgeleid door het huidige onderwerp, wordt bijvoorbeeld alleen verwezen door de id. Om de naam van het onderwerp te achterhalen, zoekt u de naam op in de copilot-inhoud.