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, command line interface (CLI), 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 custom Amazon Q Business assistant

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


Step 3: Enhance your Amazon Q Business assistant (optional)

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


Step 4: Customize the end user experience

Preview and customize the end-user web experience, or choose to embed the assistant into an your application’s user interface.


Step 5: Deploy Amazon Q Business

Configure access controls and share the URL with your team or deploy in your owned app. Share the “Quick guide to using Amazon Q Business” to your users to help them get started.


Step 6: Create and share secure apps using your enterprise data with Amazon Q Apps

Generate apps in a single step from your conversation with Amazon Q Business or by describing your requirements using natural language in the Amazon Q Apps Creator. Once created, you can publish it to the Amazon Q Apps Library to share with all users on the same web experience.

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.


Step 6: Create and share secure apps using your enterprise data with Amazon Q Apps

Generate apps in a single step from your conversation with Amazon Q Business or by describing your requirements using natural language in the Amazon Q Apps Creator. Once created, you can publish it to the Amazon Q Apps Library to share with all users on the same web experience.

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

Amazon Q is available in VS Code and the JetBrains family of IDEs. Get started with Amazon Q in just a few minutes.

Step 1: Install

Install the Amazon Q 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: Ask Amazon Q a question in the IDE

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


Step 4 (Optional)

To take advantage of the Amazon Q feature development capability in the IDE, as well as Amazon Q Developer Agent for code transformation, you need to be an Amazon Q Pro Tier customer and authenticate using IAM Identity Center. For more information, see Amazon Q Developer pricing.

Once you’re on the Amazon Q Developer Pro plan and have followed steps 1–4 above:

Amazon Q Developer in the IDE

Amazon Q is available in VS Code and the JetBrains family of IDEs. Get started with Amazon Q in just a few minutes.

Step 1: Install

Install the Amazon Q 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: Ask Amazon Q a question in the IDE

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


Step 4 (Optional)

To take advantage of the Amazon Q feature development capability in the IDE, as well as Amazon Q Developer Agent for code transformation, you need to be an Amazon Q Pro Tier Customer and authenticate using IAM Identity Center. For more information, see Amazon Q Developer pricing.

Once you’re on the Amazon Q Developer Pro plan and have followed steps 1–4 above: