Amazon Q Data Accessor Integration
Overview
Karini AI integrates seamlessly with Amazon Q Business, enabling users to leverage the Amazon Q Index to build Agentic RAG applications. With this integration, you can build an agentic application using a variety of knowledgebases such as Amazon Q Index Retriever, Amazon Bedrock Knowledgebases and Karini’s Native Knowledgebase. The setup involves creating agent prompts, integrating them with Amazon Q Accessor Retriever tool, and publishing the final recipe for use in your chat application.
Prerequisites
An active AWS account.
Amazon Q Business application created.
IAM Identity Center (IDC) configured.
Access to Karini AI platform.
To initiate the integration, ensure that your Amazon Q Business application is provisioned and configured.
In the AWS Management Console
Create and configure an Amazon Q Business application by following the official Amazon Q Business documentation.
After configuring Amazon Q Business, integrate it within Karini AI to enable intelligent agents with secure, context-aware data access.
Note: Use your External Id from your Karini Organization page as Tenant Id while creating Karini AI Data Accessor in Amazon Q Business
In Karini AI
Configure Agent Prompt :Define the agent’s objective, query input, and execution parameters.
Navigate to Prompt > Add New.
Set the following:
Name (unique identifier)
Task: Agent
Max State Updates: 10 ( 3 default)
Prompt: Instruction defining the agent’s purpose
Agent Input: Sample query
Click Save.
After saving the prompt, the Tool tab will appear.

Add Amazon Q Accessor Retriever Tool: Add the Amazon Q Accessor Retriever tool within the agent prompt.
In the Tool Configuration tab, set:
Name: Provide a unique identifier for the tool configuration.
Description: Add a brief summary that outlines the tool’s purpose and how it supports the agent's behavior.
Tool Type: Select Amazon Q Accessor Retriever.
Application ID: Enter the Amazon Q Business Application ID associated with your deployment.
Retriever ID: Enter the unique Amazon Q Business retriever ID.
Application Region: Specify the AWS region where the Amazon Q Business application is hosted.
IDC Application ARN: Provide the ARN for the IAM Identity Center (IDC) client integrated with Amazon Q Business.
IDC Region: Enter the AWS region where the IAM Identity Center is configured.
Max Results: Set the maximum number of results to be retrieved per query.
Save the configuration.
Test and Publish: Validate the agent’s performance across models and publish the optimal configuration.
Navigate to Test and Compare.
Evaluate responses across models.
Select the best-performing answer.
Save and Publish the prompt.
Create Recipe: Design the conversational workflow by linking agent logic with interaction nodes.
Go to Recipes > Add New.
Set Runtime: Agent 2.0.
Enter Name and Description.
Add and connect the following nodes:
Chat Node (enable Citations and Follow-up Questions)
Start Node
Agent Node (select published prompt)
End Node
Click Save, then Publish.
Refer to the Karini AI Recipe Documentation for detailed flow guidance.

Export and Integrate with Copilot( Chat Assistant)
Export the recipe for Copilot integration. Refer to the Export Recipe documentation for interface design details.
Navigate to Copilot.
Click Authorize Amazon Q Index button.
The action redirects your AWS OIDC Provider via AWS Console.

Upon successful authentication, copilot is fully configured to retrieve data from Amazon Q Business . Users can submit queries related to Amazon Q Business data, and Copilot will efficiently process the requests and return relevant results. Additionally, the system displays detailed source information, ensuring transparency and context for each response.
Refer to detailed set up walkthrough in the following video.
Last updated