GetSession - Amazon Lex V1
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Si utiliza Amazon Lex V2, consulte la guía de Amazon Lex V2.

 

Si utiliza Amazon Lex V1, le recomendamos que actualice los bots a Amazon Lex V2. Hemos dejado de agregar nuevas características a V1, por lo que recomendamos encarecidamente utilizar V2 para todos los nuevos bots.

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

GetSession

Devuelve la información de sesión de un bot, alias e ID de usuario especificados.

Sintaxis de la solicitud

GET /bot/botName/alias/botAlias/user/userId/session/?checkpointLabelFilter=checkpointLabelFilter HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

botAlias

El alias en uso para el bot que contiene los datos de la sesión.

Obligatorio: sí

botName

El nombre del bot que contiene los datos de la sesión.

Obligatorio: sí

checkpointLabelFilter

La cadena que se utiliza para filtrar las intenciones devueltas en la estructura recentIntentSummaryView.

Al especificar un filtro, solo se devuelven las intenciones cuyo campo checkpointLabel esté establecido para esa cadena.

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 255 caracteres.

Patrón: [a-zA-Z0-9-]+

userId

El ID del usuario de la aplicación cliente. Amazon Lex lo utiliza para identificar una conversación del usuario con el bot.

Limitaciones de longitud: longitud mínima de 2. La longitud máxima es de 100 caracteres.

Patrón: [0-9a-zA-Z._:-]+

Obligatorio: sí

Cuerpo de la solicitud

La solicitud no tiene un cuerpo de la solicitud.

Sintaxis de la respuesta

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"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

activeContexts

Una lista de los contextos activos para la sesión. Se puede establecer un contexto cuando se cumple una intención o mediante una llamada a la operación PostContent, PostText o PutSession.

Puede utilizar un contexto para controlar las intenciones que pueden acompañar una intención o para modificar la operación de la aplicación.

Tipo: matriz de objetos ActiveContext

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 20 artículos.

dialogAction

Describe el estado actual del bot.

Tipo: objeto DialogAction

recentIntentSummaryView

Una matriz de información sobre las intenciones que se utilizan en la sesión. La matriz puede contener hasta tres resúmenes. Si se utilizan más de tres intenciones en la sesión, la operación recentIntentSummaryView contiene información sobre los tres últimos intentos empleados.

Si establece el parámetro checkpointLabelFilter en la solicitud, la matriz contiene únicamente las intenciones con la etiqueta especificada.

Tipo: matriz de objetos IntentSummary

Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 3 elementos.

sessionAttributes

Un mapa de pares clave/valor que representa la información de contexto específica de la sesión. Contiene información de la aplicación pasada entre Amazon Lex y una aplicación cliente.

Tipo: mapa de cadena a cadena

sessionId

Un identificador único de la sesión.

Tipo: cadena

Errores

BadRequestException

Se ha producido un error al validar la solicitud, no hay mensajes útiles en el contexto o la compilación del bot ha fallado, está en curso o contiene cambios sin compilar.

Código de estado HTTP: 400

InternalFailureException

Error de servicio interno. Vuelva a intentar la llamada.

Código de estado HTTP: 500

LimitExceededException

Se ha superado un límite.

Código de estado HTTP: 429

NotFoundException

No se ha encontrado el recurso (como el bot o un alias de Amazon Lex) al que se hace referencia.

Código de estado HTTP: 404

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulta lo siguiente: