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.

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. For help determining your use case and choosing a recipe, see Determining your use case

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 HRNN recipe (legacy) HRNN-Metadata recipe (legacy) HRNN-Coldstart recipe (legacy)	GetRecommendations	userId: Required itemId: Not used inputList: NA
POPULAR_ITEMS	Trending-Now Popularity-Count	GetRecommendations	userId: Required only if you apply a filter that requires it 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: Required only if you apply a filter that requires it 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 AWS SDK for Python (Boto3), call the ListRecipes API.

• With the AWS 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 AWS CLI, use the following command.

aws personalize describe-recipe --recipe-arn recipe_arn