🤖 Amazon Q Business

Interactive Deployment Console

Deployment Configuration

1 for dev/testing, higher for production

Deployment Commands

terraform init
terraform plan
terraform apply -auto-approve

Deployment Output

Ready to deploy. Click 'Deploy Now' to start...

Chat with Q Business

Welcome to Amazon Q Business! Ask me anything about your enterprise data.

Identity Center User Management

Existing Users

Click 'List Users' to load users from Identity Center

Deployment Status

Application

Unknown
Click 'Refresh Status' to check

Index

Unknown
-

Web Experience

Unknown
-

Data Sources

Unknown
-

Resource Information

Application ID: Loading...
Index ID: Loading...
Web Experience URL: Loading...

Quick Actions

Getting Started

Prerequisites

  • AWS IAM Identity Center must be enabled
  • Terraform >= 1.0 installed
  • AWS CLI v2 configured
  • jq JSON processor installed

Quick Start

  1. Go to the Deploy tab
  2. Configure your application name and region
  3. Click "Auto-Detect" to find your Identity Center ARN
  4. Click "Deploy Now" to start deployment
  5. Wait for deployment to complete (5-10 minutes)
  6. Go to Users tab to create/manage users
  7. Assign users to the application in AWS Console
  8. Use the Chat tab to interact with Q Business

Architecture

This deployment uses a hybrid approach:

  • Terraform: Manages IAM roles and orchestration
  • AWS CLI: Creates Q Business resources via null_resource provisioners
  • Local State: /tmp/qbusiness-*.json files store resource IDs

Important Notes

  • Identity Center users must be assigned to Q Business in the AWS Console
  • Q Business is only available in select regions (us-west-2, us-east-1, etc.)
  • Index capacity of 1 unit is sufficient for dev/testing
  • Data sources need to sync before data is available for queries

Troubleshooting

# Check if Identity Center is enabled
./get-identity-center-arn.sh

# View application details
cat /tmp/qbusiness-app.json | jq

# Check deployment logs
terraform show

# List all Q Business applications
aws qbusiness list-applications --region us-west-2

CLI Commands Reference

# Deploy via script
./deploy.sh my-app us-west-2

# Interactive chat
./qbusiness-interactive.sh

# SSO-based chat
./chat-interactive-sso.sh

# One-off question
./chat-simple.sh "What is our policy?"

# List Identity Center users
aws identitystore list-users --identity-store-id d-c367615483 --region eu-north-1

# Check application status
aws qbusiness get-application --application-id APP_ID --region us-west-2