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.
GetActionRecommendations
Devuelve una lista de acciones recomendadas que se ordenan en orden descendente por puntuación de predicción. Use la API GetActionRecommendations si tiene una campaña personalizada que implementa una versión de la solución entrenada con una receta PERSONALIZED_ACTIONS.
Para obtener más información sobre las recetas PERSONALIZED_ACTIONS, consulte Recetas PERSONALIZED_ACTIONS. Para obtener más información sobre cómo obtener recomendaciones de acciones, consulte Obtención de recomendaciones de acciones.
Sintaxis de la solicitud
POST /action-recommendations HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"numResults": number,
"userId": "string"
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- campaignArn
-
El nombre de recurso de Amazon (ARN) de la campaña que se va a utilizar para obtener recomendaciones de acciones. Esta campaña debe desplegar una versión de la solución entrenada con una receta PERSONALIZED_ACTIONS.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: no
- filterArn
-
ARN del filtro que se aplicará a las recomendaciones devueltas. Para obtener más información, consulte Filtrado de recomendaciones.
Cuando utilice este parámetro, asegúrese de que el recurso de filtro sea
ACTIVE.Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Patrón:
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatorio: no
- filterValues
-
Los valores que se van a utilizar al filtrar las recomendaciones. Para cada parámetro de marcador de posición de la expresión de filtro, proporcione el nombre del parámetro (respetando mayúsculas y minúsculas) como clave y los valores del filtro como valor correspondiente. Separe los valores múltiples de un parámetro con una coma.
En el caso de las expresiones de filtro que utilizan un elemento
INCLUDEpara incluir acciones, debe proporcionar valores para todos los parámetros definidos en la expresión. En el caso de los filtros con expresiones que utilizan un elementoEXCLUDEpara excluir acciones, puede omitirfilter-values. En este caso, Amazon Personalize no utiliza esa parte de la expresión para filtrar recomendaciones.Para obtener más información, consulte Filtrado de recomendaciones y segmentos de usuario.
Tipo: mapa de cadena a cadena
Entradas de mapa: número máximo de 25 elementos.
Limitaciones de longitud de clave: longitud máxima de 50 caracteres.
Patrón de clave:
[A-Za-z0-9_]+Limitaciones de longitud de valor: longitud máxima de 1000 caracteres.
Obligatorio: no
- numResults
-
El número de resultados que se devolverá. El valor predeterminado es 5. El máximo es 100.
Tipo: entero
Rango válido: valor mínimo de 0.
Obligatorio: no
- userId
-
ID del usuario para el que se van a proporcionar recomendaciones de acciones.
Tipo: cadena
Limitaciones de longitud: longitud máxima de 256.
Obligatorio: no
Sintaxis de la respuesta
HTTP/1.1 200
Content-type: application/json
{
"actionList": [
{
"actionId": "string",
"score": number
}
],
"recommendationId": "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.
- actionList
-
Lista de recomendaciones de acciones en orden descendente por puntuación de predicción. Puede haber un máximo de 100 acciones en la lista. Para obtener información sobre las puntuaciones de las acciones, consulte Cómo funciona la puntuación de recomendaciones de acciones.
Tipo: matriz de objetos PredictedAction
- recommendationId
-
El identificador de la recomendación.
Tipo: cadena
Errores
- InvalidInputException
-
Proporcione un valor válido para el campo o el parámetro.
Código de estado HTTP: 400
- ResourceNotFoundException
-
El recurso especificado no existe.
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:
