Condividi tramite

Comprendere le trascrizioni delle conversazioni scaricate da Power Apps

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.

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 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

Le risposte degli agenti che utilizzano SharePoint come origine di conoscenza non sono incluse nelle trascrizioni delle conversazioni.

Le trascrizioni delle conversazioni non sono scritte per:

  • Ambienti Microsoft Dataverse for Teams
  • Ambienti per sviluppatori Dataverse
  • Agenti Microsoft 365 Copilot

Prerequisito

Visualizzare ed esportare le trascrizioni delle conversazioni dal portale Power Apps

  1. Accedi a Power Apps.

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

    Screenshot del nodo Tables 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. Aspetta un paio di minuti che Power Apps prepari i dati per l'esportazione, poi seleziona Scarica 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 si interrompono tre minuti dopo un evento di Fine Conversazione .
  • Ogni record ha un limite di 1 MB per la trascrizione (Content colonna). Quando una trascrizione è superiore a questo limite, il sistema la suddivide in più record, tutti con gli stessi Name valori e ConversationStartTime valori differenti Metadata.BatchId .
  • 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, l'ID inquilino, 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 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 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 Tipo (unengaged o engaged), risultato (Escalated, Resolved, Abandon), Ora di inizio e 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 costruire soluzioni di analisi personalizzate, i clienti possono integrare le trascrizioni grezze nei loro pipeline dati o utilizzare un add-on, come il Copilot Studio Kit.

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

Modificare il periodo di conservazione predefinito

Un lavoro di cancellazione in massa di Power Apps rimuove automaticamente le trascrizioni degli agenti vecchie di oltre 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.

    Il portale Dynamics 365 si apre in una nuova scheda.

    Screenshot del menu Impostazioni di Power Apps con l'opzione Impostazioni avanzate evidenziato.

  2. Seleziona il caret accanto a Impostazioni. 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. Seleziona Nuovo per avviare il Wizard di Cancellazione in massa. Nel wizard, seleziona Next.

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

Perché non riesco a vedere le trascrizioni delle mie conversazioni nella tabella ConversationTranscript di Power Apps?

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 l'utente agente 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