Skip to content

Latest commit

 

History

History

getting_started

Getting Started

This tutorial will walk you through how to get started using Amazon Personalize:

  1. Building a work environment (see steps bellow)
  2. Build your first use-case optimized recommenders for Video On Demand and E-commerce
  3. Build your first custom dataset, model, and recommendation campaign

Environment Prerequisites

Only applies if you are deploying with the CloudFormation template, otherwise consult the IAM permissions needed for your specific task.

  1. AWS Account
  2. User with administrator access to the AWS Account

Building Your Environment

The first step is to deploy a CloudFormation template that will perform much of the initial setup for you. In another browser window login to your AWS account. Once you have done that open the link below in a new tab to start the process of deploying the items you need via CloudFormation.

Region Launch stack
US East (N. Virginia) Launch Stack
Europe (Ireland) Launch Stack
Asia Pacific (Sydney) Launch Stack

Follow along with the screenshots if you have any questions about these steps.

Click to expand the instructions

Cloud Formation Wizard

Start by clicking Next at the bottom like shown:

StackWizard

In the next page you need to provide a unique S3 bucket name for your file storage, it is recommended to simply add your first name and last name to the end of the default option as shown below, after that update click Next again.

StackWizard2

This page is a bit longer so scroll to the bottom to click Next.

StackWizard3

Again scroll to the bottom, check the box to enable the template to create new IAM resources and then click Create Stack.

StackWizard4

For a few minutes CloudFormation will be creating the resources described above on your behalf it will look like this while it is provisioning:

StackWizard5

Once it has completed you'll see green text like below indicating that the work has been completed:

StackWizard5

Now that you have your environment created, you need to save the name of your S3 bucket for future use, you can find it by clicking on the Outputs tab and then looking for the resource S3Bucket, once you find it copy and paste it to a text file for the time being.

Using the Notebooks

Start by navigating to the Amazon SageMaker landing page. From the service page click the Notebook Instances link on the far left menu bar.

StackWizard5

To get to the Jupyter interface, simply click Open JupyterLab on the far right next to your notebook instance.

StackWizard5

Clicking the open link will take a few seconds to redirect you to the Jupyter system but once there you should see a collection of files on your left.

To get started navigate to the first notebook using domain dataset groups and use-case optimized recommenders.

or using custom dataset groups:

The rest of the lab will take place via the Jupyter notebooks, simply read each block before executing it and moving onto the next. If you have any questions about how to use the notebooks please ask your instructor.

Cleanup Resources

Once you have completed all of the work in the Notebooks and have completed the cleanup steps there as well, the last thing to do is to delete the stack you created with CloudFormation. To do that, inside the AWS Console again click the Services link at the top, and this time enter in CloudFormation and click the link for it.

StackWizard5

Click the Delete button on the demo stack you created:

StackWizard5

Lastly click the Delete Stack button that shows up on the popup:

StackWizard5

You'll now notice that the stack is in progress of being deleted. Once you see Delete Completed you know that everything has been deleted and you are 100% done with this lab.