Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Managing Amazon Q Business admin controls and guardrails

Focus mode
Managing Amazon Q Business admin controls and guardrails - Amazon Q Business

To manage Amazon Q Business admin controls and guardrails, you can take the following actions:

Note

You can't create or delete guardrail global controls. You can only update existing global controls in your application environment.

Deleting topic controls

To delete configured chat controls, you can use AWS Management Console or the DeleteChatControlsConfiguration API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To delete topic controls

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. From the left navigation menu, choose Enhancements, and then choose Guardrails.

  4. In Guardrails, from Topic specific controls, choose the topic control you want to delete, and then choose Delete.

  5. In the dialog box, type delete to confirm your action.

    The console displays a successful deletion message when the plugin deletion process is finished.

AWS CLI

To delete a topic specific control

aws qbusiness delete-chat-controls-configuration \ --application-id application-id

To delete topic controls

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. In Applications, select the name of your application environment from the list of applications.

  3. From the left navigation menu, choose Enhancements, and then choose Guardrails.

  4. In Guardrails, from Topic specific controls, choose the topic control you want to delete, and then choose Delete.

  5. In the dialog box, type delete to confirm your action.

    The console displays a successful deletion message when the plugin deletion process is finished.

Getting topic control properties

To get the details of Amazon Q Business topic controls, you can use either the AWS Management Console or the GetChatControlsConfiguration API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

Console

To get configured details for admin controls and guardails

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. From the Amazon Q Business console, in Applications, select the name of your application environment from the list of applications.

  3. From the left navigation menu, choose Enhancements, and then choose Admin controls and guardrails.

    You will find the details of your configured Global controls and Topic specific controls on the page.

AWS CLI

To get admin controls and guardrails details

aws qbusiness get-chat-control-configuration \ --application-id application-id

To get configured details for admin controls and guardails

  1. Sign in to the AWS Management Console and open the Amazon Q Business console.

  2. From the Amazon Q Business console, in Applications, select the name of your application environment from the list of applications.

  3. From the left navigation menu, choose Enhancements, and then choose Admin controls and guardrails.

    You will find the details of your configured Global controls and Topic specific controls on the page.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.