Condividi tramite

Comprendere le trascrizioni delle conversazioni scaricate da Power Apps

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

Importante

I creatori con il ruolo di Autore dell'ambiente non hanno automaticamente accesso alle trascrizioni.

Questo articolo illustra il download delle trascrizioni delle conversazioni in Power Apps e l'uso di tali trascrizioni per creare report in Power BI. Per scaricare le trascrizioni direttamente in Copilot Studio, vedere Scaricare le trascrizioni delle conversazioni in Copilot Studio.

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

Nota

Le risposte dell'agente che usano SharePoint come origine delle conoscenze e usano documenti che includono dati sensibili non sono inclusi nella trascrizione della conversazione.

Le trascrizioni delle conversazioni non sono scritte per:

  • Microsoft Dataverse per gli ambienti Teams
  • Ambienti per sviluppatori Dataverse
  • agenti Microsoft 365 Copilot

Prerequisito

Visualizzare ed esportare le trascrizioni delle conversazioni dal portale di Power Apps

  1. Accedere a Power Apps.

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

    Screenshot del nodo Tabelle con Tutti selezionati.

  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 da esportare.

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

  6. Attendere un paio di minuti prima che Power Apps preparare i dati per l'esportazione e quindi selezionare Scaricare 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 esiste come tabella Dataverse che puoi scaricare come file CSV (valori separati da virgole). La logica che determina quando e come il sistema registra le informazioni nelle trascrizioni delle conversazioni è:

  • Il sistema salva una conversazione su un record di trascrizione dopo 30 minuti di inattività. Se la conversazione riprende dopo il tempo di inattività, il sistema salva le nuove attività in un nuovo record con lo stesso Name valore ma con un nuovo ConversationStartTime valore.
  • Per gli agenti pubblicati sul canale telefonico, le conversazioni vanno in timeout tre minuti dopo un evento di Fine Conversazione.
  • Ogni record ha un limite di 1 MB per la trascrizione (Content colonna). Quando una trascrizione supera questo limite, il sistema la suddivide in più record, tutti avendo gli stessi valori Name e ConversationStartTime, ma con valori Metadata.BatchId differenti.
  • Per unire le trascrizioni, prendi tutti i record con gli stessi Name valori e ConversationStartTime poi ordini questi record per BatchId.

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 agente, il tenant ID, il nome dell'agente e l'ID batch {"BotId": "aaaabbbb-0000-cccc-1111-dddd2222eeee", "AADTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff", "BotName": "Test Bot", "BatchId":2}
Name Il nome della riga personalizzata creato da ConversationId seguito da BotId 8YYe8iif49ZKkycZLe7HUO_198eca5f-1145-4ae6-8c08-835d884a8688
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 Descrzione
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.
Per sicurezza e privacy, il sistema fa l'hash dell'ID prima di scriverlo sulla trascrizione.
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 Descrzione
ConversationInfo Indica se la conversazione proviene dal riquadro di test di Copilot Studio (isDesignMode) e dalle 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 di domanda nell'argomento, in cui una delle condizioni punta all'argomento di sistema Successo confermato CSAT (solo bot classici) 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), l'esito (Escalated, Resolved, ), Abandonl'inizio e la fine della sessione (startTimeUtc, endTimeUtc), e il conteggio dei turni della sessione
VariableAssignment Un valore è assegnato a una variabile

Trascrizioni ottimizzate

Puoi configurare gli agenti per generare trascrizioni migliorate che includono dati a livello di nodo. Questi dati consentono di tenere traccia del flusso di una conversazione all'interno di un argomento. Ad esempio, in un argomento gestione ordini, gli utenti possono scegliere tra l'invio di un nuovo ordine o il recupero di uno esistente. I dati a livello di nodo consentono l'analisi del comportamento degli utenti attraverso queste opzioni.

Attivare le trascrizioni avanzate

  1. Apri il tuo agente.

  2. Vai a Impostazioni>Avanzate.

  3. Seleziona Migliorare le trascrizioni, poi attiva Include dettagli a livello di nodo nelle trascrizioni.

Screenshot che mostra la pagina delle impostazioni delle trascrizioni avanzate.

Dati a livello di nodo

Quando attivi le trascrizioni migliorate, la trascrizione include un nodeTraceData tipo di attività per ogni nodo che un argomento invoca. La seguente tabella descrive i campi chiave nel valore dell'attività nodeTraceData.

Key Descrzione
nodeID Identificatore del nodo
nodeType Il tipo di nodo, ad esempio, SendActivity o SearchAndSummarizeContent
startTime Timestamp in cui il nodo è stato richiamato
endTime Timestamp al termine dell'esecuzione del nodo
topicDisplayName Argomento che richiama il nodo

Analisi personali

Alcuni scenari, come il filtro delle conversazioni in base a una variabile personalizzata, richiedono un approccio personalizzato per l'analisi. Per creare soluzioni di analisi personalizzate, i clienti possono inserire le trascrizioni non elaborate nelle pipeline di dati o usare un componente aggiuntivo, ad esempio Copilot Studio Kit.

La soluzione KPI Conversazionali in Copilot Studio Kit analizza automaticamente le trascrizioni e popola i dati aggregati nelle tabelle Dataverse.

Modificare il periodo di conservazione predefinito

Un processo di Power Apps di eliminazione in blocco rimuove automaticamente le trascrizioni degli agenti 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 selezionare Impostazioni>Impostazioni avanzate.

    Il portale di Dynamics 365 si apre in una nuova scheda.

    Screenshot del menu Impostazioni Power Apps con impostazioni avanzate evidenziate.

  2. Seleziona la freccetta accanto a Impostazioni. In System selezionare Data Management.

    Screenshot del menu Impostazioni, con Data Management 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. Seleziona Nuovo per avviare il Wizard di Cancellazione in massa. Nella procedura guidata selezionare 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 diverso se vuoi.
    • Seleziona SchemaType, tieni uguali e inserisci "powervirtualagents".

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

  3. Seleziona 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.

Perché non è possibile visualizzare le trascrizioni della conversazione nella tabella di Power Apps ConversationTranscript?

Gli amministratori possono impedire il salvataggio delle trascrizioni in Dataverse. Per maggiori informazioni su come vengono salvate le trascrizioni e su come gestire l'accesso, vedi Control transcript access.

Importante

Le trascrizioni non vengono memorizzate per gli agenti distribuiti negli ambienti di sviluppo.

Suggerimenti per ottenere il massimo dalle trascrizioni delle conversazioni

Usa variabili per memorizzare dati rilevanti per il contenuto o per l'utente del tuo agente. Analizzando la variabile e il suo valore dalla trascrizione della conversazione, puoi filtrare o sezionare i dati per 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.

  • Last updated on