Utilizzo per l'analisi APIs - Amazon Lex
Filtrare i risultatiRecupero delle metriche per un botRecupero dei metadati per sessioni ed enunciati in un botRecupero dei dati analitici 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 per l'analisi APIs

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

Nota

Per utilizzare ListUtteranceMetricsand ListUtteranceAnalyticsData, il tuo ruolo IAM deve disporre delle autorizzazioni necessarie per eseguire l'ListAggregatedUtterancesoperazione, che fornisce l'accesso alle analisi relative agli enunciati. Visualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2Per ulteriori dettagli, consulta la policy IAM da applicare al ruolo IAM.

Filtrare i risultati

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

filtersè un campo opzionale nelle richieste dell'API Analytics. Viene mappato a un elenco di AnalyticsSessionFilterAnalyticsIntentFilter, AnalyticsIntentStageFilter, o AnalyticsUtteranceFilteroggetti. In ogni oggetto, utilizza 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

Utilizza le ListUtteranceMetrics operazioniListSessionMetrics, ListIntentMetricsListIntentStageMetrics, e per recuperare le metriche di riepilogo per sessioni, intenti, fasi degli intenti ed enunciati.

Per queste operazioni, compila i seguenti campi obbligatori:

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

  • Specificate le metriche in cui desiderate calcolaremetrics, un elenco di AnalyticsSessionMetric, AnalyticsIntentMetricAnalyticsIntentStageMetric, o AnalyticsUtteranceMetricoggetti. In ogni oggetto, utilizzate il name campo per specificare la metrica per calcolare il statistic campo per specificare se calcolare il SumAverage, o il Max numero e il order campo per specificare se ordinare Ascending o Descending ordinare i risultati.

    Nota

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

I campi rimanenti della richiesta sono facoltativi. È possibile filtrare e organizzare i risultati nei seguenti modi:

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

  • Raggruppamento dei risultati per categoria: specifica il groupBy campo, un elenco contenente un singolo AnalyticsSessionResult, AnalyticsIntentResultAnalyticsIntentStageResult, o AnalyticsUtteranceResultoggetto. Nell'oggetto, specificate il name campo con la categoria in base alla quale desiderate raggruppare i risultati.

    Se specificate un groupBy campo nella richiesta, l'resultsoggetto nella risposta contiene groupByKeys un elenco di AnalyticsSessionGroupByKeyAnalyticsIntentGroupByKey, AnalyticsIntentStageGroupByKey, o AnalyticsUtteranceGroupByKeyoggetti, ciascuno con name quello specificato nella richiesta e un membro di quella categoria nel value campo.

  • Risultati di associazione per ora: specifica il binBy campo, un elenco contenente un singolo AnalyticsBinBySpecificationoggetto. Nell'oggetto, specifica il name campo con ConversationStartTime cui raggruppare i risultati entro quando è iniziata la conversazione o in cui UtteranceTimestamp racchiudere i risultati entro quando ha avuto luogo l'enunciato. Specificate l'intervallo di tempo in base al quale desiderate raggruppare i risultati nel interval campo e se ordinare in base Ascending o Descending in base al tempo nel order campo.

    Se specificate un binBy campo nella richiesta, l'resultsoggetto nella risposta contiene binKeys un elenco di AnalyticsBinKeyoggetti, ciascuno con name quello specificato nella richiesta e l'intervallo di tempo che definisce il value contenitore nel campo.

    Nota

    Entrambi gli binBy oggetti metrics e 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:

  • Specificate 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. Ripeti la richiesta, ma usa questo valore nel nextToken campo per restituire il successivo batch di risultati.

Se si utilizzaListUtteranceMetrics, è possibile specificare gli attributi da restituire nel attributes campo. Questo campo è mappato a un elenco contenente un singolo AnalyticsUtteranceAttributeoggetto. Specificare LastUsedIntent nel name campo per restituire l'intento utilizzato da Amazon Lex V2 al momento dell'enunciato.

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

Recupero dei metadati per sessioni ed enunciati in un bot

Utilizzate le ListUtteranceAnalyticsDataoperazioni ListSessionAnalyticsDataand per recuperare i metadati relativi a 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 della richiesta sono facoltativi. Per filtrare e ordinare i risultati:

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

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

Utilizzate i seguenti campi per gestire la visualizzazione della risposta:

  • Specificate 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. Ripeti la richiesta, ma usa questo valore nel nextToken campo per restituire il successivo batch di risultati.

Nella risposta, il utterances campo sessions or viene mappato a un elenco di UtteranceSpecificationoggetti SessionSpecificationor. Ogni oggetto contiene metadati per una singola sessione o enunciato.

Recupero dei dati analitici del percorso degli intenti

Utilizza l'ListIntentPathsoperazione per recuperare le metriche relative a un ordine di intenti che i clienti hanno in una conversazione con un bot.

Per questa operazione, compila i seguenti campi obbligatori:

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

  • Fornisci un intentPath campo per definire un ordine di intenti per il quale 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 BookCar e gli BookHotel intenti in quell'ordine.

Utilizzate il filters campo opzionale per filtrare i risultati. Per ulteriori dettagli, consulta Filtrare i risultati.

Visualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2

Puoi utilizzare le statistiche sugli enunciati per determinare gli enunciati che gli utenti inviano al tuo bot. Puoi vedere sia gli enunciati che Amazon Lex V2 rileva con successo 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 che manca Amazon Lex V2, puoi aggiungere l'enunciato a un intento. La versione bozza dell'intento viene aggiornata con il nuovo enunciato e puoi testarla prima di distribuirla al bot.

Un'enunciazione viene rilevata quando Amazon Lex V2 riconosce l'enunciato come un tentativo di richiamare un intento configurato per un bot. Un enunciato viene perso quando Amazon Lex V2 non lo riconosce e lo richiama al suo posto. AMAZON.FallbackIntent

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

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

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

L'ListUtteranceMetricsAPI offre funzionalità aggiuntive, tra cui:

  • Sono disponibili ulteriori informazioni, ad esempio l'intento mappato per gli enunciati rilevati.

  • Maggiore capacità 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 gli enunciati persi e rilevati si baserà sull'ListUtteranceMetricsAPI.

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

  • L'impostazione del Child Online Privacy Protection Act era impostata su Sì quando il bot è stato creato con la console, oppure il childDirected campo era 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, è possibile vedere se un enunciato specifico è stato rilevato o perso, oltre all'ultima volta che l'enunciato è stato utilizzato in un'interazione con un bot.

Amazon Lex V2 archivia 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 gli enunciati utilizzando l'DeleteUtterancesoperazione o disattivando l'archiviazione dei dati. Tutti gli enunciati vengono eliminati se si chiude l'account. AWS Gli enunciati memorizzati sono crittografati con una chiave gestita dal server.

Quando si elimina una versione bot, le statistiche sugli enunciati sono disponibili per la versione per un massimo di 30 giorni con 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.

Con entrambi ListAggregatedUtterances e ListUtteranceMetrics APIs, gli enunciati vengono aggregati in base al testo dell'enunciato. Ad esempio, tutti i casi in cui il cliente ha usato 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 ListAggregatedUtterances and ListUtteranceMetrics APIs, applica la seguente politica a un ruolo.

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