Amazon Q in Connect: Deploy a Web Crawler Knowledge Base via the AWS CLI

Jun 17 2025 · 20min · aws draft

Amazon Connect is an amazing and complex service that allow us to create Contact Centers that fit our business need. AWS receantly release a new feature where we can create AI Agents that can help out our service agents to assist the clients, or even help them directly with the Self-Service feature. All thanks to the help of the Amazon Q service.

We can customize where the AI Agent can gather the information needed to properly assist. This source of information is called a Knowledge Base. Affortunately, Amazon Q in Connect provides us with different integration options to choose from. In this blog we are going to focus in the creation of the Web Crawler Knowledge Base (integration) using only the terminal and the AWS CLI.

Create the Integration

Create an agent assistant using the CreateAssistant API [1]:

aws qconnect create-assistant \
    --name $ASSISTANT_NAME \
    --type "AGENT" \
    --description $DESCRIPTION

NOTE: Keep in mind that you will need to change the values with the prefix $.

Create a managed knowledge base using the CreateKnowledgeBase API [2]:

aws qconnect create-knowledge-base \
    --knowledge-base-type MANAGED \
    --name $KB_NAME \
    --source-configuration file://source-config.json

The source-config.json is a file containing the web crawler information, including the URLs:

{
	"managedSourceConfiguration": {
		"webCrawlerConfiguration": {
			"crawlerLimits": {
				"rateLimit": 300
			},
			"urlConfiguration": {
				"seedUrls": [
					{ 
						"url": $URL
					}
				]	
			}
		}
	}
}

Create a knowledge base association using the CreateAssistantAssociation API [3]:

aws qconnect create-assistant-association \
	--assistant-id $ASSISTANT_ID \
	--association-type KNOWLEDGE_BASE \
	--association '{ "knowledgeBaseId": $KB_ID }'

Create the wisdom integration association using the CreateIntegrationAssociation API [4]:

aws connect create-integration-association \
	--instance-id $CONNECT_INSTANCE_ID \
	--integration-type WISDOM_ASSISTANT \
	--integration-arn $ASSISTANT_ARN

Associate the integration with the connect instance using the CreateIntegrationAssociation API [4]:

aws connect create-integration-association \
	--instance-id $CONNECT_INSTANCE_ID \
	--integration-type WISDOM_KNOWLEDGE_BASE \
	--integration-arn $KB_ARN

Amazon Q in Connect: Deploy a Web Crawler Knowledge Base via the AWS CLI

Create the Integration

Resources