GetSession - 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à.

GetSession

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 recentIntentSummaryView struttura.

Quando si specifica un filtro, vengono restituiti solo gli intenti il cui checkpointLabel campo è 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 checkpointLabelFilter parametro 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 uno degli AWS SDK specifici della lingua, consulta quanto segue: