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 Amazon Lex V1 o alle risorse Amazon Lex V1. Se utilizzi Amazon Lex V2, consulta invece la guida Amazon 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à.
Restituisce le informazioni di sessione per un bot, alias e ID utente specificato.
Sintassi della richiesta
GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1
Parametri della richiesta URI
La richiesta utilizza i seguenti parametri URI.
- botAlias
-
L'alias in uso per il bot che contiene i dati della sessione.
Campo obbligatorio: sì
- botName
-
Il nome del bot che contiene i dati della sessione.
Campo obbligatorio: sì
- checkpointLabelFilter
-
Una stringa usata per filtrare gli intenti restituiti nella
recentIntentSummaryViewstruttura.Quando si specifica un filtro, vengono restituiti solo gli intenti il cui
checkpointLabelcampo è impostato su quella stringa.Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 255.
Modello:
[a-zA-Z0-9-]+ - userId
-
L'ID dell'utente dell'applicazione client. Amazon Lex lo utilizza per identificare la conversazione di un utente con il tuo bot.
Vincoli di lunghezza: lunghezza minima di 2. Lunghezza massima di 100.
Modello:
[0-9a-zA-Z._:-]+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
{
"activeContexts": [
{
"name": "string",
"parameters": {
"string" : "string"
},
"timeToLive": {
"timeToLiveInSeconds": number,
"turnsToLive": number
}
}
],
"dialogAction": {
"fulfillmentState": "string",
"intentName": "string",
"message": "string",
"messageFormat": "string",
"slots": {
"string" : "string"
},
"slotToElicit": "string",
"type": "string"
},
"recentIntentSummaryView": [
{
"checkpointLabel": "string",
"confirmationStatus": "string",
"dialogActionType": "string",
"fulfillmentState": "string",
"intentName": "string",
"slots": {
"string" : "string"
},
"slotToElicit": "string"
}
],
"sessionAttributes": {
"string" : "string"
},
"sessionId": "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.
- activeContexts
-
Un elenco di contesti attivi per la sessione. Un contesto può essere impostato quando un intento viene soddisfatto o chiamando l'operazione
PostContentPostText, o.PutSessionÈ possibile utilizzare un contesto per controllare gli intenti che possono far seguito a un intento o per modificare il funzionamento dell'applicazione.
Tipo: matrice di oggetti ActiveContext
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 20 elementi.
- dialogAction
-
Descrive lo stato attuale del bot.
Tipo: oggetto DialogAction
- recentIntentSummaryView
-
Una serie di informazioni sugli intenti utilizzati nella sessione. L'array può contenere un massimo di tre riepiloghi. Se nella sessione vengono utilizzati più di tre intenti, l'
recentIntentSummaryViewoperazione contiene informazioni sugli ultimi tre intenti utilizzati.Se impostate il
checkpointLabelFilterparametro nella richiesta, l'array contiene solo gli intenti con l'etichetta specificata.Tipo: matrice di oggetti IntentSummary
Membri dell'array: numero minimo di 0 elementi. Numero massimo di 3 elementi.
- sessionAttributes
-
Mappa delle coppie chiave/valore che rappresentano le informazioni di contesto specifiche della sessione. Contiene informazioni sull'applicazione trasferite tra Amazon Lex e un'applicazione client.
Tipo: mappatura stringa a stringa
- sessionId
-
Un identificatore univoco per la sessione.
Tipo: stringa
Errori
- BadRequestException
-
La convalida della richiesta non è riuscita, non è presente alcun messaggio utilizzabile nel contesto o la compilazione del bot non è riuscita, è ancora in corso o contiene modifiche non integrate.
Codice di stato HTTP: 400
- InternalFailureException
-
Errore interno del servizio. Riprova la chiamata.
Codice di stato HTTP: 500
- LimitExceededException
-
È stato superato un limite.
Codice di stato HTTP: 429
- NotFoundException
-
La risorsa (ad esempio il bot Amazon Lex o un alias) a cui si fa riferimento non è stata trovata.
Codice di stato HTTP: 404
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
