Avviso di fine del supporto: il 15 settembre 2025 AWS interromperà il supporto per Amazon Lex V1. Dopo il 15 settembre 2025, non potrai più accedere alla console di Amazon Lex V1 o alle risorse di Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la [guida Amazon Lex V2](https://docs.aws.amazon.com/lexv2/latest/dg/what-is.html). 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à. # GetUtterancesView Usa l'`GetUtterancesView`operazione per ottenere informazioni sulle espressioni che i tuoi utenti hanno fatto al tuo bot. Puoi usare questo elenco per ottimizzare gli enunciati a cui risponde il bot. Ad esempio, supponiamo di aver creato un bot per ordinare fiori. Dopo che gli utenti hanno utilizzato il bot per un certo periodo, utilizzate l'`GetUtterancesView`operazione per vedere le richieste che hanno fatto e se hanno avuto successo. Potresti scoprire che l'espressione «Voglio dei fiori» non viene riconosciuta. È possibile aggiungere questo enunciato all'`OrderFlowers`intento in modo che il bot lo riconosca. Dopo aver pubblicato una nuova versione di un bot, è possibile ottenere informazioni sulla versione precedente e sulla nuova in modo da poter confrontare le prestazioni tra le due versioni. Una volta al giorno vengono create le statistiche delle enunciazioni. I dati sono disponibili per gli ultimi 15 giorni. Puoi richiedere informazioni per un massimo di 5 versioni del tuo bot per ogni richiesta. Amazon Lex restituisce gli enunciati più frequenti ricevuti dal bot negli ultimi 15 giorni. La risposta contiene informazioni su un massimo di 100 enunciati per ogni versione. Le statistiche sugli enunciati non vengono generate nelle seguenti condizioni: + Il `childDirected` campo era impostato su true al momento della creazione del bot. + Stai usando l'offuscamento degli slot con uno o più slot. + Hai scelto di non partecipare al miglioramento di Amazon Lex. Questa operazione richiede le autorizzazioni per l'operazione `lex:GetUtterancesView`. ## Sintassi della richiesta ``` GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1 ``` ## Parametri della richiesta URI La richiesta utilizza i seguenti parametri URI. ** [botname](#API_GetUtterancesView_RequestSyntax) ** Il nome del bot per il quale devono essere restituite le informazioni sull'enunciato. Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri. Modello: `^([A-Za-z]_?)+$` Obbligatorio: sì ** [botVersions](#API_GetUtterancesView_RequestSyntax) ** Una serie di versioni dei bot per le quali devono essere restituite le informazioni sull'enunciato. Il limite è di 5 versioni per richiesta. Membri dell’array: numero minimo di 1 elemento. Numero massimo 5 elementi. Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `\$LATEST|[0-9]+` Obbligatorio: sì ** [statusType](#API_GetUtterancesView_RequestSyntax) ** Per restituire enunciati che sono stati riconosciuti e gestiti, usa. `Detected` Per restituire enunciati che non sono stati riconosciuti, usa. `Missed` Valori validi: `Detected | Missed` Obbligatorio: sì ## Corpo della richiesta La richiesta non ha un corpo della richiesta. ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "botName": "string", "utterances": [ { "botVersion": "string", "utterances": [ { "count": number, "distinctUsers": number, "firstUtteredDate": number, "lastUtteredDate": number, "utteranceString": "string" } ] } ] } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [botName](#API_GetUtterancesView_ResponseSyntax) ** Il nome del bot per il quale sono state restituite le informazioni sull'enunciato. Tipo: String Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri. Modello: `^([A-Za-z]_?)+$` ** [utterances](#API_GetUtterancesView_ResponseSyntax) ** Una serie di [UtteranceList](API_UtteranceList.md) oggetti, ciascuno contenente un elenco di [UtteranceData](API_UtteranceData.md) oggetti che descrivono gli enunciati elaborati dal bot. La risposta contiene un massimo di 100 `UtteranceData` oggetti per ogni versione. Amazon Lex restituisce gli enunciati più frequenti ricevuti dal bot negli ultimi 15 giorni. Tipo: matrice di oggetti [UtteranceList](API_UtteranceList.md) ## Errori ** BadRequestException ** La richiesta non è ben formulata. Ad esempio, un valore non è valido o manca un campo obbligatorio. Controlla i valori del campo e riprova. Codice di stato HTTP: 400 ** InternalFailureException ** Si è verificato un errore interno di Amazon Lex. Riprova la richiesta. Codice di stato HTTP: 500 ** LimitExceededException ** La richiesta ha superato il limite. Riprova la richiesta. Codice di stato HTTP: 429 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/lex-models-2017-04-19/GetUtterancesView) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/lex-models-2017-04-19/GetUtterancesView)