Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
GetActionRecommendations
Renvoie une liste d'actions recommandées, triée par ordre décroissant par score de prédiction. Utilisez l'GetActionRecommendationsAPI si vous avez une campagne personnalisée qui déploie une version de solution entraînée par une recette PERSONALIZED_ACTIONS.
Pour plus d'informations sur les recettes PERSONALIZED_ACTIONS, voir recettes PERSONALIZED_ACTIONS. Pour plus d'informations sur l'obtention de recommandations d'action, voir Obtenir des recommandations d'action.
Syntaxe de la demande
POST /action-recommendations HTTP/1.1
Content-type: application/json
{
"campaignArn": "string",
"filterArn": "string",
"filterValues": {
"string" : "string"
},
"numResults": number,
"userId": "string"
}Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
Corps de la demande
Cette demande accepte les données suivantes au format JSON.
- campaignArn
-
Le nom de ressource Amazon (ARN) de la campagne à utiliser pour obtenir des recommandations d'action. Cette campagne doit déployer une version de solution entraînée avec une recette PERSONALIZED_ACTIONS.
Type : chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatoire : non
- filterArn
-
L'ARN du filtre à appliquer aux recommandations renvoyées. Pour de plus amples informations, veuillez consulter Filtrage des recommandations.
Lorsque vous utilisez ce paramètre, assurez-vous que la ressource de filtre est bien
ACTIVE.Type : chaîne
Contraintes de longueur : longueur maximale de 256.
Modèle :
arn:([a-z\d-]+):personalize:.*:.*:.+Obligatoire : non
- filterValues
-
Les valeurs à utiliser lors du filtrage des recommandations. Pour chaque paramètre d'espace réservé de votre expression de filtre, indiquez le nom du paramètre (le cas échéant) sous forme de clé et la ou les valeurs du filtre comme valeur correspondante. Séparez les valeurs multiples d'un paramètre par une virgule.
Pour les expressions de filtre qui utilisent un
INCLUDEélément pour inclure des actions, vous devez fournir des valeurs pour tous les paramètres définis dans l'expression. Pour les filtres contenant des expressions qui utilisent unEXCLUDEélément pour exclure des actions, vous pouvez omettre lefilter-values. Dans ce cas, Amazon Personalize n'utilise pas cette partie de l'expression pour filtrer les recommandations.Pour plus d'informations, consultez la section Recommandations de filtrage et segments d'utilisateurs.
Type : mappage chaîne/chaîne
Entrées cartographiques : nombre maximum de 25 éléments.
Contraintes relatives à la longueur des clés : longueur maximale de 50.
Modèle de clé :
[A-Za-z0-9_]+Contraintes de longueur de valeur : longueur maximale de 1000.
Obligatoire : non
- numResults
-
Le nombre de résultats à renvoyer. La valeur par défaut est 5. Le maximum est de 100.
Type : entier
Plage valide : Valeur minimum de 0.
Obligatoire : non
- userId
-
ID utilisateur de l'utilisateur pour lequel fournir des recommandations d'action.
Type : chaîne
Contraintes de longueur : longueur maximale de 256.
Obligatoire : non
Syntaxe de la réponse
HTTP/1.1 200
Content-type: application/json
{
"actionList": [
{
"actionId": "string",
"score": number
}
],
"recommendationId": "string"
}Eléments de réponse
Si l’action aboutit, le service renvoie une réponse HTTP 200.
Les données suivantes sont renvoyées au format JSON par le service.
- actionList
-
Liste de recommandations d'action triées par ordre décroissant par score de prédiction. La liste peut contenir un maximum de 100 actions. Pour plus d'informations sur les scores d'action, voir Comment fonctionne le score des recommandations d'action.
Type : tableau d’objets PredictedAction
- recommendationId
-
ID de la recommandation.
Type : chaîne
Erreurs
- InvalidInputException
-
Entrez une valeur valide pour le champ ou le paramètre.
Code d’état HTTP : 400
- ResourceNotFoundException
-
La ressource spécifiée n'existe pas.
Code d’état HTTP : 404
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :
