

# Working with scenarios in Amazon Quick Sight


Quick users with Admin Pro, Author Pro, or Reader Pro roles can use scenarios to analyze complex business problems with simple natural language.

To get started with scenarios, a Quick user describes a problem that they want to solve and adds relevant data from Quick Sight or from their computer to be used in the data analysis. Alternatively, users can let Amazon Q search for all relevant data that can be used to solve the problem. Amazon Q returns a series of analyses or prompts to dive deeper into the data. Users can also enter their own prompts to create a custom analysis. After a new prompt is received, Amazon Q breaks down the analysis into steps and executes them. Outputs include specific data insights, interactive visuals, and an analysis of what the findings might mean for the business with suggested next actions.

Scenarios can help Quick Pro users to perform the following tasks:
+ Automate tedious, error-prone, and inefficient manual data tasks
+ Modify, extend, or reuse past analyses to quickly adapt to business changes
+ Dive deeper into data than spreadsheets allow

Use the following topics to create and work with scenarios in Amazon Quick Sight.

**Topics**
+ [

## Considerations for Quick Sight scenarios
](#scenarios-considerations)
+ [

# Creating an Amazon Quick Sight scenario
](scenarios-create.md)
+ [

# Working with threads in an Amazon Quick Sight scenario
](scenarios-threads.md)
+ [

# Working with data in an Amazon Quick Sight scenario
](scenarios-data.md)

## Considerations for Quick Sight scenarios
Considerations

The following considerations apply to Amazon Quick Sight scenarios.
+ Amazon Quick Sight scenarios are available to users that have Admin Pro, Author Pro, or Reader Pro roles in Amazon Quick. For information about updating a user to a Quick Pro role, see [Get started with Generative BI](generative-bi-get-started.md).
+ Scenarios are available in specific AWS Regions listed in [Supported AWS Regions for Amazon Q in Quick](regions.md#regions-aqs).

After you review the considerations for Quick Sight scenarios, see [Creating an Amazon Quick Sight scenario](scenarios-create.md) to get started with scenarios in Amazon Quick Sight.

# Creating an Amazon Quick Sight scenario


Amazon Quick Pro users can create scenarios from Quick Sight dashboards, or from the **Scenarios** section on the Quick Sight home page. Users can create as many scenarios as they need. Each user can have up to 3 active scenarios at a time. Each Quick Sight account supports up to 10 active scenarios at a time. Use the following procedure to create a scenario in Amazon Quick Sight.

**Create a new scenario**

1. Open the [Quick console](https://quicksight.aws.amazon.com/).

1. Perform one of the following actions:

   1. Open any dashboard, and look for one of the following:
      + Choose **Analyze this dashboard in a Scenario**, if available, at the top of the dashboard.
      + From a visual on the dashboard, open the drop-down menu and choose **Explore scenario**.
      + Choose **Build**, and then choose **Scenario**.

   1. On the Quick home page, choose **Scenarios**. On the **Scenarios**, choose **New Scenario**.

1. The new scenario appears. In the text box, describe the problem that you want to solve. This input is the starting point for all of the data pivots and manipulations that will occur in the scenario. The description that you provide can be as broad or as specific as you want, for example "analyze usage trends" or “compute month-over-month and year-over-year changes in usage based on last month's data."

1. Add the data that you want to use in the scenario. You can choose data from Quick Sight dashboards, or you can upload files from your computer. When you choose data from a dashboard, a preview of the selected data is generated for you to review. For more information about previewing and editing data in Quick Sight scenarios, see [Working with data in an Amazon Quick Sight scenario](scenarios-data.md).

   The following limits apply to the data that is used in a scenario:
   + You can add up to 10 data sources to a scenario.
   + Up to 20 visuals can be selected from a dashboard at a time.
   + Uploaded files must be in `.xlsx` or `.csv` format and can't exceed 1 GB.
   + Data sources can have up to 200 columns.

   If you don't add data to the scenario, Amazon Q automatically searches your Quick Sight dashboards to find data related to your problem statement from the previous step.

1. Choose **Start analysis**.

When you start an analysis in a Quick Sight scenario, Quick Sight prepares your data for analysis and returns a new *thread*. The thread contains generated prompts that can be used to solve the problem that you described in the scenario. A thread is a turn based contextual conversation that consists of user prompts and Amazon Q responses that you can use to drill down on a specific scenario. You can use threads to write prompts that assume that Amazon Q remembers what was previously discussed in the thread. You can choose a prompt to continue the thread, or you can choose the plus sign (\$1) above the thread to start a new thread. The new thread uses a different prompt than the first thread that you created. For more information about working with threads, see [Working with threads in an Amazon Quick Sight scenario](scenarios-threads.md).

# Working with threads in an Amazon Quick Sight scenario


After you create a scenario in Quick Sight, the data that Amazon Q generates is presented in *threads* and *blocks*. A thread is a vertical chain of prompts and responses. A block is a single prompt and response pair. Each thread can contain up to 15 blocks, and each scenario can contain up to 50 blocks total across multiple threads.

When a new thread is created, a list of Amazon Q-generated prompts appears inside of a new block. When you choose one of the prompts to drill down on, Amazon Q analyzes the data that is relevant to the chosen prompt and returns a summary of all data findings, forecasts, and conclusions that can be drawn from the analysis.

To continue the thread and dive deeper into the prompt, choose the plus sign (**\$1**) located below the block to create a new block that contains a new list of generated prompts that factor in the findings from the previous block. To start a new thread that analyzes a different aspect of the data, choose the plus sign (**\$1**) above any block in the scenario to create a new thread. 

Blocks can be collapsed, duplicated, or deleted from a scenario, as long as the block that you want to change has finished loading. Use the following procedures to make changes to a scenario block.

**To collapse, duplicate, or delete a block**

1. Open the [Quick console](https://quicksight.aws.amazon.com/).

1. Choose **Scenarios** from the options pane, and then choose the scenario that you want to change.

1. Navigate to the block that you want to change and choose the ellipsis (…) in the top right of the block.

1. Perform one of the following actions:
   + To collapse the block, choose **Collapse**. To expand a collapsed block, choose the ellipsis in the top right of the block, and then choose **Expand**.
   + To duplicate the block, choose **Duplicate**. The block is duplicated and placed in a new thread next to the original block.
   + To delete the block, choose **Delete**.

You can also modify the prompt of a block to better match your use case. Use the following procedure to modify a block prompt.

**To modify the prompt of a block**

1. Open the [Quick console](https://quicksight.aws.amazon.com/).

1. Choose **Scenarios** from the options pane, and then choose the scenario that you want to change.

1. Navigate to the block that you want to change and choose **Modify block**.

1. In the **Modify block** popup that appears, enter a new description for the block, and then choose **Apply**.

After you modify a prompt, Amazon Q analyzes the data and returns a new generated analysis that reflects the changes that were made to the prompt.

# Working with data in an Amazon Quick Sight scenario


When you create a scenario in Amazon Quick Sight, you can preview and modify the data that the scenario uses to generate summaries. Use the following sections to learn about the ways Quick users can interact with data in a scenario.

**Topics**
+ [

## Adding more data to a scenario
](#scenarios-data-add-data)
+ [

## Editing data in a preview
](#scenarios-data-edit-preview)
+ [

## Editing data in a snapshot
](#scenarios-data-edit-snapshot)

## Adding more data to a scenario


After you create a scenario in Amazon Quick Sight, you can add more data to the scenario at any time. Use the following procedure to add data to an Amazon Quick Sight scenario.

**To add data to an existing Amazon Quick Sight scenario**

1. Open the [Quick console](https://quicksight.aws.amazon.com/).

1. Choose **Scenarios** from the options pane, and then choose the scenario that you want to add more data to.

1. Choose the **Data Source** icon in the actions bar to open the **Data** pane.

1. Perform one of the following actions:

   1. To add Quick Sight data to the scenario, choose **Find Data**, and then choose the dataset or dashboard visuals that you want to add to the scenario. After you have selected all of the Quick Sight data that you want to add to the scenario, choose **Add**.

   1. To upload a file from your computer to the scenario, choose **Upload File**.

   The following limits apply to the data that is added to a scenario:
   + You can add up to 10 data sources to a scenario.
   + Up to 20 visuals can be selected from a dashboard at a time.
   + Uploaded files must be in `.xlsx` or `.csv` format and can't exceed 1 GB.
   + Data sources can have up to 200 columns.

After you add new data to a scenario, Amazon Q includes the data in all new analyses.

## Editing data in a preview


When you choose data from a Quick Sight dashboard to be used in a scenario, a preview of the data is generated for review before it's added to the analysis. If needed, the following changes can be made to dashboard data in the preview state:
+ **Filters** – If you only want to analyze a subset of the available data or if you need to reduce the number of rows that are included in the scenario, you can apply filters to the data.
+ **Sort** – If the available data exceeds 1 million rows and you want to prioritize the retention of the values in a specific column, you can sort the data to fit your needs.

## Editing data in a snapshot


When you add dashboard or external data to a scenario, Quick Sight creates a snapshot of the data sources to be reviewed. To see a snapshot of the data used in a scenario, choose the **Data Source** icon in the actions bar. This opens the **Data** pane, and then you can choose the data snapshot that you want to review.

You can perform the following actions on a data snapshot:
+ To update the title of the data snapshot, choose the pencil icon next to the title and enter a new title for the snapshot.
+ Choose the **Filter** icon to filter the data that is used in the scenario. This option can be used if you want the scenario to only use a subset of the data that is added to the scenario.
+ Choose the **Sort** icon to sort the data that is used in the scenario. This option can be used to prioritize the retention of specific columns if the data exceeds 1 million rows.
+ Choose the **Fields list** icon to choose which fields are included in the scenario. This option can be used to control which columns are used in the scenario.

When you are finished updating the scenario data, close the **Data** pane.