Getting started with Amazon Q (Preview)

Learn how to get started with Amazon Q, your business expert, so you can have tailored conversations, solve problems, generate content, take actions, and more. You can also use Amazon Q to help you transform how you build, deploy, and operate applications and workloads on AWS, in the AWS Management Console, IDE, and more.

Amazon Q, your business expert

Step 1: Log into the console


Step 2: Create generative AI application

Name your application, select your retriever and configure data sources


Step 3: Enhance application (optional)

Add plugins, configure global controls, and define topic guardrails. 


Step 4: Customize web experience

Preview and customize the end-user web experience to verify readiness to deploy. 


Step 5: Deploy web experience

Configure access controls by defining an identity provider and share the URL with your team.

Amazon Q, your business expert

Step 1: Log into the console


Step 2: Create generative AI application

Name your application, select your retriever and configure data sources


Step 3: Enhance application (optional)

Add plugins, configure global controls, and define topic guardrails. 


Step 4: Customize web experience

Preview and customize the end-user web experience to verify readiness to deploy. 


Step 5: Deploy web experience

Configure access controls by defining an identity provider and share the URL with your team.

Amazon Q in the AWS Management Console

Step 1: Log into the console, or create a free AWS account


Step 2: Ask Amazon Q a question

Click the Amazon Q icon in the console Home on the right sidebar to get started. Once logged in, you can also get guidance from Amazon Q on the aws.amazon.com website and in AWS documentation.

Accessing additional capabilities in the console
Amazon Q can help you perform network troubleshooting by working with VPC Reachability Analyzer to check your connections and inspect your network configuration to identify potential issues. Get started with Amazon Q network troubleshooting.

Selecting Amazon EC2 instances
Amazon Q can help you make quick and cost-effective decisions to find the optimal compute instance type before building your workloads. Amazon Q generates personalized Amazon Elastic Compute Cloud (Amazon EC2) instance type suggestions, contextualized by your actions in the console. Please visit the Amazon EC2 console to get started.

Amazon Q in the AWS Management Console

Step 1: Log into the console, or create a free AWS account


Step 2: Ask Amazon Q a question

Click the Amazon Q icon in the console Home on the right sidebar to get started. Once logged in, you can also get guidance from Amazon Q on the aws.amazon.com website and in AWS documentation.

Accessing additional capabilities in the console
Amazon Q can help you perform network troubleshooting by working with VPC Reachability Analyzer to check your connections and inspect your network configuration to identify potential issues. Get started with Amazon Q network troubleshooting.

Selecting Amazon EC2 instances
Amazon Q can help you make quick and cost-effective decisions to find the optimal compute instance type before building your workloads. Amazon Q generates personalized Amazon Elastic Compute Cloud (Amazon EC2) instance type suggestions, contextualized by your actions in the console. Please visit the Amazon EC2 console to get started.

Amazon Q in the IDE with Amazon CodeWhisperer

Amazon Q is available in Visual Studio Code and the JetBrains family of IDEs with CodeWhisperer. Start working with CodeWhisperer in just a few minutes.

Step 1: Install

Install the CodeWhisperer extension for your editor.


Step 2: Authenticate

Sign in with Builder ID for Individual users and AWS IAM Identity Center for Professional users.


Step 3: Start building

Open your editor, and CodeWhisperer should just work!
For help on getting started, visit our User Guide.


Step 4: Ask Amazon Q a question in the IDE

Amazon Q can be found in the activity bar in Visual Studio Code or the tool window anchored to the top right space in IntelliJ IDEA.


Step 5 (Optional)

To take advantage of the Amazon Q feature development capability in the IDE, as well as Amazon Q Code Transformation, you need to be an Amazon CodeWhisperer Professional Tier customer and authenticate using IAM Identity Center. Visit the CodeWhisperer Pricing page to learn more.

Once you’re on the CodeWhisperer Professional plan and have followed steps 1 through 4 above:

Amazon Q in the IDE with Amazon CodeWhisperer

Amazon Q is available in Visual Studio Code and the JetBrains family of IDEs with CodeWhisperer. Start working with CodeWhisperer in just a few minutes.

Step 1: Install

Install the CodeWhisperer extension for your editor.


Step 2: Authenticate

Sign in with Builder ID for Individual users and AWS IAM Identity Center for Professional users.


Step 3: Start building

Open your editor, and CodeWhisperer should just work!
For help on getting started, visit our User Guide.


Step 4: Ask Amazon Q a question in the IDE

Amazon Q can be found in the activity bar in Visual Studio Code or the tool window anchored to the top right space in IntelliJ IDEA.


Step 5 (Optional)

To take advantage of the Amazon Q feature development capability in the IDE, as well as Amazon Q Code Transformation, you need to be an Amazon CodeWhisperer Professional Tier customer and authenticate using IAM Identity Center. Visit the CodeWhisperer Pricing page to learn more.

Once you’re on the CodeWhisperer Professional plan and have followed steps 1 through 4 above: