GetActionRecommendations - Amazon Personalize
Syntaxe de la demandeParamètres de demande URICorps de la demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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

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 un EXCLUDE é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 :