Step 1: Choosing a recipe - Amazon Personalize
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China.

Step 1: Choosing a recipe

Amazon Personalize provides recipes, based on common use cases, for training models. Recipes are Amazon Personalize algorithms that are prepared for specific use cases. With recipes, you can create a personalization system without prior machine learning experience.

Amazon Personalize recipes use the following during training:

  • Predefined attributes of your data

  • Predefined feature transformations

  • Predefined algorithms

  • Initial parameter settings for the algorithms

To optimize your model, you can override many of these parameters when you create a solution. For more information, see Hyperparameters and HPO.

Choose a specific recipe based on what you want to accomplish and how familiar you are with the recipes. Each recipe is designed for a specific use case. When creating a solution, choose the recipe that best fits your needs.

Amazon Personalize recipes

Amazon Personalize provides three types of recipes. Besides behavioral differences, each type has different requirements for getting recommendations, as shown in the following table.

Recipe type Recipes API API requirements
USER_PERSONALIZATION

User-Personalization

Popularity-Count

HRNN recipe (legacy)

HRNN-Metadata recipe (legacy)

HRNN-Coldstart recipe (legacy)

GetRecommendations

userId: Required

itemId: Not used

inputList: NA

PERSONALIZED_RANKING

Personalized-Ranking

GetPersonalizedRanking

userId: Required

itemId: NA

inputList: list of itemId's

RELATED_ITEMS

Similar-Items

SIMS

GetRecommendations

userId: Not used

itemId: Required

inputList: NA

USER_SEGMENTATION

Item-Affinity

Item-Attribute-Affinity

CreateBatchSegmentJob

For batch workflow requirements, see Creating a batch segment job.

Viewing available Amazon Personalize recipes

To see a list of available recipes:

  • In the Amazon Personalize console, choose a dataset group. From the navigation pane, choose Solutions and recipes, and choose the Recipes tab.

  • With the Amazon SDK for Python (Boto3), call the ListRecipes API.

  • With the Amazon CLI, use the following command.

    aws personalize list-recipes

To get information about a recipe using the SDK for Python (Boto3), call the DescribeRecipe API. To get information about a recipe using the Amazon CLI, use the following command.

aws personalize describe-recipe --recipe-arn recipe_arn