GetUtterancesView - Amazon Lex versione 1
Sintassi della richiestaParametri della richiesta URICorpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Se utilizzi Amazon Lex V2, consulta invece la guida Amazon Lex V2.

 

Se utilizzi Amazon Lex V1, ti consigliamo di aggiornare i bot ad Amazon Lex V2. Non stiamo più aggiungendo nuove funzionalità alla V1 e consigliamo vivamente di utilizzare la V2 per tutti i nuovi bot.

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'GetUtterancesViewoperazione 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'GetUtterancesViewoperazione 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'OrderFlowersintento 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

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]_?)+$

Campo obbligatorio: sì

botVersions

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]+

Campo obbligatorio: sì

statusType

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

Campo 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

Il nome del bot per il quale sono state restituite le informazioni sull'enunciato.

▬Tipo: stringa

Vincoli di lunghezza: lunghezza minima di 2. La lunghezza massima è 50 caratteri.

Modello: ^([A-Za-z]_?)+$

utterances

Una serie di UtteranceList oggetti, ciascuno contenente un elenco di UtteranceData 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

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 uno degli AWS SDK specifici della lingua, consulta quanto segue: