# Managing response configurations
<a name="response-customization-configurations"></a>

When you create an Amazon Q Business application, Amazon Q Business applies default response settings to it. You can customize responses for a Amazon Q Business application using the AWS Management Console and the API.

**Topics**
+ [Creating custom response settings](#create-response-configuration)
+ [Editing response customization settings](#edit-response-configuration)
+ [Deleting existing response customization settings](#delete-response-configuration)
+ [Listing response customization settings](#list-response-configurations)

## Creating custom response settings
<a name="create-response-configuration"></a>

You can customize Amazon Q Business responses using the AWS Management Console or the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateChatResponseConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_CreateChatResponseConfiguration.html) API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

**Note**  
To optimize performance and accuracy, Amazon Q Business may pre-process custom prompts before using them to generate responses.

------
#### [ Console ]

**To customize responses**

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

1. In the navigation pane, choose **Applications**, and then select your application.

1. Choose **Enhancements** from the navigation menu, and then select **Response customization**.

1. From **Response customization**, choose **Edit**.

1. In **Edit response settings**, in **Persona**, do the following:

   1. For **Define assistant's identity**, define the persona for your assistant. You can choose between selecting the default Amazon Q Business identity or defining a custom identity for your assistant.

   1. For **Describe assistant's perspective**, select the point of view for assistant responses. You can choose between selecting the default Amazon Q Business perspective or defining a custom role and perspective for your assistant.

   1. For **Describe assistant's audience**, specify the intended audience for responses. You can choose between selecting the default Amazon Q Business perspective or defining a specific audience that your assistant will be interacting with.

1. In **Edit response settings**, in **Response preference**, do the following:

   1. For **Set default response style**, choose the formatting style for responses. You can choose between selecting the default Amazon Q Business response style or defining a custom response style for your assistant.

   1. For **Set default response tone**, select the communication style for responses. You can choose between selecting the default Amazon Q Business response tone or defining a custom response tone for your assistant.

   1. For **Set response length**, choose the appropriate level of detail for responses. You can choose between selecting the default Amazon Q Business response length or defining a custom response length for your assistant.

1. For **Additional instructions – *Optional***, enter any other specific guidance for response generation.

1. Choose **Save** to save your configuration.

------
#### [ AWS CLI ]

**To create a response configuration**

```
aws qbusiness create-chat-response-configuration \
--application-id {{application-id}} \
--display-name {{configuration-name}} \
--client-token {{client-token}} \
--response-configurations '[
  {
    "instructionCollection": {
      "responseLength": "{{DETAILED}}",
      "targetAudience": "{{TECHNICAL_EXPERTS}}",
      "perspective": "{{FIRST_PERSON}}",
      "outputStyle": "{{BULLET_POINTS}}",
      "identity": "{{ASSISTANT}}",
      "tone": "{{PROFESSIONAL}}",
      "customInstructions": "{{Provide detailed technical explanations with code examples when appropriate.}}",
      "examples": "{{Example 1: When asked about Lambda, explain the service, its key features, and include a simple code example.}}"
    }
  }
]'
```

------

## Editing response customization settings
<a name="edit-response-configuration"></a>

You can edit an existing response configuration using the AWS Management Console or the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateChatResponseConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_UpdateChatResponseConfiguration.html) API operation. The following tabs provide a procedure for the console and code examples for the AWS CLI.

------
#### [ Console ]

**To edit response customization settings**

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

1. In the navigation pane, choose **Applications**, and then select your application.

1. Choose **Enhancements** from the navigation menu, and then select **Response customization**.

1. From **Response customization**, choose **Edit**.

1. In **Edit response settings**, modify the configuration settings as needed.
**Note**  
You can also reset an all existing customizations to the default used by Amazon Q Business. To do so, select **Reset to defaults**.

1. Choose **Save** to apply your changes.

------
#### [ AWS CLI ]

**To update a response configuration**

```
aws qbusiness update-chat-response-configuration \
--application-id {{application-id}} \
--chat-response-configuration-id {{configuration-id}} \
--display-name {{updated-name}} \
--client-token {{client-token}} \
--response-configurations '[
  {
    "instructionCollection": {
      "responseLength": "{{CONCISE}}",
      "targetAudience": "{{GENERAL_USERS}}",
      "perspective": "{{SECOND_PERSON}}",
      "outputStyle": "{{PARAGRAPHS}}",
      "identity": "{{EXPERT}}",
      "tone": "{{FRIENDLY}}",
      "customInstructions": "{{Provide clear, concise explanations suitable for general users.}}",
      "examples": "{{Example 1: When asked about Lambda, provide a brief overview in simple terms.}}"
    }
  }
]'
```

------

## Deleting existing response customization settings
<a name="delete-response-configuration"></a>

You can delete configured response customizations using the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DeleteChatResponseConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_DeleteChatResponseConfiguration.html) API operation. If you're using the AWS Management Console, you can't reset the response customizations you have configured to default. The following tabs provide a procedure for the console and code examples for the AWS CLI.

------
#### [ Console ]

**To reset response customization settings to default**

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

1. In the navigation pane, choose **Applications**, and then select your application.

1. Choose **Enhancements** from the navigation menu, and then select **Response customization**.

1. From **Response customization**, choose **Edit**.

1. In **Edit response settings**, select **Reset to defaults**. This resets all existing customizations to the default used by Amazon Q Business.

1. Choose **Save** to apply your changes.

------
#### [ AWS CLI ]

**To delete a response configuration**

```
aws qbusiness delete-chat-response-configuration \
--application-id {{application-id}} \
--chat-response-configuration-id {{configuration-id}}
```

------

## Listing response customization settings
<a name="list-response-configurations"></a>

You can list all available response configurations for an application using the AWS Management Console or the [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_GetChatResponseConfiguration.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_GetChatResponseConfiguration.html) and [https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ListChatResponseConfigurations.html](https://docs.aws.amazon.com/amazonq/latest/api-reference/API_ListChatResponseConfigurations.html) API operations. The following tabs provide a procedure for the console and code examples for the AWS CLI.

------
#### [ Console ]

**To list response customization settings**

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

1. In the navigation pane, choose **Applications**, and then select your application.

1. Choose **Enhancements** from the navigation menu, and then select **Response customization**. You'll see a list of existing response customizations displayed on the page.

------
#### [ AWS CLI ]

**To list response configurations**

```
aws qbusiness get-chat-response-configuration \
--application-id {{application-id}} \
--chat-response-configuration-id {{chat-response-configuration-id}}
```

```
aws qbusiness list-chat-response-configurations \
--application-id {{application-id}} \
--max-results {{10}} \
--next-token {{next-token}}
```

------