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 [ListUtteranceMetrics](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListUtteranceMetrics.html)and [ListUtteranceAnalyticsData](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListUtteranceAnalyticsData.html), il tuo ruolo IAM deve disporre delle autorizzazioni per eseguire l'[ListAggregatedUtterances](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListAggregatedUtterances.html)operazione, che fornisce l'accesso alle analisi relative agli enunciati. [Visualizzazione delle statistiche sugli enunciati dalle conversazioni di Lex V2](#monitoring-utterances)Per ulteriori dettagli, consulta la policy IAM da applicare al ruolo IAM.
+ Le seguenti operazioni API recuperano le metriche di riepilogo per un bot:
+ [ListSessionMetrics](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListSessionMetrics.html)
+ [ListIntentMetrics](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListIntentMetrics.html)
+ [ListIntentStageMetrics](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListIntentStageMetrics.html)
+ [ListUtteranceMetrics](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListUtteranceMetrics.html)
+ Le seguenti operazioni API recuperano un elenco di metadati per sessioni ed enunciati:
+ [ListSessionAnalyticsData](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListSessionAnalyticsData.html)
+ [ListUtteranceAnalyticsData](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListUtteranceAnalyticsData.html)
+ L'[ListIntentPaths](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListIntentPaths.html)operazione recupera le metriche relative a un ordine di intenti utilizzato dai clienti nelle conversazioni con un bot.
## Filtraggio dei risultati
Le richieste dell'API Analytics richiedono di specificare `startTime` e`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 [AnalyticsSessionFilter[AnalyticsIntentFilter](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentFilter.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsSessionFilter.html), [AnalyticsIntentStageFilter](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentStageFilter.html), o [AnalyticsUtteranceFilter](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceFilter.html)oggetti. 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` operazioni`ListSessionMetrics`, `ListIntentMetrics``ListIntentStageMetrics`, 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 calcolare`metrics`, un elenco di [AnalyticsSessionMetric](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsSessionMetric.html), [AnalyticsIntentMetric[AnalyticsIntentStageMetric](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentStageMetric.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentMetric.html), o [AnalyticsUtteranceMetric](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceMetric.html)oggetti. In ogni oggetto, utilizzate il `name` campo per specificare la metrica per calcolare il `statistic` campo per specificare se calcolare il `Sum``Average`, 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 [Filtraggio dei risultati](#analytics-api-filters).
+ **Raggruppamento dei risultati per categoria**: specifica il `groupBy` campo, un elenco contenente un singolo [AnalyticsSessionResult](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsSessionResult.html), [AnalyticsIntentResult[AnalyticsIntentStageResult](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentStageResult.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentResult.html), o [AnalyticsUtteranceResult](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceResult.html)oggetto. 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'`results`oggetto nella risposta contiene `groupByKeys` un elenco di [AnalyticsSessionGroupByKey[AnalyticsIntentGroupByKey](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentGroupByKey.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsSessionGroupByKey.html), [AnalyticsIntentStageGroupByKey](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentStageGroupByKey.html), o [AnalyticsUtteranceGroupByKey](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceGroupByKey.html)oggetti, 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 [AnalyticsBinBySpecification](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsBinBySpecification.html)oggetto. 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'`results`oggetto nella risposta contiene `binKeys` un elenco di [AnalyticsBinKey](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsBinKey.html)oggetti, 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 un`nextToken`. Ripeti la richiesta, ma usa questo valore nel `nextToken` campo per restituire il successivo batch di risultati.
Se si utilizza`ListUtteranceMetrics`, è possibile specificare gli attributi da restituire nel `attributes` campo. Questo campo è mappato a un elenco contenente un singolo [AnalyticsUtteranceAttribute](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceAttribute.html)oggetto. 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](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsSessionResult.html), [AnalyticsIntentResult[AnalyticsIntentStageResult](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentStageResult.html)](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsIntentResult.html), o oggetti. [AnalyticsUtteranceResult](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_AnalyticsUtteranceResult.html) 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 [ListUtteranceAnalyticsData](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListUtteranceAnalyticsData.html)operazioni [ListSessionAnalyticsData](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListSessionAnalyticsData.html)and 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 [Filtraggio dei risultati](#analytics-api-filters).
+ **Ordinamento dei risultati**: ordina i risultati in base al `sortBy` campo, che contiene un oggetto [SessionDataSortBy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_SessionDataSortBy.html)or [UtteranceDataSortBy](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UtteranceDataSortBy.html). Specificate il valore in base al quale desiderate ordinare nel `name` campo e se eseguire l'ordinamento `Ascending` o l'`Descending`ordinamento 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 un`nextToken`. 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 [UtteranceSpecification](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_UtteranceSpecification.html)oggetti [SessionSpecification](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_SessionSpecification.html)or. Ogni oggetto contiene metadati per una singola sessione o enunciato.
## Recupero dei dati analitici del percorso degli intenti
Utilizza l'[ListIntentPaths](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_ListIntentPaths.html)operazione 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, consultare [Filtraggio dei risultati](#analytics-api-filters).
## 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'`ListUtteranceMetrics`API 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'`CreateBot`operazione.
L'`ListUtteranceMetrics`API 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'`ListUtteranceMetrics`API.
Le statistiche sugli enunciati non vengono generate utilizzando l'`ListAggregatedUtterance`API 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'`CreateBot`operazione.
+ Stai utilizzando l'offuscamento degli slot con uno o più slot.
+ Hai scelto di non partecipare al miglioramento di Amazon Lex.
L'`ListAggregatedUtterance`API 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'`ListAggregatedUtterances`operazione. 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'`DeleteUtterances`operazione o disattivando l'archiviazione dei dati. Tutti gli enunciati vengono eliminati se chiudi il tuo 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'[RecognizeUtterance](https://docs.aws.amazon.com/lexv2/latest/APIReference/API_runtime_RecognizeUtterance.html)operazione, 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": "*"
}
]
}
```
------