Freigeben über

Gesprächsprotokolle in Power Apps herunterladen

  • Artikel

Sie können Transkripte von Kundeninteraktionen mit Ihrem Agenten sowohl in Power Apps als auch in Copilot Studio anzeigen, exportieren und herunterladen. Die Informationen, die jede App exportiert, unterscheiden sich geringfügig.

Dieser Artikel behandelt das Herunterladen von Unterhaltungsprotokollen in Power Apps und deren Verwendung zum Erstellen von Berichten in Power BI. Zum direkten Herunterladen von Transkripten in Copilot Studio siehe Herunterladen von Gesprächstranskripten in Copilot Studio.

Power Apps lädt standardmäßig Unterhaltungstranskripte der letzten 30 Tage herunter. Sie können den Aufbewahrungszeitraum ändern.

Anmerkung

  • Wenn Sie keinen Zugriff mehr auf Ihre Umgebung haben, müssen Sie im Power Platform Admin Center eine Supportanfrage erstellen.

  • Für Agenten in persönlichen Entwicklerumgebungen werden Copilot Studio Transkripte nicht in der ConversationTranscript-Tabelle nicht protokolliert.

Voraussetzung

Unterhaltungstranskripte aus dem Power Apps-Portal exportieren und anzeigen

  1. Melden Sie sich bei Power Apps an.

  2. Erweitern Sie den Seitennavigationsbereich, wählen Sie Tabellen und dann Alle aus.

    Screenshot mit der Auswahl „Alle“ auf dem Knoten „Tabellen“.

  3. Geben Sie „Unterhaltung“ in das Feld Suche ein.

  4. Wählen sie die Tabelle ConversationTranscript.

    Eine Seite für die Tabelle ConversationTranscript wird geöffnet.

  5. Auf der oberen Menüleiste wählen Sie Daten>Exportieren aus.

    Es dauert einige Minuten, bis die Daten für den Export zusammengestellt sind.

    Screenshot des Menüs Exportieren mit der Option Daten exportieren.

  6. Lassen Sie dem System ein paar Minuten Zeit, damit Power Apps die Daten für den Export vorbereiten kann. Wählen Sie dann Exportierte Daten herunterladen aus.

    Die Datei wird als ZIP-Archiv am Standard-Download-Speicherort Ihres Browsers gespeichert.

Unterhaltungstranskripte verstehen

Das Konversationsprotokoll ist eine CSV-Datei (comma-separated values). In der folgenden Tabelle sind die wichtigsten Felder aufgeführt, die Sie in Ihren Gesprächsprotokollen finden.

Feld Eigenschaft Beispiel
Content Das gesamte Transkript im JSON-Format Siehe Feld Inhalt
ConversationStartTime Die tatsächliche Startzeit der Unterhaltung (nicht die Uhrzeit, zu der der Transkriptdatensatz in den Datenspeicher geschrieben wurde) 2021-04-19T20:39:09Z
ConversationTranscript Der eindeutige Bezeichner der Zeile in der Dataverse-Tabelle 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON, das die Agent-ID, die Mandanten-ID und den Agentennamen enthält {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name Der Name der benutzerdefinierten Zeile, die aus der ConversationId erstellt wurde, gefolgt von der BotId und wiederum gefolgt von der batch number. Die Batch-Nummer gibt die Reihenfolge an, wenn es mehrere Analysesitzungen für die Unterhaltung gibt. Klassische Bots enthalten keine Chargennummer. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript Die Agenten-ID aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Das Datum und die Uhrzeit der Erstellung des Transkriptdatensatzes 2021-04-20T02:40:13Z

Feld „Inhalt“

Das Feld Content ist ein Rohprotokoll aller Aktivitäten, die Benutzer mit dem Agent ausführen. Übliche Aktivitätstypen sind Nachricht und Ereignis:

  • Nachrichtenaktivitäten stellen die Inhalte dar, die in einer Unterhaltung angezeigt werden. Nachrichtenaktivitäten können Text, Sprache, interaktive Karten und binäre oder unbekannte Anhänge enthalten.
  • Ereignis-Aktivitäten kommunizieren programmgesteuerte Informationen von einem Client oder Kanal an einen Agent.

Weitere Informationen zu Aktivitätstypen finden Sie im Bot Framework-Aktivitätsschema.

In der folgenden Tabelle werden einige der wichtigsten Felder in der Inhalts-JSON beschrieben:

Taste Eigenschaft
ID Die eindeutige GUID des Aktivitätsobjekts
valueType Der in der Aktivität gespeicherte Werttyp bestimmt, welche Informationen die Aktivität bereitstellt (Häufige Aktivitätswerttypen)
timestamp Der Zeitstempel, wann die Aktivität im Epochenformat generiert wurde (Anzahl der Sekunden seit Mitternacht UTC am 1. Januar 1970)
type Der Typ der Aktivität, z. B. message, event oder trace
replyToId Die ID der Aktivität, auf die die aktuelle Aktivität reagiert
from Enthält die Felder id und role:
  • id – die ID des Aufrufers
  • role – enthält 0 oder 1
    • 0 – die Aktivität kommt vom Agenten
    • 1 – die Aktivität kommt von dem Benutzer, der mit dem Agent interagiert
Hinweis:
Der id kann verwendet werden, um die Anzahl der aktiven Benutzer zu berechnen, die mit dem Agent interagieren, wenn die Canvas eine eindeutige ID des Benutzers übergibt. Wenn die Canvas keine ID übergibt, wird eine eindeutige ID pro Unterhaltung übergeben.
Aus Gründen der Sicherheit und des Datenschutzes wird die ID gehasht, bevor sie in die Abschrift geschrieben wird.
channelId Die ID des Kanals, woher die Aktivität kommt (z. B. directline, msteams oder facebook).
textFormat Das Format des Textes z. B. plain oder markdown
attachments Dynamische, umfangreiche Daten, die der Aktivität zugeordnet sind, z. B. AdaptiveCards, HeroCards oder Carousel data
text Der Text für message-Aktivitäten
value Aktivitätsspezifische Felder basierend auf dem Werttyp. In diesem Feld sind die meisten nützlichen Informationen enthalten.
channeldata Enthält Kanaldaten:
  • für Nachrichten:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (enthält den einer Variablen zugewiesenen Wert)
    • CurrentMessageDetail
  • für Ereignisse:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Der Name der Ereignisaktivität, z. B. SetPVAContext

Häufige Aktivitätswerttypen

Aktivitätswerttyp Beschreibung
ConversationInfo Ob die Unterhaltung vom Testbereich der Copilot Studio-App (isDesignMode) stammt und welches das Gebietsschema der Unterhaltung ist
CSATSurveyRequest Dem Benutzer wird eine Umfrage zur Kundenzufriedenheit (CSAT) vorgelegt.
CSATSurveyResponse Der Benutzer beantwortet eine CSAT-Umfrage.
DialogRedirect Der Benutzer wird zu einem anderen Thema umgeleitet.
ImpliedSuccess Der Benutzer hat einen Frageknoten im Thema erreicht, in dem eine der Bedingungen auf das CSAT-Systemthema Bestätigter Erfolg verweist oder das Systemthema Ende der Unterhaltung aufruft.
IntentRecognition Ein Thema wurde vom Benutzer ausgelöst
PRRSurveyRequest Der Benutzer wurde gefragt, ob das Thema seine Frage aus dem Thema Ende der Unterhaltung beantwortet hat.
PRRSurveyResponse Die Antwort des Benutzers auf die Frage, ob das Thema seine Frage aus dem Thema Ende der Unterhaltung beantwortet hat.
SessionInfo Der Typ (unengaged oder engaged), das Ergebnis (Escalated, Resolved, Abandon) und die Anzahl der Sprecherwechsel der Sitzung.
VariableAssignment Einer Variablen ist ein Wert zugewiesen

Benutzerdefinierte Power BI-Berichte aus Unterhaltungstranskripten erstellen

Eine nützliche Methode zur Erstellung von benutzerdefinierten Berichten aus Gesprächsprotokollen ist die Betrachtung der Anzahl der zu verarbeitenden Nachrichten.

Einfacher Ansatz

Verbinden Sie Power BI mit Dataverse über einen Power BI-Dataflow. Eine andere Infrastruktur ist nicht erforderlich, und bei jeder Aktualisierung werden alle Datensätze aus Dataverse abgerufen.

Diagramm, das den Flow der Daten von Dataverse zum Power BI-Modell zeigt.

Vorteile Nachteile
Einfachste Implementierung. Die Aktualisierungszeit kann sich mit zunehmender Zahl der Transkripte erhöhen.
Hohe Kosten für die Speicherung in Dataverse.

Standard-Azure Data Lake Storage-Ansatz

Exportieren Sie die Daten von Dataverse zu Azure Data Lake Storage. Diese Methode erfordert ein Azure Data Lake Storage-Konto, jedoch keine andere Azure-Infrastruktur.

Verwenden Sie einen Power Platform-Dataflow zur Datenaufbereitung auf den Transkripten und extrahieren Sie die Daten in eine strukturierte Form.

Power BI aktualisiert Daten aus dem Dataflow. Power Platform und Power BI verwalten die gesamte Recheninfrastruktur. Bei jeder Aktualisierung werden Datensätze für einen bestimmten Tag aus Dataverse abgerufen.

Diagramm, das den Datenfluss von Dataverse zu Azure Data Lake Storage zeigt, verarbeitet von Power Platform und Power BI.

Vorteile Nachteile
Niedrige Speicherkosten in Azure Data Lake Storage.
Relativ einfache Implementierung.
Kein Azure Compute erforderlich.		 Die Aktualisierungszeit kann sich mit zunehmender Zahl der Transkripte am Tag erhöhen.

Azure Data Lake Storage + Synapse-Ansatz

Die Datengröße im Standard Azure Data Lake Storage Ansatz kann zu langsamen Aktualisierungen oder anderen Betriebsproblemen führen. In diesem Fall können Sie Azure Synapse Analytics verwenden und in Power BI integrieren.

Diagramm mit den Daten, die von Dataverse an Azure Data Lake fließen, verarbeitet von Azure Synapse und Power Platform.

Vorteile Nachteile
Die Aktualisierungszeit ist konstant.
Relativ einfache Implementierung.
Niedrige Speicherkosten in Azure Data Lake Storage.		 Kosten für Azure Synapse.

Ändern Sie die standardmäßige Aufbewahrungsfrist

Ein Power Apps Massenlöschungsauftrag löscht automatisch Agent-Transkripts, die älter als 30 Tage sind. Um die Transkripte länger aufzubewahren, brechen Sie den vorhandenen Auftrag ab und erstellen Sie einen neuen, der nach einem anderen Zeitplan ausgeführt wird.

Brechen Sie den vorhandenen Massenlöschauftrag ab

  1. Wählen Sie in Power Apps die Option Einstellungen > Erweiterte Einstellungen aus.

    Screenshot des Menüs Power Apps Einstellungen mit hervorgehobenen erweiterten Einstellungen.

    Das Dynamics 365-Portal wird in einer neuen Registerkarte geöffnet.

  2. Wählen Sie das Einfügezeichen neben Einstellungen und dann unter System die Option Datenverwaltung aus.

    Screenshot des Menüs Einstellungen, wobei die Datenverwaltung hervorgehoben ist.

  3. Wählen Sie Massenlöschung von Datensätzen aus.

  4. Wählen Sie in der Liste Ansicht die Option Wiederkehrende Systemaufträge zur Massenlöschung.

    Screenshot der Liste wiederkehrender Massenlöschaufträge.

  5. Wählen Sie den Auftrag Massenlöschen von Konversationsprotokollen älter als 1 Monat.

    Screenshot der Liste von Massenlöschaufträgen, wobei der erste hervorgehoben ist

  6. Wählen Sie in der Liste Weitere Aktionen die Option Abbrechen.

    Screenshot der Liste „Weitere Aktionen“ mit hervorgehobener Option „Abbrechen“.

Neuen Massenlöschungsauftrag erstellen

  1. Um den Massenlöschungs-Assistenten zu starten, wählen Sie Neu und dann im Assistenten Weiter aus.

  2. Legen Sie die folgenden Suchkriterien fest:

    • In der Liste Suchen wählen Sie ConversationTranscripts.
    • Wählen Sie ConversationStartTime und Älter als X Monate aus und geben Sie dann „12“ ein.
      Bei dieser Einstellung bleiben die Abschriften 12 Monate lang erhalten. Wählen Sie einen anderen Vergleich und Wert, wenn Sie möchten.
    • Wählen Sie SchemaType aus, lassen Sie gleich unverändert und geben Sie „powervirtualagents“ ein.

    Screenshot der Suchkriterieneinstellungen für die Massenlöschung von Jobs.

  3. Wählen Sie Weiter.

  4. Geben Sie einen Namen für den Job ein, wählen Sie Diesen Job nach jedem ausführen, und geben Sie 1 ein. Wählen Sie einen anderen Zeitplan aus, wenn der Job nicht jeden Tag ausgeführt werden soll.

    Screenshot der Einstellungen für den Namen und die Ausführung des Massenlöschauftrags

  5. Wählen Sie Weiter und dann Senden aus.

Tipps zur optimalen Nutzung Ihrer Unterhaltungstranskripte

Mithilfe von Variablen können Daten gespeichert werden, die für Ihren Agent-Inhal relevant sind oder den Agent-Benutzer. Durch Analysieren der Variablen und ihres Werts aus dem Unterhaltungstranskript können Sie die Daten nach den Variablen filtern oder aufteilen

Unterhaltungsprotokolle beziehen sich möglicherweise nur über eine ID auf den Inhalt. In einem Weiterleitungsknoten wird das Zielthema nur anhand seiner ID referenziert. Um den Namen dieses Themas zu erhalten, suchen Sie die ID im Inhalt des Agenten.