Teilen über

Verstehen heruntergeladener Unterhaltungstranskripte aus Power Apps

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.

Wichtig

Ersteller mit der Rolle Umgebungsersteller haben nicht automatisch Zugriff auf Transkripte.

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

Agentenantworten, die SharePoint als Wissensquelle nutzen, sind nicht in Unterhaltungstranskripten enthalten.

Gesprächsprotokolle sind nicht geschrieben für:

  • Microsoft Dataverse for Teams-Umgebungen
  • Dataverse-Entwicklungsumgebungen
  • Microsoft 365 Copilot-Agenten

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 des Tables-Knotens mit allen ausgewählt.

  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 ein paar Minuten, die Daten für den Export zu kompilieren.

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

  6. Warte ein paar Minuten, bis Power Apps die Daten für den Export vorbereitet, und wähle dann exportierte Daten herunterladen.

    Die Datei wird als ZIP-Archiv am Standarddownloadspeicherort Ihres Browsers gespeichert.

Unterhaltungstranskripte verstehen

Das Gesprächstranskript existiert als Dataverse-Tabelle, die du als CSV-Datei (kommagetrennte Werte) herunterladen kannst. Die Logik, die bestimmt, wann und wie das System Informationen in Gesprächstranskripte aufzeichnet, lautet:

  • Das System speichert ein Gespräch nach 30 Minuten Inaktivität in einem Transkript-Datensatz. Wenn die Diskussion nach der Inaktivitätszeit fortgesetzt wird, speichert das System die neuen Aktivitäten in einem neuen Datensatz mit demselben Name Wert, aber mit einem neuen ConversationStartTime Wert.
  • Für Agenten, die auf dem Telephony-Kanal veröffentlicht werden, werden die Gespräche drei Minuten nach einem End Conversation-Event abgebrochen.
  • Jeder Datensatz hat ein Limit von 1 MB für das Transkript (Content Spalte). Wenn ein Transkript größer als diese Grenze ist, teilt das System das Transkript in mehrere Datensätze auf, die alle dieselben Name Werte haben ConversationStartTime , aber unterschiedliche Metadata.BatchId Werte.
  • Um Transkripte zusammenzuführen , nehmen Sie alle Datensätze mit denselben Name und-Werten ConversationStartTime und sortieren Sie diese Datensätze nach BatchId.

In der folgenden Tabelle sind die wichtigsten Felder aufgeführt, die Sie in Ihren Gesprächsprotokollen finden.

Feld Beschreibung 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 Agenten-ID, die Mieter-ID, den Agentennamen und die Batch-ID enthält, enthält {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Der Name der benutzerdefinierten Zeile ConversationId , gefolgt von BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
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 Beschreibung
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 Sicherheitsgründen und Datenschutzgründen hasht das System die ID, bevor es sie ins Transcript schreibt.
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 Thema "Bestätigter Erfolg CSAT-System" verweist (nur klassische Bots) oder das Thema "Ende des Unterhaltungssystems " 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), Ergebnis (Escalated, Resolved, Abandon), Sitzungsstart- und Endzeit (startTimeUtc, endTimeUtc) und die Anzahl der Runden der Sitzung
VariableAssignment Einer Variablen ist ein Wert zugewiesen

Verbesserte Transkripte

Man kann Agenten so konfigurieren, dass sie erweiterte Transkripte erzeugen, die Node-Level-Daten enthalten. Anhand dieser Daten können Sie den Verlauf einer Konversation innerhalb eines Themas verfolgen. In einem Thema zum Verwalten von Bestellungen können Benutzer beispielsweise wählen, ob sie eine neue Bestellung übermitteln oder eine vorhandene Bestellung abrufen möchten. Daten auf Knotenebene ermöglichen die Analyse des Benutzerverhaltens über diese Optionen hinweg.

Erweiterte Transkripte aktivieren

  1. Öffnen Sie Ihren Agent.

  2. Zu Einstellungen>Erweitert wechseln.

  3. Wählen Sie Transkripte verbessern und aktivieren Sie dann Node-Level-Details in Transkripte einfügen.

Screenshot mit der Einstellungsseite für erweiterte Transkripte.

Daten auf Knotenebene

Wenn Sie erweiterte Transkripte aktivieren, enthält das Transkript für jeden Knoten, den ein Thema aufruft, einen nodeTraceData Aktivitätstyp. Die folgende Tabelle beschreibt die zentralen Felder im nodeTraceData Aktivitätswert.

Taste Beschreibung
nodeID Der Knotenbezeichner
nodeType Der Knotentyp, beispielsweise SendActivity oder SearchAndSummarizeContent
startTime Der Zeitstempel, an dem der Knoten aufgerufen wurde
endTime Der Zeitstempel, an dem der Knoten die Ausführung beendet
topicDisplayName Das Thema, in dem der Knoten aufgerufen wird

Angepasste Analysen

Einige Szenarien, z. B. das Filtern von Unterhaltungen auf der Grundlage einer benutzerdefinierten Variablen, erfordern einen benutzerdefinierten Analyseansatz. Um maßgeschneiderte Analyselösungen zu entwickeln, können Kunden die rohen Transkripte in ihre Datenpipelines einfügen oder ein Add-on wie das Copilot Studio Kit verwenden.

Die Conversation KPIs-Lösung im Copilot Studio Kit analysiert automatisch Transkripte und füllt aggregierte Daten in Dataverse-Tabellen.

Ändern Sie die standardmäßige Aufbewahrungsfrist

Ein Power Apps Massenlöschauftrag entfernt automatisch Agententranskripte, 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.

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

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

  2. Wählen Sie das Caret neben Einstellungen aus. Wählen Sie unter SystemDatenmanagement 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. Wählen Sie Neu, um den Bulk-Lösch-Wizard zu starten. Im Wizard wähle Nächste.

  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 einen anderen Preis, wenn Sie möchten.
    • Wählen Sie SchemaType, halten Sie Gleichheiten 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.

Warum kann ich meine Gesprächstranskripte nicht in der Power Apps ConversationTranscript-Tabelle anzeigen?

Administratoren können das Speichern von Transkripten in Dataverse verhindern. Weitere Informationen darüber, wie Transkripte gespeichert werden und wie man den Zugriff verwaltet, finden Sie unter Zugriff auf Transkripte kontrollieren.

Wichtig

Transkripte werden für Agenten, die in Entwicklerumgebungen eingesetzt werden, nicht gespeichert.

Tipps zur optimalen Nutzung Ihrer Unterhaltungstranskripte

Verwenden Sie Variablen, um Daten zu speichern, die für Ihren Agenteninhalt oder Ihren Agentennutzer relevant sind . Indem Sie die Variable und ihren Wert aus dem Gesprächstranskript analysieren, können Sie die Daten nach der Variablen filtern oder segmentieren.

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.

  • Last updated on