GetUtterancesView - 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.

GetUtterancesView

Utilice la operación GetUtterancesView para obtener información acerca de los enunciados que los usuarios han hecho al bot. Puede utilizar esta lista para ajustar los enunciados a los que responde el bot.

Por ejemplo, supongamos que ha creado un bot para pedir flores. Una vez haya transcurrido cierto tiempo y los usuarios hayan utilizado bastante el bot, utilice la operación GetUtterancesView para ver las solicitudes que han realizado y si el resultado ha sido satisfactorio. Es posible que el enunciado “Quiero flores” no se reconozca. Puede añadir este enunciado a la intención OrderFlowers para que el bot lo reconozca.

Después de publicar una nueva versión de un bot, puede obtener información acerca de la versión anterior y la nueva para comparar el rendimiento de ambas versiones.

Las estadísticas de enunciados se generan una vez al día. Hay datos disponibles para los últimos 15 días. Puede solicitar información para un máximo de 5 versiones del bot en cada solicitud. Amazon Lex devuelve los enunciados más frecuentes que ha recibido el bot a lo largo de los últimos 15 días. La respuesta contiene información acerca de un máximo de 100 enunciados para cada versión.

Las estadísticas de los enunciados no se generan en las siguientes condiciones:

  • El childDirected campo estaba establecido en verdadero cuando se creó el bot.

  • Está utilizando la ofuscación de ranuras con una o más ranuras.

  • Ha optado por no participar en la mejora de Amazon Lex.

Esta operación necesita permisos para la acción lex:GetUtterancesView.

Sintaxis de la solicitud

GET /bots/botname/utterances?view=aggregation&bot_versions=botVersions&status_type=statusType HTTP/1.1

Parámetros de solicitud del URI

La solicitud utiliza los siguientes parámetros URI.

botname

El nombre del bot del que se devuelve información sobre enunciados.

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

Patrón: ^([A-Za-z]_?)+$

Obligatorio: sí

botVersions

La matriz de las versiones del bot de las que se devuelve información sobre enunciados. El límite es de 5 versiones por solicitud.

Miembros de la matriz: número mínimo de 1 elemento. La cantidad máxima es de 5 artículos.

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

Patrón: \$LATEST|[0-9]+

Obligatorio: sí

statusType

Para devolver enunciados reconocidos y gestionados, utilice Detected. Para devolver enunciados no reconocidos, utilice Missed.

Valores válidos: Detected | Missed

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

{
   "botName": "string",
   "utterances": [ 
      { 
         "botVersion": "string",
         "utterances": [ 
            { 
               "count": number,
               "distinctUsers": number,
               "firstUtteredDate": number,
               "lastUtteredDate": number,
               "utteranceString": "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.

botName

El nombre del bot del que se ha devuelto información sobre enunciados.

Tipo: cadena

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

Patrón: ^([A-Za-z]_?)+$

utterances

Una matriz de objetos UtteranceList, en la que cada objeto contiene una lista de objetos UtteranceData que describen los enunciados que ha procesado el bot. La respuesta contiene un máximo de 100 objetos UtteranceData para cada versión. Amazon Lex devuelve los enunciados más frecuentes que ha recibido el bot a lo largo de los últimos 15 días.

Tipo: matriz de objetos UtteranceList

Errores

BadRequestException

La solicitud no está bien formulada. Es posible que un valor no sea válido o que falte un campo obligatorio. Revise los valores del campo e inténtelo de nuevo.

Código de estado HTTP: 400

InternalFailureException

Se ha producido un error interno de Amazon Lex. Intente volver a realizar la solicitud.

Código de estado HTTP: 500

LimitExceededException

La solicitud ha superado un límite. Intente volver a realizar la solicitud.

Código de estado HTTP: 429

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: