Getting started with Amazon Q

Learn how to get started with Amazon Q so that you can have tailored conversations, solve problems, generate content, take actions, and more. You can also use Amazon Q Developer to help you transform how you build, deploy, and operate applications and workloads in the AWS Management Console, integrated development environment (IDE), AWS documentation, and through Slack and Microsoft Teams.

Amazon Q Business

Step 1: Sign in to the console

Navigate to Amazon Q Business.


Step 2: Create your generative AI application

Name your application, select your retriever, and configure data sources.


Step 3: Enhance your application (optional)

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


Step 4: Customize the web experience

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


Step 5: Deploy the web experience

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

Amazon Q Business

Step 1: Sign in to the console

Navigate to Amazon Q Business.


Step 2: Create your generative AI application

Name your application, select your retriever, and configure data sources.


Step 3: Enhance your application (optional)

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


Step 4: Customize the 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 Developer in the AWS Management Console

Step 1: Sign in to the console or create a free AWS account

Take the tutorial: Create your AWS account.


Step 2: Ask Amazon Q a question

To get started, select the Amazon Q icon in the console Home on the right sidebar. Once signed in, you can also get guidance from Amazon Q on the aws.amazon.com website and in the 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. Visit the Amazon EC2 console to get started.

Amazon Q Developer in the AWS Management Console

Step 1: Sign in to the console or create a free AWS account

Take the tutorial: Create your AWS account.


Step 2: Ask Amazon Q a question

To get started, select the Amazon Q icon in the console Home on the right sidebar. Once signed in, you can also get guidance from Amazon Q on the aws.amazon.com website and in the 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. Visit the Amazon EC2 console to get started.

Amazon Q Developer 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: