Creating and selecting a retriever for an Amazon Q Business application
After creating your Amazon Q Business application environment, you create and select the retriever and provision the index that will power your generative AI web experience. The retriever pulls data from the index in real time during a conversation.
Amazon Q Business provides retrievers for Amazon Kendra indexes and also for a native index. You can choose between selecting an Amazon Q Business retriever and a Amazon Q Business native index or using an already configured Amazon Kendra index as a retriever.
To select a retriever, you use the AWS Management Console or the CreateRetriever API operation. If you use the console and choose to use a Amazon Q Business retriever, Amazon Q Business creates an index for you as part of the application environment configuration process. You can then configure provisioning for the created index.
For easy tracking, you can tag both the retriever and index. If you use the API to create a Amazon Q Business retriever, you must first use the CreateIndex API operation to create and provision an Amazon Q Business index, and then use CreateRetriever to create your Amazon Q retriever.
Important
You can't change the retriever or index type for your application environment after your application environmenthas been created. To change your retriever or index type, you must create a new application environment.
Note
The data sources and indexes available to connect to your application environment change depending on your retriever choice.
For instructions on how to select a retriever and an index, choose a topic based on your retriever preference for Amazon Q.
Creating an Amazon Q Business retriever
To select a Amazon Q Business retriever, you can use either the AWS Management Console, or the CreateIndex and CreateRetriever API operations.
The following tabs provide a procedure for the AWS Management Console and code examples for the AWS CLI.
Selecting an Amazon Kendra retriever
To select an existing Amazon Kendra retriever to your Amazon Q Business application environment, you can use the AWS Management Console or the CreateRetriever API operation.
If you use the API, you select and connect your Amazon Kendra retriever when
you use the CreateRetriever
API operation.
If you use the console, selecting and connecting an Amazon Kendra retriever is a two-step process. This topic provides instructions for the first step: Selecting an Amazon Kendra retriever. For instructions for the second step, see Connecting an Amazon Kendra retriever to an Amazon Q Business application.
Note
If you use an Amazon Kendra retriever, data in your Amazon Kendra will be connected to your Amazon Q Business application environment. If you choose this option, you can't use Amazon Q Business data connectors or direct document upload for your application environment.
For more information about Amazon Kendra, see the following topics in the Amazon Kendra User Guide and API Reference:
The following tabs provide a procedure for the AWS Management Console and code samples for the AWS CLI.