View a markdown version of this page

Utilizzo delle API per l'analisi - Amazon Lex
Filtraggio dei risultatiRecupero delle metriche per un botRecupero dei metadati per le sessioni e gli enunciati in un botRecupero dei dati di analisi del percorso degli intentiVisualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Utilizzo delle API per l'analisi

Questa sezione descrive le operazioni API utilizzate per recuperare le analisi per un bot.

Nota

Per utilizzare ListUtteranceMetrics and ListUtteranceAnalyticsData, il tuo ruolo IAM deve disporre delle autorizzazioni per eseguire l'ListAggregatedUtterancesoperazione, che fornisce l'accesso alle analisi relative agli enunciati. Consulta Visualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2 i dettagli e la policy IAM da applicare al ruolo IAM.

Filtraggio dei risultati

Le richieste dell'API di Analytics richiedono di specificare startTime eendTime. L'API restituisce sessioni, intenti, fasi di intento o enunciati iniziati dopo il startTime e terminati prima del. endTime

filtersè un campo opzionale nelle richieste dell'API di Analytics. È mappato a un elenco di AnalyticsSessionFilter AnalyticsIntentFilter, AnalyticsIntentStageFilter, o AnalyticsUtteranceFilter oggetti. In ogni oggetto, usa i campi per creare un'espressione in base alla quale filtrare. Ad esempio, se aggiungi il seguente filtro all'elenco, il bot cerca le conversazioni che durano più di 30 secondi.

{
    "name": "Duration",
    "operator": "GT",
    "value": "30 sec",
}

Recupero delle metriche per un bot

Usa le ListUtteranceMetrics operazioni ListSessionMetrics ListIntentMetricsListIntentStageMetrics, e per recuperare le metriche di riepilogo relative a sessioni, intenti, fasi dell'intento ed enunciati.

Per queste operazioni, compila i seguenti campi obbligatori:

  • Fornisci una startTime e endTime per definire un intervallo di tempo per il quale desideri recuperare i risultati.

  • Specifica le metriche in cui desideri calcolaremetrics, un elenco di AnalyticsSessionMetric, AnalyticsIntentMetric AnalyticsIntentStageMetric, o AnalyticsUtteranceMetric oggetti. In ogni oggetto, usa il name campo per specificare la metrica per calcolare il statistic campo per specificare se calcolare ilSum,Average, o il Max numero e il order campo per specificare se ordinare Ascending o Descending ordinare i risultati.

    Nota

    Sia l'oggetto che metrics l'binByoggetto contengono un order campo. È possibile specificare l'ordinamento solo order in uno dei due oggetti.

I campi rimanenti nella richiesta sono opzionali. Puoi filtrare e organizzare i risultati nei seguenti modi:

  • Filtraggio dei risultati: utilizza il filters campo per filtrare i risultati. Per ulteriori dettagli, consulta Filtraggio dei risultati.

  • Raggruppamento dei risultati per categoria: specifica il groupBy campo, un elenco contenente un singolo AnalyticsSessionResult oggetto, AnalyticsIntentResult AnalyticsIntentStageResult, o AnalyticsUtteranceResult. Nell'oggetto, specifica il name campo con la categoria in base alla quale desideri raggruppare i risultati.

    Se si specifica un groupBy campo nella richiesta, l'resultsoggetto nella risposta contiene groupByKeys un elenco di AnalyticsSessionGroupByKey AnalyticsIntentGroupByKey, AnalyticsIntentStageGroupByKey, o AnalyticsUtteranceGroupByKey oggetti, ognuno con name quello specificato nella richiesta e un membro di quella categoria nel value campo.

  • Raggruppamento dei risultati in base al tempo: specifica il binBy campo, un elenco contenente un singolo AnalyticsBinBySpecification oggetto. Nell'oggetto, specifica il name campo in cui ConversationStartTime raggruppare i risultati in base a quando è iniziata la conversazione o in base UtteranceTimestamp a quando è avvenuta l'espressione. Specificate l'intervallo di tempo entro il quale desiderate raggruppare i risultati nel interval campo e se eseguire l'ordinamento Ascending o Descending l'ordine di tempo nel order campo.

    Se si specifica un binBy campo nella richiesta, l'resultsoggetto nella risposta contiene binKeys un elenco di AnalyticsBinKey oggetti, ognuno con name quello specificato nella richiesta e l'intervallo di tempo che definisce il contenitore nel value campo.

    Nota

    Sia metrics gli binBy oggetti che contengono un order campo. È possibile specificare l'ordinamento solo order in uno dei due oggetti.

Utilizzate i seguenti campi per gestire la visualizzazione della risposta:

  • Specifica un numero compreso tra 1 e 1.000 nel maxResults campo per limitare il numero di risultati da restituire in una singola risposta.

  • Se il numero di risultati è maggiore del numero specificato nel maxResults campo, la risposta contiene unnextToken. Effettua nuovamente la richiesta, ma utilizza questo valore nel nextToken campo per restituire il successivo batch di risultati.

Se lo stai utilizzandoListUtteranceMetrics, puoi specificare gli attributi da restituire nel attributes campo. Questo campo è mappato a un elenco contenente un singolo AnalyticsUtteranceAttribute oggetto. Specifica LastUsedIntent nel name campo per restituire l'intento utilizzato da Amazon Lex V2 al momento della pronuncia.

Nella risposta, il results campo è mappato a un elenco di AnalyticsSessionResult, AnalyticsIntentResult AnalyticsIntentStageResult, o oggetti. AnalyticsUtteranceResult Ogni oggetto contiene un metrics campo che restituisce il valore di una statistica riassuntiva per una metrica richiesta, oltre a eventuali bin o gruppi creati con i metodi specificati.

Recupero dei metadati per le sessioni e gli enunciati in un bot

Usa le ListUtteranceAnalyticsData operazioni ListSessionAnalyticsData and per recuperare i metadati sulle singole sessioni ed enunciati.

Compila i endTime campi obbligatori startTime e per definire un intervallo di tempo per il quale desideri recuperare i risultati.

I campi rimanenti nella richiesta sono opzionali. Per filtrare e ordinare i risultati:

  • Filtraggio dei risultati: utilizza il filters campo per filtrare i risultati. Per ulteriori dettagli, consulta Filtraggio dei risultati.

  • Ordinamento dei risultati: ordina i risultati con il sortBy campo, che contiene un oggetto SessionDataSortBy or UtteranceDataSortBy. Specifica il valore in base al quale desideri ordinare nel name campo e se eseguire l'ordinamento Ascending o l'Descendingordinamento nel order campo.

Utilizza i seguenti campi per gestire la visualizzazione della risposta:

  • Specifica un numero compreso tra 1 e 1.000 nel maxResults campo per limitare il numero di risultati da restituire in una singola risposta.

  • Se il numero di risultati è maggiore del numero specificato nel maxResults campo, la risposta contiene unnextToken. Effettua nuovamente la richiesta, ma utilizza questo valore nel nextToken campo per restituire il successivo batch di risultati.

Nella risposta, il utterances campo sessions or è mappato a un elenco di UtteranceSpecification oggetti SessionSpecification or. Ogni oggetto contiene metadati per una singola sessione o enunciato.

Recupero dei dati di analisi del percorso degli intenti

Usa l'ListIntentPathsoperazione per recuperare le metriche relative all'ordine di intenti che i clienti assumono durante una conversazione con un bot.

Per questa operazione, compila i seguenti campi obbligatori:

  • Fornisci una startTime e endTime per definire un intervallo di tempo per il quale desideri recuperare i risultati.

  • Fornisci un intentPath comando per definire l'ordine degli intenti per i quali desideri recuperare le metriche. Separa gli intenti nel percorso con una barra in avanti. Ad esempio, compila il intentPath campo con /BookCar/BookHotel per visualizzare i dettagli su quante volte gli utenti hanno richiamato gli BookHotel intenti BookCar e in quell'ordine.

Utilizza il filters campo opzionale per filtrare i risultati. Per ulteriori dettagli, consultare Filtraggio dei risultati.

Visualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2

Puoi utilizzare le statistiche sugli enunciati per determinare gli enunciati che i tuoi utenti inviano al tuo bot. Puoi vedere sia gli enunciati che Amazon Lex V2 rileva correttamente sia quelli che non rileva. Puoi utilizzare queste informazioni per ottimizzare il tuo bot.

Ad esempio, se scopri che i tuoi utenti stanno inviando un enunciato mancante in Amazon Lex V2, puoi aggiungere l'enunciato a un intento. La versione Draft dell'intento viene aggiornata con il nuovo enunciato e puoi testarla prima di distribuirla al tuo bot.

Un enunciato viene rilevato quando Amazon Lex V2 lo riconosce come un tentativo di invocare un intento configurato per un bot. Un enunciato viene omesso quando Amazon Lex V2 non lo riconosce e lo invoca al suo posto. AMAZON.FallbackIntent

Le statistiche sugli enunciati possono essere visualizzate utilizzando l'API e l'APIListUtteranceMetrics. ListAggregatedUtterance

Le statistiche sugli enunciati non vengono generate utilizzando l'ListUtteranceMetricsAPI nelle seguenti condizioni:

  • L'impostazione Child Online Privacy Protection Act è stata impostata su Sì quando il bot è stato creato con la console, oppure il childDirected campo è stato impostato su true quando il bot è stato creato con l'CreateBotoperazione.

L'ListUtteranceMetricsAPI fornisce funzionalità aggiuntive, tra cui:

  • Sono disponibili ulteriori informazioni, ad esempio l'intento mappato delle espressioni rilevate.

  • Maggiori funzionalità di filtraggio (inclusi canale e modalità).

  • Intervallo di date di conservazione più lungo (30 giorni).

  • Puoi utilizzare l'API anche se hai disattivato l'archiviazione dei dati. La funzionalità della console per le espressioni mancanti o rilevate si baserà sull'ListUtteranceMetricsAPI.

Le statistiche sugli enunciati non vengono generate utilizzando l'ListAggregatedUtteranceAPI nelle seguenti condizioni:

  • L'impostazione Child Online Privacy Protection Act è stata impostata su Sì quando il bot è stato creato con la console, oppure il childDirected campo è stato impostato su true quando il bot è stato creato con l'CreateBotoperazione.

  • Stai utilizzando l'offuscamento degli slot con uno o più slot.

  • Hai scelto di non partecipare al miglioramento di Amazon Lex.

L'ListAggregatedUtteranceAPI offre funzionalità tra cui:

  • Sono disponibili informazioni meno dettagliate (nessun intento mappato per gli enunciati).

  • Capacità di filtraggio limitata (esclusi canale e modalità).

  • Intervallo di date di conservazione breve (15 giorni).

Utilizzando le statistiche sugli enunciati, puoi vedere se un enunciato specifico è stato rilevato o perso, oltre all'ultima volta in cui l'enunciato è stato utilizzato in un'interazione con un bot.

Amazon Lex V2 memorizza gli enunciati in modo continuo mentre gli utenti interagiscono con il bot. Puoi interrogare le statistiche utilizzando la console o l'ListAggregatedUtterancesoperazione. Ha una conservazione dei dati di 15 giorni e non è disponibile se l'utente ha disattivato l'archiviazione dei dati. È possibile eliminare le espressioni utilizzando l'DeleteUtterancesoperazione o disattivando l'archiviazione dei dati. Tutti gli enunciati vengono eliminati se chiudi il tuo account AWS. Le enunciazioni memorizzate sono crittografate con una chiave gestita dal server.

Quando elimini una versione del bot, le statistiche sulle espressioni sono disponibili per la versione per un massimo di 30 giorni in esecuzione e 15 giorni di ListUtteranceMetrics utilizzo. ListAggregatedUtterances Non puoi visualizzare le statistiche relative alla versione eliminata nella console Amazon Lex V2. Per visualizzare le statistiche relative alle versioni eliminate, puoi utilizzare entrambe ListAggregatedUtterances le ListUtteranceMetrics operazioni.

Sia con le API che con ListAggregatedUtterances le ListUtteranceMetrics API, gli enunciati vengono aggregati in base al testo dell'enunciato. Ad esempio, tutti i casi in cui il cliente ha utilizzato la frase «Voglio ordinare una pizza» vengono aggregati nella stessa riga in una risposta. Quando si utilizza l'RecognizeUtteranceoperazione, il testo utilizzato è la trascrizione di input.

Per utilizzare le ListUtteranceMetrics API ListAggregatedUtterances and, applica la seguente policy a un ruolo.

JSON
{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Sid": "ListAggregatedUtterancesPolicy",
            "Effect": "Allow",
            "Action": "lex:ListAggregatedUtterances",
            "Resource": "*"
        }
    ]
}