Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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
- Per visualizzare le trascrizioni delle conversazioni, è necessario il ruolo di sicurezza Bot Transcript Viewer . Solo gli amministratori possono concedere il ruolo di sicurezza Bot Transcript Viewer.
Visualizzare ed esportare le trascrizioni delle conversazioni dal portale Power Apps
Accedi a Power Apps.
Nel riquadro di spostamento laterale seleziona Tabelle, quindi seleziona Tutto.
Immetti "conversazione" nella casella Ricerca.
Seleziona la tabella ConversationTranscript.
Si apre una pagina per la tabella ConversationTranscript.
Sulla barra dei menu superiore, seleziona Esporta>Esporta dati.
Ci vogliono alcuni minuti per compilare i dati per l'esportazione.
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.
Nota
- Se una conversazione ha 30 minuti di inattività, la conversazione viene salvata in un record di trascrizione. Se la conversazione riprende dopo un periodo di inattività, viene salvata in un nuovo record di trascrizione con lo stesso
Name. - Se un record di trascrizione per una conversazione è maggiore di 1 MB, la trascrizione viene suddivisa in più record, ognuno non superiore a 1 MB e ognuno con gli stessi
Namevalori eConversationStartTime.
| 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 |
Nome della riga personalizzata creata 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:
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:
|
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
Gli agenti possono essere configurati 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
Apri il tuo agente.
Vai a Impostazioni>Avanzate.
Seleziona Ottimizza trascrizioni, quindi attiva l'opzione Includi dettagli a livello di nodo nelle trascrizioni.
Dati a livello di nodo
Quando le trascrizioni avanzate sono attivate, nella trascrizione viene visualizzato un tipo di impegno nodeTraceData per ogni nodo richiamato da un argomento. 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. I clienti che creano soluzioni di analisi personalizzate possono inserire le trascrizioni non elaborate nelle pipeline di dati o utilizzare un componente aggiuntivo, come il Kit di Copilot Studio
La soluzione KPI Conversazione all'interno del Kit di Copilot Studio analizza automaticamente le trascrizioni e popola i dati aggregati in tabelle Dataverse.
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
In Power Apps, seleziona Impostazioni>Impostazioni avanzate.
Il portale Dynamics 365 si apre in una nuova scheda.
Seleziona la freccia accanto a Impostazioni, quindi sotto Sistema, seleziona Gestione dati.
Seleziona Eliminazione in blocco record.
Nel menu Visualizza, seleziona Processi di sistema di eliminazione in blocco ricorrenti.
Seleziona il processo Elimina in blocco record delle trascrizioni delle conversazioni create da più di 1 mese.
Nell'elenco Altre azioni, seleziona Annulla.
Creare un nuovo processo di eliminazione in blocco
Per avviare la procedura guidata di eliminazione in blocco, seleziona Nuovo e quindi, nella procedura guidata, seleziona Avanti.
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".
Selezionare Avanti.
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.
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 dettagli su come vengono salvate le trascrizioni e su come gestire l'accesso, vedi Controllare l'accesso alle trascrizioni.
Importante
Le trascrizioni non vengono archiviate per gli agenti distribuiti in ambienti di sviluppo.
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.