Condividi tramite

Scaricare le trascrizioni delle conversazioni in Power Apps

  • Articolo

Puoi visualizzare, esportare e scaricare le trascrizioni delle interazioni dei clienti con il tuo agente sia in Power Apps che in Copilot Studio. Le informazioni esportate da ciascuna app sono leggermente diverse.

Questo articolo illustra il download delle trascrizioni delle conversazioni in Power Apps e il loro utilizzo per creare report Power BI. Per scaricare le trascrizioni direttamente in Copilot Studio, vedi Scaricare le trascrizioni delle conversazioni in Copilot Studio.

Per impostazione predefinita, Power Apps scarica le trascrizioni delle conversazioni degli ultimi 30 giorni. Puoi modificare il periodo di conservazione.

Nota

  • Se non hai più accesso al tuo ambiente, crea una richiesta di supporto nell'interfaccia di amministrazione di Power Platform.

  • Per gli agenti in ambienti di sviluppo personale, Copilot Studio non registra le trascrizioni delle conversazioni nella tabella ConversationTranscript.

Prerequisito

Visualizzare ed esportare le trascrizioni delle conversazioni dell'agente dal portale Power Apps

  1. Accedere a Power Apps.

  2. Nel riquadro di spostamento laterale seleziona Tabelle, quindi seleziona Tutto.

    Screenshot che mostra Tutti selezionati nel nodo Tabelle.

  3. Immetti "conversazione" nella casella Ricerca.

  4. Seleziona la tabella ConversationTranscript.

    Si apre una pagina per la tabella ConversationTranscript.

  5. Sulla barra dei menu superiore seleziona Esporta>Esporta dati.

    Ci vogliono alcuni minuti per compilare i dati per l'esportazione.

    Schermata che mostra il menu Esporta con l'opzione Esporta dati.

  6. Attendi un paio di minuti per Power Apps per preparare i dati per l'esportazione, quindi seleziona Scarica i dati esportati.

    Il file viene salvato come archivio ZIP nel percorso di download predefinito del browser.

Comprendere le trascrizioni delle conversazioni

La trascrizione della conversazione è un file CSV (valori separati da virgola). La tabella seguente descrive i campi più importanti nelle trascrizioni delle conversazioni.

Campo Descrzione Esempio
Content L'intera trascrizione in formato JSON Vedi Campo Contenuto
ConversationStartTime Ora di inizio della conversazione (non l'ora in cui il record di trascrizione è stato scritto nell'archivio dati) 2021-04-19T20:39:09Z
ConversationTranscript Identificatore univoco della riga di dati nella tabella Dataverse 28eccb77-xxxx-4a63-985f-ffaaadd6f391
Metadata JSON che include l'ID dell'agente, l'ID tenant e il nome dell'agente {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot"}
Name Il nome della riga personalizzata creata da ConversationId, seguito da BotId seguito da un batch number. Il numero di batch indica l'ordine quando sono presenti più sessioni analitiche per la conversazione. I bot classici non includono il numero di batch. 8YYe8iif49ZKkycZLe7HUO-o_198eca5f-xxxx-4ae6-8c08-835d884a8688_0
Bot_ConversationTranscript L'ID dell'agente aaaabbbb-0000-cccc-1111-dddd2222eeee
Created on Data e ora di creazione del record di trascrizione 2021-04-20T02:40:13Z

Campo Contenuto

Il campo Content è un registro di dati non elaborati di tutti gli impegni che gli utenti hanno con l'agente. I tipi di impegno comuni sono messaggio ed evento:

  • Le attività di messaggio rappresentano il contenuto mostrato in una conversazione. Le attività di messaggio possono contenere testo, voce, schede interattive e allegati binari o sconosciuti.
  • Gli impegni evento comunicano le informazioni programmatiche da un client o un canale all'agente.

Per ulteriori informazioni sui tipi di impegno, vedi Schema degli impegni Bot Framework.

La tabella seguente descrive alcuni dei campi chiave nel JSON di contenuto:

Key Descrizione
ID GUID univoco dell'oggetto impegno
valueType Il tipo di valore memorizzato nell'attività determina quali informazioni fornisce l'attività (Tipi di valore di attività comuni)
timestamp Timestamp di quando l'impegno è stato generato in formato Epoch (numero di secondi dalla mezzanotte UTC del 1 gennaio 1970)
type Il tipo di impegno; ad esempio, message, event o trace
replyToId L'ID dell'impegno a cui risponde l'impegno corrente
from Contiene i campi id e role:
  • id- ID dell'invoker
  • role - contiene 0 o 1
    • 0 - l'attività proviene dall'agente
    • 1 - l'attività proviene dall'utente che interagisce con l'agente
Note:
L'id può essere utilizzato per calcolare il numero di utenti attivi che stanno interagendo con l'agente se il canvas sta passando un ID univoco dell'utente. Se il canvas non trasmette un ID, viene passato un ID univoco per conversazione.
L'ID viene sottoposto ad hashing prima di essere scritto nella trascrizione per motivi di sicurezza e privacy.
channelId L'ID del canale da cui proviene l'attività; ad esempio, directline, msteams o facebook
textFormat Formato del testo; ad esempio, plain o markdown
attachments Dati formattati dinamici associati all'impegno; ad esempio, AdaptiveCards, HeroCards o Carousel data
text Il testo per gli impegni message
value Campi specifici dell'impegno in base al tipo di valore, questo campo è presente per la maggior parte delle informazioni utili
channeldata Contiene dati di canale:
  • per messaggi:
    • DialogTraceDetail
    • DialogErrorDetail
    • VariableDetail (contiene il valore assegnato a una variabile)
    • CurrentMessageDetail
  • per eventi:
    • cci_trace_id
    • traceHistory
    • enableDiagnostics
    • clientTimestamp
    • clientActivityId
name Nome dell'impegno evento; ad esempio, SetPVAContext

Tipi di valore di impegno comuni

Tipo di valore impegno Descrizione
ConversationInfo Specifica se la conversazione proviene dal riquadro di test di Copilot Studio (isDesignMode) e le impostazioni locali della conversazione
CSATSurveyRequest All'utente viene presentato un sondaggio sulla soddisfazione del cliente (CSAT)
CSATSurveyResponse L'utente risponde a un sondaggio CSAT
DialogRedirect L'utente viene reindirizzato a un altro argomento
ImpliedSuccess L'utente ha raggiunto un nodo domanda nell'argomento, dove una delle condizioni punta all'argomento di sistema CSAT Conferma esito positivo o chiama l'argomento di sistema Fine della conversazione
IntentRecognition L'utente ha attivato un argomento
PRRSurveyRequest All'utente è stato chiesto se l'argomento ha risposto alla sua domanda dall'argomento Fine della conversazione
PRRSurveyResponse La risposta dell'utente a se l'argomento ha risposto alla domanda dell'argomento Fine della conversazione
SessionInfo Il tipo (unengaged o engaged), risultato (Escalated, Resolved, Abandon) e il conteggio dei turni della sessione
VariableAssignment Un valore è assegnato a una variabile

Creare report Power BI personalizzati da trascrizioni di conversazioni

Un approccio utile alla creazione di report personalizzati da trascrizioni di conversazioni è guardare al numero di messaggi che devono essere elaborati.

Approccio semplice

Connetti Power BI a Dataverse con un flusso di dati Power BI. Non sono necessarie altre infrastrutture e verranno recuperati tutti i record da Dataverse con ogni aggiornamento.

Diagramma che mostra il flusso di dati da Dataverse al modello Power BI.

Pro Contro
Implementazione più semplice. Il tempo di aggiornamento può aumentare con l'aumentare delle trascrizioni.
Costo elevato per l'archiviazione in Dataverse.

Approccio di Azure Data Lake Storage standard

Esporta i dati Dataverse in Azure Data Lake Storage. Questo metodo richiede un account di Azure Data Lake Storage, ma nessun'altra infrastruttura di Azure.

Usa un flusso di dati Power Platform per la preparazione dei dati sulle trascrizioni ed estrai i dati in una forma strutturata.

Power BI aggiorna i dati dal flusso di dati. Power Platform e Power BI gestiscono tutta l'infrastruttura di calcolo. I record per un determinato giorno vengono recuperati da Dataverse con un aggiornamento.

Diagramma che mostra i dati che fluiscono da Dataverse a Azure Data Lake Storage, elaborati da Power Platform e Power BI.

Pro Contro
Basso costo di archiviazione in Azure Data Lake Storage.
Implementazione moderatamente semplice.
Nessun calcolo di Azure richiesto.		 Il tempo di aggiornamento può aumentare con l'aumentare quotidiano delle trascrizioni.

Azure Data Lake Storage + approccio Synapse

La dimensione dei dati nell'approccio Azure Data Lake Storage standard può causare aggiornamenti lenti o altri problemi operativi. In tal caso, puoi utilizzare Azure Synapse Analytics e integrarlo in Power BI.

Diagramma dei dati provenienti da Dataverse in Azure Data Lake, elaborati da Azure Synapse e Power Platform.

Pro Contro
Il tempo di aggiornamento è costante.
Implementazione moderatamente semplice.
Basso costo di archiviazione in Azure Data Lake Storage.		 Calcola il costo per Azure Synapse.

Modificare il periodo di conservazione predefinito

Un processo di eliminazione in blocco Power Apps rimuove le trascrizioni dell'agente che hanno più di 30 giorni. Per conservare le trascrizioni più a lungo, annulla il processo esistente e creane uno nuovo che venga eseguito in base a una pianificazione diversa.

Annullare il processo di eliminazione in blocco esistente

  1. In Power Apps, seleziona Impostazioni>Impostazioni avanzate.

    Screenshot del menu Impostazioni di Power Apps con Impostazioni avanzate evidenziato.

    Il portale Dynamics 365 si apre in una nuova scheda.

  2. Seleziona la freccia accanto a Impostazioni, quindi sotto Sistema, seleziona Gestione dati.

    Schermata del menu Impostazioni con Gestione dati evidenziato.

  3. Seleziona Eliminazione in blocco record.

  4. Nel menu Visualizza, seleziona Processi di sistema di eliminazione in blocco ricorrenti.

    Screenshot dell'elenco dei processi di eliminazione in blocco ricorrenti.

  5. Seleziona il processo Elimina in blocco record delle trascrizioni delle conversazioni create da più di 1 mese.

    Screenshot di un elenco di processi di eliminazione in blocco, con il primo evidenziato.

  6. Nell'elenco Altre azioni, seleziona Annulla.

    Screenshot dell'elenco Altre azioni, con Annulla evidenziato.

Creare un nuovo processo di eliminazione in blocco

  1. Per avviare la procedura guidata di eliminazione in blocco, seleziona Nuovo e quindi, nella procedura guidata, seleziona Avanti.

  2. Imposta i criteri di ricerca seguenti:

    • Nell'elenco Cerca, seleziona ConversationTranscripts.
    • Seleziona ConversationStartTime, quindi Oltre X mesi fa, quindi immetti "12".
      Questa impostazione conserva le trascrizioni per 12 mesi. Scegli un confronto e un valore diversi, se lo desideri.
    • Seleziona SchemaType, lascia uguale a e inserisci "powervirtualagents".

    Screenshot delle impostazioni dei criteri di ricerca del processo di eliminazione in blocco.

  3. Selezionare Avanti.

  4. Inserisci un nome per il processo, seleziona Esegui il processo dopo ogni e immetti 1. Scegli una pianificazione diversa se non desideri che il processo venga eseguito ogni giorno.

    Screenshot delle impostazioni di assegnazione del nome ed esecuzione del processo di eliminazione in blocco.

  5. Selezionare Avanti, quindi Invia.

Suggerimenti per ottenere il massimo dalle trascrizioni delle conversazioni

Le variabili possono essere utilizzate per memorizzare dati rilevanti per il contenuto del tuo agente o utente dell'agente. L'analisi della variabile e del suo valore dalla trascrizione della conversazione consente di filtrare o suddividere i dati in base alla variabile.

Le trascrizioni delle conversazioni si riferiscono al contenuto solo con l'ID. Ad esempio, in un nodo Reindirizza, l'argomento di destinazione è indicato solo dal suo ID. Per ottenere il nome di questo argomento, cerca il suo ID nel contenuto dell'agente.