2026/09/10 - Agents for Amazon Bedrock - 6 updated api methods
Changes TwelveLabs Marengo 3.0 is now an embedding model option in Amazon Bedrock Managed Knowledge Base. Create multimodal embeddings for video, audio, and image content that capture visual scenes, speech, and video cues, not just transcribed text.
{'vectorIngestionConfiguration': {'parsingConfiguration': {'parsingStrategy': {'MULTI_MODAL_EMBEDDINGS'}}}}
Response {'dataSource': {'vectorIngestionConfiguration': {'parsingConfiguration': {'parsingStrategy': {'MULTI_MODAL_EMBEDDINGS'}}}}}
Connects a knowledge base to a data source. You specify the configuration for the specific data source service in the dataSourceConfiguration field.
See also: AWS API Documentation
Request Syntax
client.create_data_source(
knowledgeBaseId='string',
clientToken='string',
name='string',
description='string',
dataSourceConfiguration={
'type': 'S3'|'WEB'|'CONFLUENCE'|'SALESFORCE'|'SHAREPOINT'|'CUSTOM'|'REDSHIFT_METADATA'|'MANAGED_KNOWLEDGE_BASE_CONNECTOR',
'managedKnowledgeBaseConnectorConfiguration': {
'deletionProtectionConfiguration': {
'deletionProtectionStatus': 'ENABLED'|'DISABLED',
'deletionProtectionThreshold': 123
},
'mediaExtractionConfiguration': {
'imageExtractionConfiguration': {
'imageExtractionStatus': 'ENABLED'|'DISABLED'
},
'audioExtractionConfiguration': {
'audioExtractionStatus': 'ENABLED'|'DISABLED'
},
'videoExtractionConfiguration': {
'videoExtractionStatus': 'ENABLED'|'DISABLED'
}
},
'connectorParameters': {...}|[...]|123|123.4|'string'|True|None,
'syncSchedule': {
'daily': {}
,
'weekly': {
'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
},
'monthly': {
'dayOfMonth': {
'dayNumber': 123,
'lastDayOfMonth': {}
}
}
}
},
's3Configuration': {
'bucketArn': 'string',
'inclusionPrefixes': [
'string',
],
'bucketOwnerAccountId': 'string'
},
'webConfiguration': {
'sourceConfiguration': {
'urlConfiguration': {
'seedUrls': [
{
'url': 'string'
},
]
}
},
'crawlerConfiguration': {
'crawlerLimits': {
'rateLimit': 123,
'maxPages': 123
},
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
],
'scope': 'HOST_ONLY'|'SUBDOMAINS',
'userAgent': 'string',
'userAgentHeader': 'string'
}
},
'confluenceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'hostType': 'SAAS',
'authType': 'BASIC'|'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'salesforceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'authType': 'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'sharePointConfiguration': {
'sourceConfiguration': {
'tenantId': 'string',
'domain': 'string',
'siteUrls': [
'string',
],
'hostType': 'ONLINE',
'authType': 'OAUTH2_CLIENT_CREDENTIALS'|'OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
}
},
dataDeletionPolicy='RETAIN'|'DELETE',
serverSideEncryptionConfiguration={
'kmsKeyArn': 'string'
},
vectorIngestionConfiguration={
'chunkingConfiguration': {
'chunkingStrategy': 'FIXED_SIZE'|'NONE'|'HIERARCHICAL'|'SEMANTIC',
'fixedSizeChunkingConfiguration': {
'maxTokens': 123,
'overlapPercentage': 123
},
'hierarchicalChunkingConfiguration': {
'levelConfigurations': [
{
'maxTokens': 123
},
],
'overlapTokens': 123
},
'semanticChunkingConfiguration': {
'maxTokens': 123,
'bufferSize': 123,
'breakpointPercentileThreshold': 123
}
},
'customTransformationConfiguration': {
'intermediateStorage': {
's3Location': {
'uri': 'string'
}
},
'transformations': [
{
'transformationFunction': {
'transformationLambdaConfiguration': {
'lambdaArn': 'string'
}
},
'stepToApply': 'POST_CHUNKING'
},
]
},
'parsingConfiguration': {
'parsingStrategy': 'BEDROCK_FOUNDATION_MODEL'|'BEDROCK_DATA_AUTOMATION'|'SMART_PARSING'|'MULTI_MODAL_EMBEDDINGS',
'bedrockFoundationModelConfiguration': {
'modelArn': 'string',
'parsingPrompt': {
'parsingPromptText': 'string'
},
'parsingModality': 'MULTIMODAL'
},
'bedrockDataAutomationConfiguration': {
'parsingModality': 'MULTIMODAL'
}
},
'contextEnrichmentConfiguration': {
'type': 'BEDROCK_FOUNDATION_MODEL',
'bedrockFoundationModelConfiguration': {
'enrichmentStrategyConfiguration': {
'method': 'CHUNK_ENTITY_EXTRACTION'
},
'modelArn': 'string'
}
}
}
)
string
[REQUIRED]
The unique identifier of the knowledge base to which to add the data source.
string
A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.
This field is autopopulated if not provided.
string
[REQUIRED]
The name of the data source.
string
A description of the data source.
dict
[REQUIRED]
The connection configuration for the data source.
type (string) -- [REQUIRED]
The type of data source.
managedKnowledgeBaseConnectorConfiguration (dict) --
Contains the configuration for a data source that connects a managed knowledge base to a supported data source connector. Specify this object when the data source type is MANAGED_KNOWLEDGE_BASE_CONNECTOR.
deletionProtectionConfiguration (dict) --
A safeguard against accidental bulk deletion of indexed content.
deletionProtectionStatus (string) -- [REQUIRED]
Enable or disable deletion protection for the connector.
deletionProtectionThreshold (integer) --
The threshold is the maximum percentage of documents that a sync job can delete from your index. If a sync would delete more than this percentage, the sync skips its delete phase, leaving your indexed documents in place. Not supported for the Custom connector.
mediaExtractionConfiguration (dict) --
Configuration for extracting media (images, audio, video) from data source files.
imageExtractionConfiguration (dict) --
Configuration for image extraction.
imageExtractionStatus (string) -- [REQUIRED]
Whether image extraction is enabled or disabled.
audioExtractionConfiguration (dict) --
Configuration for audio extraction.
audioExtractionStatus (string) -- [REQUIRED]
Whether audio extraction is enabled or disabled.
videoExtractionConfiguration (dict) --
Configuration for video extraction.
videoExtractionStatus (string) -- [REQUIRED]
Whether video extraction is enabled or disabled.
connectorParameters (:ref:`document<document>`) --
Connector-specific parameters. For more information, see Connect a data source.
syncSchedule (dict) --
The recurring schedule on which the connector automatically syncs this data source. If not specified, the data source is not synced automatically and you start each sync yourself. Not supported for the Custom connector.
daily (dict) --
A daily sync that runs once a day at a system-chosen off-peak time. The run time is not configurable.
weekly (dict) --
A weekly sync that runs once a week on the specified day of the week.
dayOfWeek (string) -- [REQUIRED]
The day of the week on which the weekly sync runs.
monthly (dict) --
A monthly sync that runs once a month on the specified day of the month.
dayOfMonth (dict) -- [REQUIRED]
The day of the month on which the monthly sync runs.
dayNumber (integer) --
A specific day of the month, from 1 to 28. Values are capped at 28, so a monthly sync runs in every month, including February.
lastDayOfMonth (dict) --
Set this option to run the monthly sync on the last calendar day of each month.
s3Configuration (dict) --
The configuration information to connect to Amazon S3 as your data source for self-managed knowledge bases. To configure this data source for managed knowledge bases, use managedKnowledgeBaseConnectorConfiguration.
bucketArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the S3 bucket that contains your data.
inclusionPrefixes (list) --
A list of S3 prefixes to include certain files or content. For more information, see Organizing objects using prefixes.
(string) --
bucketOwnerAccountId (string) --
The account ID for the owner of the S3 bucket.
webConfiguration (dict) --
The configuration of web URLs to crawl for your data source. You should be authorized to crawl the URLs.
sourceConfiguration (dict) -- [REQUIRED]
The source configuration details for the web data source.
urlConfiguration (dict) -- [REQUIRED]
The configuration of the URL/URLs.
seedUrls (list) --
One or more seed or starting point URLs.
(dict) --
The seed or starting point URL. You should be authorized to crawl the URL.
url (string) --
A seed or starting point URL.
crawlerConfiguration (dict) --
The Web Crawler configuration details for the web data source.
crawlerLimits (dict) --
The configuration of crawl limits for the web URLs.
rateLimit (integer) --
The max rate at which pages are crawled, up to 300 per minute per host.
maxPages (integer) --
The max number of web pages crawled from your source URLs, up to 25,000 pages. If the web pages exceed this limit, the data source sync will fail and no web pages will be ingested.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
scope (string) --
The scope of what is crawled for your URLs.
You can choose to crawl only web pages that belong to the same host or primary domain. For example, only web pages that contain the seed URL "https://docs.aws.amazon.com/bedrock/latest/userguide/" and no other domains. You can choose to include sub domains in addition to the host or primary domain. For example, web pages that contain "aws.amazon.com" can also include sub domain "docs.aws.amazon.com".
userAgent (string) --
Returns the user agent suffix for your web crawler.
userAgentHeader (string) --
A string used for identifying the crawler or bot when it accesses a web server. The user agent header value consists of the bedrockbot, UUID, and a user agent suffix for your crawler (if one is provided). By default, it is set to bedrockbot_UUID. You can optionally append a custom suffix to bedrockbot_UUID to allowlist a specific user agent permitted to access your source URLs.
confluenceConfiguration (dict) --
The configuration information to connect to Confluence as your data source for self-managed knowledge bases.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your Confluence data source.
hostUrl (string) -- [REQUIRED]
The Confluence host URL or instance URL.
hostType (string) -- [REQUIRED]
The supported host type, whether online/cloud or server/on-premises.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your Confluence instance.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Confluence instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Confluence connection configuration.
crawlerConfiguration (dict) --
The configuration of the Confluence content. For example, configuring specific types of Confluence content.
filterConfiguration (dict) --
The configuration of filtering the Confluence content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
salesforceConfiguration (dict) --
The configuration information to connect to Salesforce as your data source.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your Salesforce data source.
hostUrl (string) -- [REQUIRED]
The Salesforce host URL or instance URL.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your Salesforce instance.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Salesforce instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Salesforce connection configuration.
crawlerConfiguration (dict) --
The configuration of the Salesforce content. For example, configuring specific types of Salesforce content.
filterConfiguration (dict) --
The configuration of filtering the Salesforce content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
sharePointConfiguration (dict) --
The configuration information to connect to SharePoint as your data source for self-managed knowledge bases.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your SharePoint data source.
tenantId (string) --
The identifier of your Microsoft 365 tenant.
domain (string) -- [REQUIRED]
The domain of your SharePoint instance or site URL/URLs.
siteUrls (list) -- [REQUIRED]
A list of one or more SharePoint site URLs.
(string) --
hostType (string) -- [REQUIRED]
The supported host type, whether online/cloud or server/on-premises.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your SharePoint site/sites.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your SharePoint site/sites. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see SharePoint connection configuration.
crawlerConfiguration (dict) --
The configuration of the SharePoint content. For example, configuring specific types of SharePoint content.
filterConfiguration (dict) --
The configuration of filtering the SharePoint content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
string
The data deletion policy for the data source.
You can set the data deletion policy to:
DELETE: Deletes all data from your data source that’s converted into vector embeddings upon deletion of a knowledge base or data source resource. Note that the vector store itself is not deleted, only the data. This flag is ignored if an Amazon Web Services account is deleted.
RETAIN: Retains all data from your data source that’s converted into vector embeddings upon deletion of a knowledge base or data source resource. Note that the vector store itself is not deleted if you delete a knowledge base or data source resource.
dict
Contains details about the server-side encryption for the data source.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
dict
Contains details about how to ingest the documents in the data source.
chunkingConfiguration (dict) --
Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.
chunkingStrategy (string) -- [REQUIRED]
Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.
FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.
HIERARCHICAL – Split documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
SEMANTIC – Split documents into chunks based on groups of similar content derived with natural language processing.
NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.
fixedSizeChunkingConfiguration (dict) --
Configurations for when you choose fixed-size chunking. If you set the chunkingStrategy as NONE, exclude this field.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens to include in a chunk.
overlapPercentage (integer) -- [REQUIRED]
The percentage of overlap between adjacent chunks of a data source.
hierarchicalChunkingConfiguration (dict) --
Settings for hierarchical document chunking for a data source. Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
levelConfigurations (list) -- [REQUIRED]
Token settings for each layer.
(dict) --
Token settings for a layer in a hierarchical chunking configuration.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens that a chunk can contain in this layer.
overlapTokens (integer) -- [REQUIRED]
The number of tokens to repeat across chunks in the same layer.
semanticChunkingConfiguration (dict) --
Settings for semantic document chunking for a data source. Semantic chunking splits a document into into smaller documents based on groups of similar content derived from the text with natural language processing.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens that a chunk can contain.
bufferSize (integer) -- [REQUIRED]
The buffer size.
breakpointPercentileThreshold (integer) -- [REQUIRED]
The dissimilarity threshold for splitting chunks.
customTransformationConfiguration (dict) --
A custom document transformer for parsed data source documents.
intermediateStorage (dict) -- [REQUIRED]
An S3 bucket path for input and output objects.
s3Location (dict) -- [REQUIRED]
An S3 bucket path.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
transformations (list) -- [REQUIRED]
A Lambda function that processes documents.
(dict) --
A custom processing step for documents moving through a data source ingestion pipeline. To process documents after they have been converted into chunks, set the step to apply to POST_CHUNKING.
transformationFunction (dict) -- [REQUIRED]
A Lambda function that processes documents.
transformationLambdaConfiguration (dict) -- [REQUIRED]
The Lambda function.
lambdaArn (string) -- [REQUIRED]
The function's ARN identifier.
stepToApply (string) -- [REQUIRED]
When the service applies the transformation.
parsingConfiguration (dict) --
Configurations for a parser to use for parsing documents in your data source. If you exclude this field, the default parser will be used.
parsingStrategy (string) -- [REQUIRED]
The parsing strategy for the data source.
For managed knowledge bases, the strategy that you can select depends on the embedding model that your knowledge base uses:
If your knowledge base uses a native multimodal embedding model, specify MULTI_MODAL_EMBEDDINGS. With this strategy, files are sent directly to the embedding model instead of being parsed into text. This is the only strategy that is supported for these knowledge bases.
Otherwise, specify SMART_PARSING.
For more information, see Customize ingestion for managed knowledge bases.
bedrockFoundationModelConfiguration (dict) --
If you specify BEDROCK_FOUNDATION_MODEL as the parsing strategy for ingesting your data source, use this object to modify configurations for using a foundation model to parse documents.
modelArn (string) -- [REQUIRED]
The ARN of the foundation model to use for parsing.
parsingPrompt (dict) --
Instructions for interpreting the contents of a document.
parsingPromptText (string) -- [REQUIRED]
Instructions for interpreting the contents of a document.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
bedrockDataAutomationConfiguration (dict) --
If you specify BEDROCK_DATA_AUTOMATION as the parsing strategy for ingesting your data source, use this object to modify configurations for using the Amazon Bedrock Data Automation parser.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
contextEnrichmentConfiguration (dict) --
The context enrichment configuration used for ingestion of the data into the vector store.
type (string) -- [REQUIRED]
The method used for context enrichment. It must be Amazon Bedrock foundation models.
bedrockFoundationModelConfiguration (dict) --
The configuration of the Amazon Bedrock foundation model used for context enrichment.
enrichmentStrategyConfiguration (dict) -- [REQUIRED]
The enrichment stategy used to provide additional context. For example, Neptune GraphRAG uses Amazon Bedrock foundation models to perform chunk entity extraction.
method (string) -- [REQUIRED]
The method used for the context enrichment strategy.
modelArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
dict
Response Syntax
{
'dataSource': {
'knowledgeBaseId': 'string',
'dataSourceId': 'string',
'name': 'string',
'status': 'AVAILABLE'|'DELETING'|'DELETE_UNSUCCESSFUL'|'CREATING'|'UPDATING'|'FAILED',
'description': 'string',
'dataSourceConfiguration': {
'type': 'S3'|'WEB'|'CONFLUENCE'|'SALESFORCE'|'SHAREPOINT'|'CUSTOM'|'REDSHIFT_METADATA'|'MANAGED_KNOWLEDGE_BASE_CONNECTOR',
'managedKnowledgeBaseConnectorConfiguration': {
'deletionProtectionConfiguration': {
'deletionProtectionStatus': 'ENABLED'|'DISABLED',
'deletionProtectionThreshold': 123
},
'mediaExtractionConfiguration': {
'imageExtractionConfiguration': {
'imageExtractionStatus': 'ENABLED'|'DISABLED'
},
'audioExtractionConfiguration': {
'audioExtractionStatus': 'ENABLED'|'DISABLED'
},
'videoExtractionConfiguration': {
'videoExtractionStatus': 'ENABLED'|'DISABLED'
}
},
'connectorParameters': {...}|[...]|123|123.4|'string'|True|None,
'syncSchedule': {
'daily': {},
'weekly': {
'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
},
'monthly': {
'dayOfMonth': {
'dayNumber': 123,
'lastDayOfMonth': {}
}
}
}
},
's3Configuration': {
'bucketArn': 'string',
'inclusionPrefixes': [
'string',
],
'bucketOwnerAccountId': 'string'
},
'webConfiguration': {
'sourceConfiguration': {
'urlConfiguration': {
'seedUrls': [
{
'url': 'string'
},
]
}
},
'crawlerConfiguration': {
'crawlerLimits': {
'rateLimit': 123,
'maxPages': 123
},
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
],
'scope': 'HOST_ONLY'|'SUBDOMAINS',
'userAgent': 'string',
'userAgentHeader': 'string'
}
},
'confluenceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'hostType': 'SAAS',
'authType': 'BASIC'|'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'salesforceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'authType': 'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'sharePointConfiguration': {
'sourceConfiguration': {
'tenantId': 'string',
'domain': 'string',
'siteUrls': [
'string',
],
'hostType': 'ONLINE',
'authType': 'OAUTH2_CLIENT_CREDENTIALS'|'OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'vectorIngestionConfiguration': {
'chunkingConfiguration': {
'chunkingStrategy': 'FIXED_SIZE'|'NONE'|'HIERARCHICAL'|'SEMANTIC',
'fixedSizeChunkingConfiguration': {
'maxTokens': 123,
'overlapPercentage': 123
},
'hierarchicalChunkingConfiguration': {
'levelConfigurations': [
{
'maxTokens': 123
},
],
'overlapTokens': 123
},
'semanticChunkingConfiguration': {
'maxTokens': 123,
'bufferSize': 123,
'breakpointPercentileThreshold': 123
}
},
'customTransformationConfiguration': {
'intermediateStorage': {
's3Location': {
'uri': 'string'
}
},
'transformations': [
{
'transformationFunction': {
'transformationLambdaConfiguration': {
'lambdaArn': 'string'
}
},
'stepToApply': 'POST_CHUNKING'
},
]
},
'parsingConfiguration': {
'parsingStrategy': 'BEDROCK_FOUNDATION_MODEL'|'BEDROCK_DATA_AUTOMATION'|'SMART_PARSING'|'MULTI_MODAL_EMBEDDINGS',
'bedrockFoundationModelConfiguration': {
'modelArn': 'string',
'parsingPrompt': {
'parsingPromptText': 'string'
},
'parsingModality': 'MULTIMODAL'
},
'bedrockDataAutomationConfiguration': {
'parsingModality': 'MULTIMODAL'
}
},
'contextEnrichmentConfiguration': {
'type': 'BEDROCK_FOUNDATION_MODEL',
'bedrockFoundationModelConfiguration': {
'enrichmentStrategyConfiguration': {
'method': 'CHUNK_ENTITY_EXTRACTION'
},
'modelArn': 'string'
}
}
},
'dataDeletionPolicy': 'RETAIN'|'DELETE',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
dataSource (dict) --
Contains details about the data source.
knowledgeBaseId (string) --
The unique identifier of the knowledge base to which the data source belongs.
dataSourceId (string) --
The unique identifier of the data source.
name (string) --
The name of the data source.
status (string) --
The status of the data source. The following statuses are possible:
Available – The data source has been created and is ready for ingestion into the knowledge base.
Deleting – The data source is being deleted.
description (string) --
The description of the data source.
dataSourceConfiguration (dict) --
The connection configuration for the data source.
type (string) --
The type of data source.
managedKnowledgeBaseConnectorConfiguration (dict) --
Contains the configuration for a data source that connects a managed knowledge base to a supported data source connector. Specify this object when the data source type is MANAGED_KNOWLEDGE_BASE_CONNECTOR.
deletionProtectionConfiguration (dict) --
A safeguard against accidental bulk deletion of indexed content.
deletionProtectionStatus (string) --
Enable or disable deletion protection for the connector.
deletionProtectionThreshold (integer) --
The threshold is the maximum percentage of documents that a sync job can delete from your index. If a sync would delete more than this percentage, the sync skips its delete phase, leaving your indexed documents in place. Not supported for the Custom connector.
mediaExtractionConfiguration (dict) --
Configuration for extracting media (images, audio, video) from data source files.
imageExtractionConfiguration (dict) --
Configuration for image extraction.
imageExtractionStatus (string) --
Whether image extraction is enabled or disabled.
audioExtractionConfiguration (dict) --
Configuration for audio extraction.
audioExtractionStatus (string) --
Whether audio extraction is enabled or disabled.
videoExtractionConfiguration (dict) --
Configuration for video extraction.
videoExtractionStatus (string) --
Whether video extraction is enabled or disabled.
connectorParameters (:ref:`document<document>`) --
Connector-specific parameters. For more information, see Connect a data source.
syncSchedule (dict) --
The recurring schedule on which the connector automatically syncs this data source. If not specified, the data source is not synced automatically and you start each sync yourself. Not supported for the Custom connector.
daily (dict) --
A daily sync that runs once a day at a system-chosen off-peak time. The run time is not configurable.
weekly (dict) --
A weekly sync that runs once a week on the specified day of the week.
dayOfWeek (string) --
The day of the week on which the weekly sync runs.
monthly (dict) --
A monthly sync that runs once a month on the specified day of the month.
dayOfMonth (dict) --
The day of the month on which the monthly sync runs.
dayNumber (integer) --
A specific day of the month, from 1 to 28. Values are capped at 28, so a monthly sync runs in every month, including February.
lastDayOfMonth (dict) --
Set this option to run the monthly sync on the last calendar day of each month.
s3Configuration (dict) --
The configuration information to connect to Amazon S3 as your data source for self-managed knowledge bases. To configure this data source for managed knowledge bases, use managedKnowledgeBaseConnectorConfiguration.
bucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket that contains your data.
inclusionPrefixes (list) --
A list of S3 prefixes to include certain files or content. For more information, see Organizing objects using prefixes.
(string) --
bucketOwnerAccountId (string) --
The account ID for the owner of the S3 bucket.
webConfiguration (dict) --
The configuration of web URLs to crawl for your data source. You should be authorized to crawl the URLs.
sourceConfiguration (dict) --
The source configuration details for the web data source.
urlConfiguration (dict) --
The configuration of the URL/URLs.
seedUrls (list) --
One or more seed or starting point URLs.
(dict) --
The seed or starting point URL. You should be authorized to crawl the URL.
url (string) --
A seed or starting point URL.
crawlerConfiguration (dict) --
The Web Crawler configuration details for the web data source.
crawlerLimits (dict) --
The configuration of crawl limits for the web URLs.
rateLimit (integer) --
The max rate at which pages are crawled, up to 300 per minute per host.
maxPages (integer) --
The max number of web pages crawled from your source URLs, up to 25,000 pages. If the web pages exceed this limit, the data source sync will fail and no web pages will be ingested.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
scope (string) --
The scope of what is crawled for your URLs.
You can choose to crawl only web pages that belong to the same host or primary domain. For example, only web pages that contain the seed URL "https://docs.aws.amazon.com/bedrock/latest/userguide/" and no other domains. You can choose to include sub domains in addition to the host or primary domain. For example, web pages that contain "aws.amazon.com" can also include sub domain "docs.aws.amazon.com".
userAgent (string) --
Returns the user agent suffix for your web crawler.
userAgentHeader (string) --
A string used for identifying the crawler or bot when it accesses a web server. The user agent header value consists of the bedrockbot, UUID, and a user agent suffix for your crawler (if one is provided). By default, it is set to bedrockbot_UUID. You can optionally append a custom suffix to bedrockbot_UUID to allowlist a specific user agent permitted to access your source URLs.
confluenceConfiguration (dict) --
The configuration information to connect to Confluence as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your Confluence data source.
hostUrl (string) --
The Confluence host URL or instance URL.
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your Confluence instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Confluence instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Confluence connection configuration.
crawlerConfiguration (dict) --
The configuration of the Confluence content. For example, configuring specific types of Confluence content.
filterConfiguration (dict) --
The configuration of filtering the Confluence content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
salesforceConfiguration (dict) --
The configuration information to connect to Salesforce as your data source.
sourceConfiguration (dict) --
The endpoint information to connect to your Salesforce data source.
hostUrl (string) --
The Salesforce host URL or instance URL.
authType (string) --
The supported authentication type to authenticate and connect to your Salesforce instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Salesforce instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Salesforce connection configuration.
crawlerConfiguration (dict) --
The configuration of the Salesforce content. For example, configuring specific types of Salesforce content.
filterConfiguration (dict) --
The configuration of filtering the Salesforce content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
sharePointConfiguration (dict) --
The configuration information to connect to SharePoint as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your SharePoint data source.
tenantId (string) --
The identifier of your Microsoft 365 tenant.
domain (string) --
The domain of your SharePoint instance or site URL/URLs.
siteUrls (list) --
A list of one or more SharePoint site URLs.
(string) --
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your SharePoint site/sites.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your SharePoint site/sites. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see SharePoint connection configuration.
crawlerConfiguration (dict) --
The configuration of the SharePoint content. For example, configuring specific types of SharePoint content.
filterConfiguration (dict) --
The configuration of filtering the SharePoint content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
serverSideEncryptionConfiguration (dict) --
Contains details about the configuration of the server-side encryption.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
vectorIngestionConfiguration (dict) --
Contains details about how to ingest the documents in the data source.
chunkingConfiguration (dict) --
Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.
chunkingStrategy (string) --
Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.
FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.
HIERARCHICAL – Split documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
SEMANTIC – Split documents into chunks based on groups of similar content derived with natural language processing.
NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.
fixedSizeChunkingConfiguration (dict) --
Configurations for when you choose fixed-size chunking. If you set the chunkingStrategy as NONE, exclude this field.
maxTokens (integer) --
The maximum number of tokens to include in a chunk.
overlapPercentage (integer) --
The percentage of overlap between adjacent chunks of a data source.
hierarchicalChunkingConfiguration (dict) --
Settings for hierarchical document chunking for a data source. Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
levelConfigurations (list) --
Token settings for each layer.
(dict) --
Token settings for a layer in a hierarchical chunking configuration.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain in this layer.
overlapTokens (integer) --
The number of tokens to repeat across chunks in the same layer.
semanticChunkingConfiguration (dict) --
Settings for semantic document chunking for a data source. Semantic chunking splits a document into into smaller documents based on groups of similar content derived from the text with natural language processing.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain.
bufferSize (integer) --
The buffer size.
breakpointPercentileThreshold (integer) --
The dissimilarity threshold for splitting chunks.
customTransformationConfiguration (dict) --
A custom document transformer for parsed data source documents.
intermediateStorage (dict) --
An S3 bucket path for input and output objects.
s3Location (dict) --
An S3 bucket path.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
transformations (list) --
A Lambda function that processes documents.
(dict) --
A custom processing step for documents moving through a data source ingestion pipeline. To process documents after they have been converted into chunks, set the step to apply to POST_CHUNKING.
transformationFunction (dict) --
A Lambda function that processes documents.
transformationLambdaConfiguration (dict) --
The Lambda function.
lambdaArn (string) --
The function's ARN identifier.
stepToApply (string) --
When the service applies the transformation.
parsingConfiguration (dict) --
Configurations for a parser to use for parsing documents in your data source. If you exclude this field, the default parser will be used.
parsingStrategy (string) --
The parsing strategy for the data source.
For managed knowledge bases, the strategy that you can select depends on the embedding model that your knowledge base uses:
If your knowledge base uses a native multimodal embedding model, specify MULTI_MODAL_EMBEDDINGS. With this strategy, files are sent directly to the embedding model instead of being parsed into text. This is the only strategy that is supported for these knowledge bases.
Otherwise, specify SMART_PARSING.
For more information, see Customize ingestion for managed knowledge bases.
bedrockFoundationModelConfiguration (dict) --
If you specify BEDROCK_FOUNDATION_MODEL as the parsing strategy for ingesting your data source, use this object to modify configurations for using a foundation model to parse documents.
modelArn (string) --
The ARN of the foundation model to use for parsing.
parsingPrompt (dict) --
Instructions for interpreting the contents of a document.
parsingPromptText (string) --
Instructions for interpreting the contents of a document.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
bedrockDataAutomationConfiguration (dict) --
If you specify BEDROCK_DATA_AUTOMATION as the parsing strategy for ingesting your data source, use this object to modify configurations for using the Amazon Bedrock Data Automation parser.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
contextEnrichmentConfiguration (dict) --
The context enrichment configuration used for ingestion of the data into the vector store.
type (string) --
The method used for context enrichment. It must be Amazon Bedrock foundation models.
bedrockFoundationModelConfiguration (dict) --
The configuration of the Amazon Bedrock foundation model used for context enrichment.
enrichmentStrategyConfiguration (dict) --
The enrichment stategy used to provide additional context. For example, Neptune GraphRAG uses Amazon Bedrock foundation models to perform chunk entity extraction.
method (string) --
The method used for the context enrichment strategy.
modelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
dataDeletionPolicy (string) --
The data deletion policy for the data source.
createdAt (datetime) --
The time at which the data source was created.
updatedAt (datetime) --
The time at which the data source was last updated.
failureReasons (list) --
The detailed reasons on the failure to delete a data source.
(string) --
{'knowledgeBaseConfiguration': {'managedKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}},
'supplementalDataStorageConfiguration': {'storageLocations': [{'s3Location': {'uri': 'string'},
'type': 'S3'}]}},
'vectorKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}}}}}
Response {'knowledgeBase': {'knowledgeBaseConfiguration': {'managedKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}},
'supplementalDataStorageConfiguration': {'storageLocations': [{'s3Location': {'uri': 'string'},
'type': 'S3'}]}},
'vectorKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}}}}}}
Creates a knowledge base. A knowledge base contains your data sources so that Large Language Models (LLMs) can use your data. To create a knowledge base, you must first set up your data sources and configure a supported vector store. For more information, see Set up a knowledge base.
Provide the name and an optional description.
Provide the Amazon Resource Name (ARN) with permissions to create a knowledge base in the roleArn field.
For managed knowledge bases, set embeddingModelType to MANAGED to use the service-managed embedding model, or CUSTOM with an embeddingModelArn to use your own. To use your own KMS key for encryption, provide the ARN in serverSideEncryptionConfiguration. No vector store configuration is required for managed knowledge bases.
For self-managed knowledge bases, provide the embedding model to use in the embeddingModelArn field in the knowledgeBaseConfiguration object.
For self-managed knowledge bases, provide the configuration for your vector store in the storageConfiguration object.
For an Amazon OpenSearch Service database, use the opensearchServerlessConfiguration object. For more information, see Create a vector store in Amazon OpenSearch Service.
For an Amazon Aurora database, use the RdsConfiguration object. For more information, see Create a vector store in Amazon Aurora.
For a Pinecone database, use the pineconeConfiguration object. For more information, see Create a vector store in Pinecone.
For a Redis Enterprise Cloud database, use the redisEnterpriseCloudConfiguration object. For more information, see Create a vector store in Redis Enterprise Cloud.
See also: AWS API Documentation
Request Syntax
client.create_knowledge_base(
clientToken='string',
name='string',
description='string',
roleArn='string',
knowledgeBaseConfiguration={
'type': 'VECTOR'|'KENDRA'|'SQL'|'MANAGED',
'vectorKnowledgeBaseConfiguration': {
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'managedKnowledgeBaseConfiguration': {
'embeddingModelType': 'CUSTOM'|'MANAGED',
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'kendraKnowledgeBaseConfiguration': {
'kendraIndexArn': 'string'
},
'sqlKnowledgeBaseConfiguration': {
'type': 'REDSHIFT',
'redshiftConfiguration': {
'storageConfigurations': [
{
'type': 'REDSHIFT'|'AWS_DATA_CATALOG',
'awsDataCatalogConfiguration': {
'tableNames': [
'string',
]
},
'redshiftConfiguration': {
'databaseName': 'string'
}
},
],
'queryEngineConfiguration': {
'type': 'SERVERLESS'|'PROVISIONED',
'serverlessConfiguration': {
'workgroupArn': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD',
'usernamePasswordSecretArn': 'string'
}
},
'provisionedConfiguration': {
'clusterIdentifier': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD'|'USERNAME',
'databaseUser': 'string',
'usernamePasswordSecretArn': 'string'
}
}
},
'queryGenerationConfiguration': {
'executionTimeoutSeconds': 123,
'generationContext': {
'tables': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE',
'columns': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE'
},
]
},
],
'curatedQueries': [
{
'naturalLanguage': 'string',
'sql': 'string'
},
]
}
}
}
}
},
storageConfiguration={
'type': 'OPENSEARCH_SERVERLESS'|'PINECONE'|'REDIS_ENTERPRISE_CLOUD'|'RDS'|'MONGO_DB_ATLAS'|'NEPTUNE_ANALYTICS'|'OPENSEARCH_MANAGED_CLUSTER'|'S3_VECTORS',
'opensearchServerlessConfiguration': {
'collectionArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'opensearchManagedClusterConfiguration': {
'domainEndpoint': 'string',
'domainArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'pineconeConfiguration': {
'connectionString': 'string',
'credentialsSecretArn': 'string',
'namespace': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
'redisEnterpriseCloudConfiguration': {
'endpoint': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'rdsConfiguration': {
'resourceArn': 'string',
'credentialsSecretArn': 'string',
'databaseName': 'string',
'tableName': 'string',
'fieldMapping': {
'primaryKeyField': 'string',
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string',
'customMetadataField': 'string'
}
},
'mongoDbAtlasConfiguration': {
'endpoint': 'string',
'databaseName': 'string',
'collectionName': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
},
'endpointServiceName': 'string',
'textIndexName': 'string'
},
'neptuneAnalyticsConfiguration': {
'graphArn': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
's3VectorsConfiguration': {
'vectorBucketArn': 'string',
'indexArn': 'string',
'indexName': 'string'
}
},
tags={
'string': 'string'
}
)
string
A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see Ensuring idempotency.
This field is autopopulated if not provided.
string
[REQUIRED]
A name for the knowledge base.
string
A description of the knowledge base.
string
[REQUIRED]
The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the knowledge base.
dict
[REQUIRED]
Contains details about the embeddings model used for the knowledge base.
type (string) -- [REQUIRED]
The type of data that the data source is converted into for the knowledge base. Choose MANAGED to create a managed knowledge base.
vectorKnowledgeBaseConfiguration (dict) --
Contains details about the model that's used to convert the data source into vector embeddings.
embeddingModelArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
embeddingModelConfiguration (dict) --
The embeddings model configuration details for the vector model used in Knowledge Base.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
supplementalDataStorageConfiguration (dict) --
If you include multimodal data from your data source, use this object to specify configurations for the storage location of the images extracted from your documents. These images can be retrieved and returned to the end user. They can also be used in generation when using RetrieveAndGenerate.
storageLocations (list) -- [REQUIRED]
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) -- [REQUIRED]
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
managedKnowledgeBaseConfiguration (dict) --
Contains configuration details for a knowledge base that uses a vector store fully managed by Amazon Bedrock. Specify this object when the knowledge base type is MANAGED.
embeddingModelType (string) --
Choose CUSTOM to provide your own Bedrock embedding model ARN. Choose MANAGED to use a service-managed embedding model.
embeddingModelArn (string) --
The ARN for the embeddings model.
embeddingModelConfiguration (dict) --
The configuration details for the embeddings model. Not required when choosing the MANAGED embeddingModelType.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
serverSideEncryptionConfiguration (dict) --
Contains the configuration for server-side encryption for your managed knowledge base.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
supplementalDataStorageConfiguration (dict) --
Use this object to specify the Amazon S3 location that the knowledge base uses to process and ingest multimodal content. This field is required when you use a native multimodal embedding model.
storageLocations (list) -- [REQUIRED]
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) -- [REQUIRED]
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
kendraKnowledgeBaseConfiguration (dict) --
Settings for an Amazon Kendra knowledge base.
kendraIndexArn (string) -- [REQUIRED]
The ARN of the Amazon Kendra index.
sqlKnowledgeBaseConfiguration (dict) --
Specifies configurations for a knowledge base connected to an SQL database.
type (string) -- [REQUIRED]
The type of SQL database to connect to the knowledge base.
redshiftConfiguration (dict) --
Specifies configurations for a knowledge base connected to an Amazon Redshift database.
storageConfigurations (list) -- [REQUIRED]
Specifies configurations for Amazon Redshift database storage.
(dict) --
Contains configurations for Amazon Redshift data storage. Specify the data storage service to use in the type field and include the corresponding field. For more information, see Build a knowledge base by connecting to a structured data source in the Amazon Bedrock User Guide.
type (string) -- [REQUIRED]
The data storage service to use.
awsDataCatalogConfiguration (dict) --
Specifies configurations for storage in Glue Data Catalog.
tableNames (list) -- [REQUIRED]
A list of names of the tables to use.
(string) --
redshiftConfiguration (dict) --
Specifies configurations for storage in Amazon Redshift.
databaseName (string) -- [REQUIRED]
The name of the Amazon Redshift database.
queryEngineConfiguration (dict) -- [REQUIRED]
Specifies configurations for an Amazon Redshift query engine.
type (string) -- [REQUIRED]
The type of query engine.
serverlessConfiguration (dict) --
Specifies configurations for a serverless Amazon Redshift query engine.
workgroupArn (string) -- [REQUIRED]
The ARN of the Amazon Redshift workgroup.
authConfiguration (dict) -- [REQUIRED]
Specifies configurations for authentication to an Amazon Redshift provisioned data warehouse.
type (string) -- [REQUIRED]
The type of authentication to use.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
provisionedConfiguration (dict) --
Specifies configurations for a provisioned Amazon Redshift query engine.
clusterIdentifier (string) -- [REQUIRED]
The ID of the Amazon Redshift cluster.
authConfiguration (dict) -- [REQUIRED]
Specifies configurations for authentication to Amazon Redshift.
type (string) -- [REQUIRED]
The type of authentication to use.
databaseUser (string) --
The database username for authentication to an Amazon Redshift provisioned data warehouse.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
queryGenerationConfiguration (dict) --
Specifies configurations for generating queries.
executionTimeoutSeconds (integer) --
The time after which query generation will time out.
generationContext (dict) --
Specifies configurations for context to use during query generation.
tables (list) --
An array of objects, each of which defines information about a table in the database.
(dict) --
Contains information about a table for the query engine to consider.
name (string) -- [REQUIRED]
The name of the table for which the other fields in this object apply.
description (string) --
A description of the table that helps the query engine understand the contents of the table.
inclusion (string) --
Specifies whether to include or exclude the table during query generation. If you specify EXCLUDE, the table will be ignored. If you specify INCLUDE, all other tables will be ignored.
columns (list) --
An array of objects, each of which defines information about a column in the table.
(dict) --
Contains information about a column in the current table for the query engine to consider.
name (string) --
The name of the column for which the other fields in this object apply.
description (string) --
A description of the column that helps the query engine understand the contents of the column.
inclusion (string) --
Specifies whether to include or exclude the column during query generation. If you specify EXCLUDE, the column will be ignored. If you specify INCLUDE, all other columns in the table will be ignored.
curatedQueries (list) --
An array of objects, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
(dict) --
Contains configurations for a query, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
naturalLanguage (string) -- [REQUIRED]
An example natural language query.
sql (string) -- [REQUIRED]
The SQL equivalent of the natural language query.
dict
Contains details about the configuration of the vector database used for the knowledge base.
type (string) -- [REQUIRED]
The vector store service in which the knowledge base is stored.
opensearchServerlessConfiguration (dict) --
Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.
collectionArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the OpenSearch Service vector store.
vectorIndexName (string) -- [REQUIRED]
The name of the vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
opensearchManagedClusterConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in OpenSearch Managed Cluster. For more information, see Create a vector index in Amazon OpenSearch Service.
domainEndpoint (string) -- [REQUIRED]
The endpoint URL the OpenSearch domain.
domainArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the OpenSearch domain.
vectorIndexName (string) -- [REQUIRED]
The name of the vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
pineconeConfiguration (dict) --
Contains the storage configuration of the knowledge base in Pinecone.
connectionString (string) -- [REQUIRED]
The endpoint URL for your index management page.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Pinecone API key.
namespace (string) --
The namespace to be used to write new data to your database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
redisEnterpriseCloudConfiguration (dict) --
Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.
endpoint (string) -- [REQUIRED]
The endpoint URL of the Redis Enterprise Cloud database.
vectorIndexName (string) -- [REQUIRED]
The name of the vector index.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
rdsConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see Create a vector index in Amazon RDS.
resourceArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the vector store.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.
databaseName (string) -- [REQUIRED]
The name of your Amazon RDS database.
tableName (string) -- [REQUIRED]
The name of the table in the database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
primaryKeyField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the ID for each entry.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
customMetadataField (string) --
Provide a name for the universal metadata field where Amazon Bedrock will store any custom metadata from your data source.
mongoDbAtlasConfiguration (dict) --
Contains the storage configuration of the knowledge base in MongoDB Atlas.
endpoint (string) -- [REQUIRED]
The endpoint URL of your MongoDB Atlas cluster for your knowledge base.
databaseName (string) -- [REQUIRED]
The database name in your MongoDB Atlas cluster for your knowledge base.
collectionName (string) -- [REQUIRED]
The collection name of the knowledge base in MongoDB Atlas.
vectorIndexName (string) -- [REQUIRED]
The name of the MongoDB Atlas vector search index.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that contains user credentials for your MongoDB Atlas cluster.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
endpointServiceName (string) --
The name of the VPC endpoint service in your account that is connected to your MongoDB Atlas cluster.
textIndexName (string) --
The name of the text search index in the MongoDB collection. This is required for using the hybrid search feature.
neptuneAnalyticsConfiguration (dict) --
Contains details about the Neptune Analytics configuration of the knowledge base in Amazon Neptune. For more information, see Create a vector index in Amazon Neptune Analytics..
graphArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the Neptune Analytics vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
s3VectorsConfiguration (dict) --
The configuration settings for storing knowledge base data using S3 vectors. This includes vector index information and S3 bucket details for vector storage.
vectorBucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket where vector embeddings are stored. This bucket contains the vector data used by the knowledge base.
indexArn (string) --
The Amazon Resource Name (ARN) of the vector index used for the knowledge base. This ARN identifies the specific vector index resource within Amazon Bedrock.
indexName (string) --
The name of the vector index used for the knowledge base. This name identifies the vector index within the Amazon Bedrock service.
dict
Specify the key-value pairs for the tags that you want to attach to your knowledge base in this object.
(string) --
(string) --
dict
Response Syntax
{
'knowledgeBase': {
'knowledgeBaseId': 'string',
'name': 'string',
'knowledgeBaseArn': 'string',
'description': 'string',
'roleArn': 'string',
'knowledgeBaseConfiguration': {
'type': 'VECTOR'|'KENDRA'|'SQL'|'MANAGED',
'vectorKnowledgeBaseConfiguration': {
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'managedKnowledgeBaseConfiguration': {
'embeddingModelType': 'CUSTOM'|'MANAGED',
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'kendraKnowledgeBaseConfiguration': {
'kendraIndexArn': 'string'
},
'sqlKnowledgeBaseConfiguration': {
'type': 'REDSHIFT',
'redshiftConfiguration': {
'storageConfigurations': [
{
'type': 'REDSHIFT'|'AWS_DATA_CATALOG',
'awsDataCatalogConfiguration': {
'tableNames': [
'string',
]
},
'redshiftConfiguration': {
'databaseName': 'string'
}
},
],
'queryEngineConfiguration': {
'type': 'SERVERLESS'|'PROVISIONED',
'serverlessConfiguration': {
'workgroupArn': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD',
'usernamePasswordSecretArn': 'string'
}
},
'provisionedConfiguration': {
'clusterIdentifier': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD'|'USERNAME',
'databaseUser': 'string',
'usernamePasswordSecretArn': 'string'
}
}
},
'queryGenerationConfiguration': {
'executionTimeoutSeconds': 123,
'generationContext': {
'tables': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE',
'columns': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE'
},
]
},
],
'curatedQueries': [
{
'naturalLanguage': 'string',
'sql': 'string'
},
]
}
}
}
}
},
'storageConfiguration': {
'type': 'OPENSEARCH_SERVERLESS'|'PINECONE'|'REDIS_ENTERPRISE_CLOUD'|'RDS'|'MONGO_DB_ATLAS'|'NEPTUNE_ANALYTICS'|'OPENSEARCH_MANAGED_CLUSTER'|'S3_VECTORS',
'opensearchServerlessConfiguration': {
'collectionArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'opensearchManagedClusterConfiguration': {
'domainEndpoint': 'string',
'domainArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'pineconeConfiguration': {
'connectionString': 'string',
'credentialsSecretArn': 'string',
'namespace': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
'redisEnterpriseCloudConfiguration': {
'endpoint': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'rdsConfiguration': {
'resourceArn': 'string',
'credentialsSecretArn': 'string',
'databaseName': 'string',
'tableName': 'string',
'fieldMapping': {
'primaryKeyField': 'string',
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string',
'customMetadataField': 'string'
}
},
'mongoDbAtlasConfiguration': {
'endpoint': 'string',
'databaseName': 'string',
'collectionName': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
},
'endpointServiceName': 'string',
'textIndexName': 'string'
},
'neptuneAnalyticsConfiguration': {
'graphArn': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
's3VectorsConfiguration': {
'vectorBucketArn': 'string',
'indexArn': 'string',
'indexName': 'string'
}
},
'status': 'CREATING'|'ACTIVE'|'DELETING'|'UPDATING'|'FAILED'|'DELETE_UNSUCCESSFUL'|'UPDATE_UNSUCCESSFUL',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
knowledgeBase (dict) --
Contains details about the knowledge base.
knowledgeBaseId (string) --
The unique identifier of the knowledge base.
name (string) --
The name of the knowledge base.
knowledgeBaseArn (string) --
The Amazon Resource Name (ARN) of the knowledge base.
description (string) --
The description of the knowledge base.
roleArn (string) --
The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the knowledge base.
knowledgeBaseConfiguration (dict) --
Contains details about the embeddings configuration of the knowledge base.
type (string) --
The type of data that the data source is converted into for the knowledge base. Choose MANAGED to create a managed knowledge base.
vectorKnowledgeBaseConfiguration (dict) --
Contains details about the model that's used to convert the data source into vector embeddings.
embeddingModelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
embeddingModelConfiguration (dict) --
The embeddings model configuration details for the vector model used in Knowledge Base.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
supplementalDataStorageConfiguration (dict) --
If you include multimodal data from your data source, use this object to specify configurations for the storage location of the images extracted from your documents. These images can be retrieved and returned to the end user. They can also be used in generation when using RetrieveAndGenerate.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
managedKnowledgeBaseConfiguration (dict) --
Contains configuration details for a knowledge base that uses a vector store fully managed by Amazon Bedrock. Specify this object when the knowledge base type is MANAGED.
embeddingModelType (string) --
Choose CUSTOM to provide your own Bedrock embedding model ARN. Choose MANAGED to use a service-managed embedding model.
embeddingModelArn (string) --
The ARN for the embeddings model.
embeddingModelConfiguration (dict) --
The configuration details for the embeddings model. Not required when choosing the MANAGED embeddingModelType.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
serverSideEncryptionConfiguration (dict) --
Contains the configuration for server-side encryption for your managed knowledge base.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
supplementalDataStorageConfiguration (dict) --
Use this object to specify the Amazon S3 location that the knowledge base uses to process and ingest multimodal content. This field is required when you use a native multimodal embedding model.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
kendraKnowledgeBaseConfiguration (dict) --
Settings for an Amazon Kendra knowledge base.
kendraIndexArn (string) --
The ARN of the Amazon Kendra index.
sqlKnowledgeBaseConfiguration (dict) --
Specifies configurations for a knowledge base connected to an SQL database.
type (string) --
The type of SQL database to connect to the knowledge base.
redshiftConfiguration (dict) --
Specifies configurations for a knowledge base connected to an Amazon Redshift database.
storageConfigurations (list) --
Specifies configurations for Amazon Redshift database storage.
(dict) --
Contains configurations for Amazon Redshift data storage. Specify the data storage service to use in the type field and include the corresponding field. For more information, see Build a knowledge base by connecting to a structured data source in the Amazon Bedrock User Guide.
type (string) --
The data storage service to use.
awsDataCatalogConfiguration (dict) --
Specifies configurations for storage in Glue Data Catalog.
tableNames (list) --
A list of names of the tables to use.
(string) --
redshiftConfiguration (dict) --
Specifies configurations for storage in Amazon Redshift.
databaseName (string) --
The name of the Amazon Redshift database.
queryEngineConfiguration (dict) --
Specifies configurations for an Amazon Redshift query engine.
type (string) --
The type of query engine.
serverlessConfiguration (dict) --
Specifies configurations for a serverless Amazon Redshift query engine.
workgroupArn (string) --
The ARN of the Amazon Redshift workgroup.
authConfiguration (dict) --
Specifies configurations for authentication to an Amazon Redshift provisioned data warehouse.
type (string) --
The type of authentication to use.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
provisionedConfiguration (dict) --
Specifies configurations for a provisioned Amazon Redshift query engine.
clusterIdentifier (string) --
The ID of the Amazon Redshift cluster.
authConfiguration (dict) --
Specifies configurations for authentication to Amazon Redshift.
type (string) --
The type of authentication to use.
databaseUser (string) --
The database username for authentication to an Amazon Redshift provisioned data warehouse.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
queryGenerationConfiguration (dict) --
Specifies configurations for generating queries.
executionTimeoutSeconds (integer) --
The time after which query generation will time out.
generationContext (dict) --
Specifies configurations for context to use during query generation.
tables (list) --
An array of objects, each of which defines information about a table in the database.
(dict) --
Contains information about a table for the query engine to consider.
name (string) --
The name of the table for which the other fields in this object apply.
description (string) --
A description of the table that helps the query engine understand the contents of the table.
inclusion (string) --
Specifies whether to include or exclude the table during query generation. If you specify EXCLUDE, the table will be ignored. If you specify INCLUDE, all other tables will be ignored.
columns (list) --
An array of objects, each of which defines information about a column in the table.
(dict) --
Contains information about a column in the current table for the query engine to consider.
name (string) --
The name of the column for which the other fields in this object apply.
description (string) --
A description of the column that helps the query engine understand the contents of the column.
inclusion (string) --
Specifies whether to include or exclude the column during query generation. If you specify EXCLUDE, the column will be ignored. If you specify INCLUDE, all other columns in the table will be ignored.
curatedQueries (list) --
An array of objects, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
(dict) --
Contains configurations for a query, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
naturalLanguage (string) --
An example natural language query.
sql (string) --
The SQL equivalent of the natural language query.
storageConfiguration (dict) --
Contains details about the storage configuration of the knowledge base.
type (string) --
The vector store service in which the knowledge base is stored.
opensearchServerlessConfiguration (dict) --
Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.
collectionArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch Service vector store.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
opensearchManagedClusterConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in OpenSearch Managed Cluster. For more information, see Create a vector index in Amazon OpenSearch Service.
domainEndpoint (string) --
The endpoint URL the OpenSearch domain.
domainArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch domain.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
pineconeConfiguration (dict) --
Contains the storage configuration of the knowledge base in Pinecone.
connectionString (string) --
The endpoint URL for your index management page.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Pinecone API key.
namespace (string) --
The namespace to be used to write new data to your database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
redisEnterpriseCloudConfiguration (dict) --
Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.
endpoint (string) --
The endpoint URL of the Redis Enterprise Cloud database.
vectorIndexName (string) --
The name of the vector index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
rdsConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see Create a vector index in Amazon RDS.
resourceArn (string) --
The Amazon Resource Name (ARN) of the vector store.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.
databaseName (string) --
The name of your Amazon RDS database.
tableName (string) --
The name of the table in the database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
primaryKeyField (string) --
The name of the field in which Amazon Bedrock stores the ID for each entry.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
customMetadataField (string) --
Provide a name for the universal metadata field where Amazon Bedrock will store any custom metadata from your data source.
mongoDbAtlasConfiguration (dict) --
Contains the storage configuration of the knowledge base in MongoDB Atlas.
endpoint (string) --
The endpoint URL of your MongoDB Atlas cluster for your knowledge base.
databaseName (string) --
The database name in your MongoDB Atlas cluster for your knowledge base.
collectionName (string) --
The collection name of the knowledge base in MongoDB Atlas.
vectorIndexName (string) --
The name of the MongoDB Atlas vector search index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that contains user credentials for your MongoDB Atlas cluster.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
endpointServiceName (string) --
The name of the VPC endpoint service in your account that is connected to your MongoDB Atlas cluster.
textIndexName (string) --
The name of the text search index in the MongoDB collection. This is required for using the hybrid search feature.
neptuneAnalyticsConfiguration (dict) --
Contains details about the Neptune Analytics configuration of the knowledge base in Amazon Neptune. For more information, see Create a vector index in Amazon Neptune Analytics..
graphArn (string) --
The Amazon Resource Name (ARN) of the Neptune Analytics vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
s3VectorsConfiguration (dict) --
The configuration settings for storing knowledge base data using S3 vectors. This includes vector index information and S3 bucket details for vector storage.
vectorBucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket where vector embeddings are stored. This bucket contains the vector data used by the knowledge base.
indexArn (string) --
The Amazon Resource Name (ARN) of the vector index used for the knowledge base. This ARN identifies the specific vector index resource within Amazon Bedrock.
indexName (string) --
The name of the vector index used for the knowledge base. This name identifies the vector index within the Amazon Bedrock service.
status (string) --
The status of the knowledge base. The following statuses are possible:
CREATING – The knowledge base is being created.
ACTIVE – The knowledge base is ready to be queried.
DELETING – The knowledge base is being deleted.
UPDATING – The knowledge base is being updated.
FAILED – The knowledge base API operation failed.
createdAt (datetime) --
The time the knowledge base was created.
updatedAt (datetime) --
The time the knowledge base was last updated.
failureReasons (list) --
A list of reasons that the API operation on the knowledge base failed.
(string) --
{'dataSource': {'vectorIngestionConfiguration': {'parsingConfiguration': {'parsingStrategy': {'MULTI_MODAL_EMBEDDINGS'}}}}}
Gets information about a data source.
See also: AWS API Documentation
Request Syntax
client.get_data_source(
knowledgeBaseId='string',
dataSourceId='string'
)
string
[REQUIRED]
The unique identifier of the knowledge base for the data source.
string
[REQUIRED]
The unique identifier of the data source.
dict
Response Syntax
{
'dataSource': {
'knowledgeBaseId': 'string',
'dataSourceId': 'string',
'name': 'string',
'status': 'AVAILABLE'|'DELETING'|'DELETE_UNSUCCESSFUL'|'CREATING'|'UPDATING'|'FAILED',
'description': 'string',
'dataSourceConfiguration': {
'type': 'S3'|'WEB'|'CONFLUENCE'|'SALESFORCE'|'SHAREPOINT'|'CUSTOM'|'REDSHIFT_METADATA'|'MANAGED_KNOWLEDGE_BASE_CONNECTOR',
'managedKnowledgeBaseConnectorConfiguration': {
'deletionProtectionConfiguration': {
'deletionProtectionStatus': 'ENABLED'|'DISABLED',
'deletionProtectionThreshold': 123
},
'mediaExtractionConfiguration': {
'imageExtractionConfiguration': {
'imageExtractionStatus': 'ENABLED'|'DISABLED'
},
'audioExtractionConfiguration': {
'audioExtractionStatus': 'ENABLED'|'DISABLED'
},
'videoExtractionConfiguration': {
'videoExtractionStatus': 'ENABLED'|'DISABLED'
}
},
'connectorParameters': {...}|[...]|123|123.4|'string'|True|None,
'syncSchedule': {
'daily': {},
'weekly': {
'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
},
'monthly': {
'dayOfMonth': {
'dayNumber': 123,
'lastDayOfMonth': {}
}
}
}
},
's3Configuration': {
'bucketArn': 'string',
'inclusionPrefixes': [
'string',
],
'bucketOwnerAccountId': 'string'
},
'webConfiguration': {
'sourceConfiguration': {
'urlConfiguration': {
'seedUrls': [
{
'url': 'string'
},
]
}
},
'crawlerConfiguration': {
'crawlerLimits': {
'rateLimit': 123,
'maxPages': 123
},
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
],
'scope': 'HOST_ONLY'|'SUBDOMAINS',
'userAgent': 'string',
'userAgentHeader': 'string'
}
},
'confluenceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'hostType': 'SAAS',
'authType': 'BASIC'|'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'salesforceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'authType': 'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'sharePointConfiguration': {
'sourceConfiguration': {
'tenantId': 'string',
'domain': 'string',
'siteUrls': [
'string',
],
'hostType': 'ONLINE',
'authType': 'OAUTH2_CLIENT_CREDENTIALS'|'OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'vectorIngestionConfiguration': {
'chunkingConfiguration': {
'chunkingStrategy': 'FIXED_SIZE'|'NONE'|'HIERARCHICAL'|'SEMANTIC',
'fixedSizeChunkingConfiguration': {
'maxTokens': 123,
'overlapPercentage': 123
},
'hierarchicalChunkingConfiguration': {
'levelConfigurations': [
{
'maxTokens': 123
},
],
'overlapTokens': 123
},
'semanticChunkingConfiguration': {
'maxTokens': 123,
'bufferSize': 123,
'breakpointPercentileThreshold': 123
}
},
'customTransformationConfiguration': {
'intermediateStorage': {
's3Location': {
'uri': 'string'
}
},
'transformations': [
{
'transformationFunction': {
'transformationLambdaConfiguration': {
'lambdaArn': 'string'
}
},
'stepToApply': 'POST_CHUNKING'
},
]
},
'parsingConfiguration': {
'parsingStrategy': 'BEDROCK_FOUNDATION_MODEL'|'BEDROCK_DATA_AUTOMATION'|'SMART_PARSING'|'MULTI_MODAL_EMBEDDINGS',
'bedrockFoundationModelConfiguration': {
'modelArn': 'string',
'parsingPrompt': {
'parsingPromptText': 'string'
},
'parsingModality': 'MULTIMODAL'
},
'bedrockDataAutomationConfiguration': {
'parsingModality': 'MULTIMODAL'
}
},
'contextEnrichmentConfiguration': {
'type': 'BEDROCK_FOUNDATION_MODEL',
'bedrockFoundationModelConfiguration': {
'enrichmentStrategyConfiguration': {
'method': 'CHUNK_ENTITY_EXTRACTION'
},
'modelArn': 'string'
}
}
},
'dataDeletionPolicy': 'RETAIN'|'DELETE',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
dataSource (dict) --
Contains details about the data source.
knowledgeBaseId (string) --
The unique identifier of the knowledge base to which the data source belongs.
dataSourceId (string) --
The unique identifier of the data source.
name (string) --
The name of the data source.
status (string) --
The status of the data source. The following statuses are possible:
Available – The data source has been created and is ready for ingestion into the knowledge base.
Deleting – The data source is being deleted.
description (string) --
The description of the data source.
dataSourceConfiguration (dict) --
The connection configuration for the data source.
type (string) --
The type of data source.
managedKnowledgeBaseConnectorConfiguration (dict) --
Contains the configuration for a data source that connects a managed knowledge base to a supported data source connector. Specify this object when the data source type is MANAGED_KNOWLEDGE_BASE_CONNECTOR.
deletionProtectionConfiguration (dict) --
A safeguard against accidental bulk deletion of indexed content.
deletionProtectionStatus (string) --
Enable or disable deletion protection for the connector.
deletionProtectionThreshold (integer) --
The threshold is the maximum percentage of documents that a sync job can delete from your index. If a sync would delete more than this percentage, the sync skips its delete phase, leaving your indexed documents in place. Not supported for the Custom connector.
mediaExtractionConfiguration (dict) --
Configuration for extracting media (images, audio, video) from data source files.
imageExtractionConfiguration (dict) --
Configuration for image extraction.
imageExtractionStatus (string) --
Whether image extraction is enabled or disabled.
audioExtractionConfiguration (dict) --
Configuration for audio extraction.
audioExtractionStatus (string) --
Whether audio extraction is enabled or disabled.
videoExtractionConfiguration (dict) --
Configuration for video extraction.
videoExtractionStatus (string) --
Whether video extraction is enabled or disabled.
connectorParameters (:ref:`document<document>`) --
Connector-specific parameters. For more information, see Connect a data source.
syncSchedule (dict) --
The recurring schedule on which the connector automatically syncs this data source. If not specified, the data source is not synced automatically and you start each sync yourself. Not supported for the Custom connector.
daily (dict) --
A daily sync that runs once a day at a system-chosen off-peak time. The run time is not configurable.
weekly (dict) --
A weekly sync that runs once a week on the specified day of the week.
dayOfWeek (string) --
The day of the week on which the weekly sync runs.
monthly (dict) --
A monthly sync that runs once a month on the specified day of the month.
dayOfMonth (dict) --
The day of the month on which the monthly sync runs.
dayNumber (integer) --
A specific day of the month, from 1 to 28. Values are capped at 28, so a monthly sync runs in every month, including February.
lastDayOfMonth (dict) --
Set this option to run the monthly sync on the last calendar day of each month.
s3Configuration (dict) --
The configuration information to connect to Amazon S3 as your data source for self-managed knowledge bases. To configure this data source for managed knowledge bases, use managedKnowledgeBaseConnectorConfiguration.
bucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket that contains your data.
inclusionPrefixes (list) --
A list of S3 prefixes to include certain files or content. For more information, see Organizing objects using prefixes.
(string) --
bucketOwnerAccountId (string) --
The account ID for the owner of the S3 bucket.
webConfiguration (dict) --
The configuration of web URLs to crawl for your data source. You should be authorized to crawl the URLs.
sourceConfiguration (dict) --
The source configuration details for the web data source.
urlConfiguration (dict) --
The configuration of the URL/URLs.
seedUrls (list) --
One or more seed or starting point URLs.
(dict) --
The seed or starting point URL. You should be authorized to crawl the URL.
url (string) --
A seed or starting point URL.
crawlerConfiguration (dict) --
The Web Crawler configuration details for the web data source.
crawlerLimits (dict) --
The configuration of crawl limits for the web URLs.
rateLimit (integer) --
The max rate at which pages are crawled, up to 300 per minute per host.
maxPages (integer) --
The max number of web pages crawled from your source URLs, up to 25,000 pages. If the web pages exceed this limit, the data source sync will fail and no web pages will be ingested.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
scope (string) --
The scope of what is crawled for your URLs.
You can choose to crawl only web pages that belong to the same host or primary domain. For example, only web pages that contain the seed URL "https://docs.aws.amazon.com/bedrock/latest/userguide/" and no other domains. You can choose to include sub domains in addition to the host or primary domain. For example, web pages that contain "aws.amazon.com" can also include sub domain "docs.aws.amazon.com".
userAgent (string) --
Returns the user agent suffix for your web crawler.
userAgentHeader (string) --
A string used for identifying the crawler or bot when it accesses a web server. The user agent header value consists of the bedrockbot, UUID, and a user agent suffix for your crawler (if one is provided). By default, it is set to bedrockbot_UUID. You can optionally append a custom suffix to bedrockbot_UUID to allowlist a specific user agent permitted to access your source URLs.
confluenceConfiguration (dict) --
The configuration information to connect to Confluence as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your Confluence data source.
hostUrl (string) --
The Confluence host URL or instance URL.
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your Confluence instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Confluence instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Confluence connection configuration.
crawlerConfiguration (dict) --
The configuration of the Confluence content. For example, configuring specific types of Confluence content.
filterConfiguration (dict) --
The configuration of filtering the Confluence content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
salesforceConfiguration (dict) --
The configuration information to connect to Salesforce as your data source.
sourceConfiguration (dict) --
The endpoint information to connect to your Salesforce data source.
hostUrl (string) --
The Salesforce host URL or instance URL.
authType (string) --
The supported authentication type to authenticate and connect to your Salesforce instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Salesforce instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Salesforce connection configuration.
crawlerConfiguration (dict) --
The configuration of the Salesforce content. For example, configuring specific types of Salesforce content.
filterConfiguration (dict) --
The configuration of filtering the Salesforce content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
sharePointConfiguration (dict) --
The configuration information to connect to SharePoint as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your SharePoint data source.
tenantId (string) --
The identifier of your Microsoft 365 tenant.
domain (string) --
The domain of your SharePoint instance or site URL/URLs.
siteUrls (list) --
A list of one or more SharePoint site URLs.
(string) --
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your SharePoint site/sites.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your SharePoint site/sites. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see SharePoint connection configuration.
crawlerConfiguration (dict) --
The configuration of the SharePoint content. For example, configuring specific types of SharePoint content.
filterConfiguration (dict) --
The configuration of filtering the SharePoint content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
serverSideEncryptionConfiguration (dict) --
Contains details about the configuration of the server-side encryption.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
vectorIngestionConfiguration (dict) --
Contains details about how to ingest the documents in the data source.
chunkingConfiguration (dict) --
Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.
chunkingStrategy (string) --
Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.
FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.
HIERARCHICAL – Split documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
SEMANTIC – Split documents into chunks based on groups of similar content derived with natural language processing.
NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.
fixedSizeChunkingConfiguration (dict) --
Configurations for when you choose fixed-size chunking. If you set the chunkingStrategy as NONE, exclude this field.
maxTokens (integer) --
The maximum number of tokens to include in a chunk.
overlapPercentage (integer) --
The percentage of overlap between adjacent chunks of a data source.
hierarchicalChunkingConfiguration (dict) --
Settings for hierarchical document chunking for a data source. Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
levelConfigurations (list) --
Token settings for each layer.
(dict) --
Token settings for a layer in a hierarchical chunking configuration.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain in this layer.
overlapTokens (integer) --
The number of tokens to repeat across chunks in the same layer.
semanticChunkingConfiguration (dict) --
Settings for semantic document chunking for a data source. Semantic chunking splits a document into into smaller documents based on groups of similar content derived from the text with natural language processing.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain.
bufferSize (integer) --
The buffer size.
breakpointPercentileThreshold (integer) --
The dissimilarity threshold for splitting chunks.
customTransformationConfiguration (dict) --
A custom document transformer for parsed data source documents.
intermediateStorage (dict) --
An S3 bucket path for input and output objects.
s3Location (dict) --
An S3 bucket path.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
transformations (list) --
A Lambda function that processes documents.
(dict) --
A custom processing step for documents moving through a data source ingestion pipeline. To process documents after they have been converted into chunks, set the step to apply to POST_CHUNKING.
transformationFunction (dict) --
A Lambda function that processes documents.
transformationLambdaConfiguration (dict) --
The Lambda function.
lambdaArn (string) --
The function's ARN identifier.
stepToApply (string) --
When the service applies the transformation.
parsingConfiguration (dict) --
Configurations for a parser to use for parsing documents in your data source. If you exclude this field, the default parser will be used.
parsingStrategy (string) --
The parsing strategy for the data source.
For managed knowledge bases, the strategy that you can select depends on the embedding model that your knowledge base uses:
If your knowledge base uses a native multimodal embedding model, specify MULTI_MODAL_EMBEDDINGS. With this strategy, files are sent directly to the embedding model instead of being parsed into text. This is the only strategy that is supported for these knowledge bases.
Otherwise, specify SMART_PARSING.
For more information, see Customize ingestion for managed knowledge bases.
bedrockFoundationModelConfiguration (dict) --
If you specify BEDROCK_FOUNDATION_MODEL as the parsing strategy for ingesting your data source, use this object to modify configurations for using a foundation model to parse documents.
modelArn (string) --
The ARN of the foundation model to use for parsing.
parsingPrompt (dict) --
Instructions for interpreting the contents of a document.
parsingPromptText (string) --
Instructions for interpreting the contents of a document.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
bedrockDataAutomationConfiguration (dict) --
If you specify BEDROCK_DATA_AUTOMATION as the parsing strategy for ingesting your data source, use this object to modify configurations for using the Amazon Bedrock Data Automation parser.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
contextEnrichmentConfiguration (dict) --
The context enrichment configuration used for ingestion of the data into the vector store.
type (string) --
The method used for context enrichment. It must be Amazon Bedrock foundation models.
bedrockFoundationModelConfiguration (dict) --
The configuration of the Amazon Bedrock foundation model used for context enrichment.
enrichmentStrategyConfiguration (dict) --
The enrichment stategy used to provide additional context. For example, Neptune GraphRAG uses Amazon Bedrock foundation models to perform chunk entity extraction.
method (string) --
The method used for the context enrichment strategy.
modelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
dataDeletionPolicy (string) --
The data deletion policy for the data source.
createdAt (datetime) --
The time at which the data source was created.
updatedAt (datetime) --
The time at which the data source was last updated.
failureReasons (list) --
The detailed reasons on the failure to delete a data source.
(string) --
{'knowledgeBase': {'knowledgeBaseConfiguration': {'managedKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}},
'supplementalDataStorageConfiguration': {'storageLocations': [{'s3Location': {'uri': 'string'},
'type': 'S3'}]}},
'vectorKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}}}}}}
Gets information about a knowledge base.
See also: AWS API Documentation
Request Syntax
client.get_knowledge_base(
knowledgeBaseId='string'
)
string
[REQUIRED]
The unique identifier of the knowledge base you want to get information on.
dict
Response Syntax
{
'knowledgeBase': {
'knowledgeBaseId': 'string',
'name': 'string',
'knowledgeBaseArn': 'string',
'description': 'string',
'roleArn': 'string',
'knowledgeBaseConfiguration': {
'type': 'VECTOR'|'KENDRA'|'SQL'|'MANAGED',
'vectorKnowledgeBaseConfiguration': {
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'managedKnowledgeBaseConfiguration': {
'embeddingModelType': 'CUSTOM'|'MANAGED',
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'kendraKnowledgeBaseConfiguration': {
'kendraIndexArn': 'string'
},
'sqlKnowledgeBaseConfiguration': {
'type': 'REDSHIFT',
'redshiftConfiguration': {
'storageConfigurations': [
{
'type': 'REDSHIFT'|'AWS_DATA_CATALOG',
'awsDataCatalogConfiguration': {
'tableNames': [
'string',
]
},
'redshiftConfiguration': {
'databaseName': 'string'
}
},
],
'queryEngineConfiguration': {
'type': 'SERVERLESS'|'PROVISIONED',
'serverlessConfiguration': {
'workgroupArn': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD',
'usernamePasswordSecretArn': 'string'
}
},
'provisionedConfiguration': {
'clusterIdentifier': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD'|'USERNAME',
'databaseUser': 'string',
'usernamePasswordSecretArn': 'string'
}
}
},
'queryGenerationConfiguration': {
'executionTimeoutSeconds': 123,
'generationContext': {
'tables': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE',
'columns': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE'
},
]
},
],
'curatedQueries': [
{
'naturalLanguage': 'string',
'sql': 'string'
},
]
}
}
}
}
},
'storageConfiguration': {
'type': 'OPENSEARCH_SERVERLESS'|'PINECONE'|'REDIS_ENTERPRISE_CLOUD'|'RDS'|'MONGO_DB_ATLAS'|'NEPTUNE_ANALYTICS'|'OPENSEARCH_MANAGED_CLUSTER'|'S3_VECTORS',
'opensearchServerlessConfiguration': {
'collectionArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'opensearchManagedClusterConfiguration': {
'domainEndpoint': 'string',
'domainArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'pineconeConfiguration': {
'connectionString': 'string',
'credentialsSecretArn': 'string',
'namespace': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
'redisEnterpriseCloudConfiguration': {
'endpoint': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'rdsConfiguration': {
'resourceArn': 'string',
'credentialsSecretArn': 'string',
'databaseName': 'string',
'tableName': 'string',
'fieldMapping': {
'primaryKeyField': 'string',
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string',
'customMetadataField': 'string'
}
},
'mongoDbAtlasConfiguration': {
'endpoint': 'string',
'databaseName': 'string',
'collectionName': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
},
'endpointServiceName': 'string',
'textIndexName': 'string'
},
'neptuneAnalyticsConfiguration': {
'graphArn': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
's3VectorsConfiguration': {
'vectorBucketArn': 'string',
'indexArn': 'string',
'indexName': 'string'
}
},
'status': 'CREATING'|'ACTIVE'|'DELETING'|'UPDATING'|'FAILED'|'DELETE_UNSUCCESSFUL'|'UPDATE_UNSUCCESSFUL',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
knowledgeBase (dict) --
Contains details about the knowledge base.
knowledgeBaseId (string) --
The unique identifier of the knowledge base.
name (string) --
The name of the knowledge base.
knowledgeBaseArn (string) --
The Amazon Resource Name (ARN) of the knowledge base.
description (string) --
The description of the knowledge base.
roleArn (string) --
The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the knowledge base.
knowledgeBaseConfiguration (dict) --
Contains details about the embeddings configuration of the knowledge base.
type (string) --
The type of data that the data source is converted into for the knowledge base. Choose MANAGED to create a managed knowledge base.
vectorKnowledgeBaseConfiguration (dict) --
Contains details about the model that's used to convert the data source into vector embeddings.
embeddingModelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
embeddingModelConfiguration (dict) --
The embeddings model configuration details for the vector model used in Knowledge Base.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
supplementalDataStorageConfiguration (dict) --
If you include multimodal data from your data source, use this object to specify configurations for the storage location of the images extracted from your documents. These images can be retrieved and returned to the end user. They can also be used in generation when using RetrieveAndGenerate.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
managedKnowledgeBaseConfiguration (dict) --
Contains configuration details for a knowledge base that uses a vector store fully managed by Amazon Bedrock. Specify this object when the knowledge base type is MANAGED.
embeddingModelType (string) --
Choose CUSTOM to provide your own Bedrock embedding model ARN. Choose MANAGED to use a service-managed embedding model.
embeddingModelArn (string) --
The ARN for the embeddings model.
embeddingModelConfiguration (dict) --
The configuration details for the embeddings model. Not required when choosing the MANAGED embeddingModelType.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
serverSideEncryptionConfiguration (dict) --
Contains the configuration for server-side encryption for your managed knowledge base.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
supplementalDataStorageConfiguration (dict) --
Use this object to specify the Amazon S3 location that the knowledge base uses to process and ingest multimodal content. This field is required when you use a native multimodal embedding model.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
kendraKnowledgeBaseConfiguration (dict) --
Settings for an Amazon Kendra knowledge base.
kendraIndexArn (string) --
The ARN of the Amazon Kendra index.
sqlKnowledgeBaseConfiguration (dict) --
Specifies configurations for a knowledge base connected to an SQL database.
type (string) --
The type of SQL database to connect to the knowledge base.
redshiftConfiguration (dict) --
Specifies configurations for a knowledge base connected to an Amazon Redshift database.
storageConfigurations (list) --
Specifies configurations for Amazon Redshift database storage.
(dict) --
Contains configurations for Amazon Redshift data storage. Specify the data storage service to use in the type field and include the corresponding field. For more information, see Build a knowledge base by connecting to a structured data source in the Amazon Bedrock User Guide.
type (string) --
The data storage service to use.
awsDataCatalogConfiguration (dict) --
Specifies configurations for storage in Glue Data Catalog.
tableNames (list) --
A list of names of the tables to use.
(string) --
redshiftConfiguration (dict) --
Specifies configurations for storage in Amazon Redshift.
databaseName (string) --
The name of the Amazon Redshift database.
queryEngineConfiguration (dict) --
Specifies configurations for an Amazon Redshift query engine.
type (string) --
The type of query engine.
serverlessConfiguration (dict) --
Specifies configurations for a serverless Amazon Redshift query engine.
workgroupArn (string) --
The ARN of the Amazon Redshift workgroup.
authConfiguration (dict) --
Specifies configurations for authentication to an Amazon Redshift provisioned data warehouse.
type (string) --
The type of authentication to use.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
provisionedConfiguration (dict) --
Specifies configurations for a provisioned Amazon Redshift query engine.
clusterIdentifier (string) --
The ID of the Amazon Redshift cluster.
authConfiguration (dict) --
Specifies configurations for authentication to Amazon Redshift.
type (string) --
The type of authentication to use.
databaseUser (string) --
The database username for authentication to an Amazon Redshift provisioned data warehouse.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
queryGenerationConfiguration (dict) --
Specifies configurations for generating queries.
executionTimeoutSeconds (integer) --
The time after which query generation will time out.
generationContext (dict) --
Specifies configurations for context to use during query generation.
tables (list) --
An array of objects, each of which defines information about a table in the database.
(dict) --
Contains information about a table for the query engine to consider.
name (string) --
The name of the table for which the other fields in this object apply.
description (string) --
A description of the table that helps the query engine understand the contents of the table.
inclusion (string) --
Specifies whether to include or exclude the table during query generation. If you specify EXCLUDE, the table will be ignored. If you specify INCLUDE, all other tables will be ignored.
columns (list) --
An array of objects, each of which defines information about a column in the table.
(dict) --
Contains information about a column in the current table for the query engine to consider.
name (string) --
The name of the column for which the other fields in this object apply.
description (string) --
A description of the column that helps the query engine understand the contents of the column.
inclusion (string) --
Specifies whether to include or exclude the column during query generation. If you specify EXCLUDE, the column will be ignored. If you specify INCLUDE, all other columns in the table will be ignored.
curatedQueries (list) --
An array of objects, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
(dict) --
Contains configurations for a query, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
naturalLanguage (string) --
An example natural language query.
sql (string) --
The SQL equivalent of the natural language query.
storageConfiguration (dict) --
Contains details about the storage configuration of the knowledge base.
type (string) --
The vector store service in which the knowledge base is stored.
opensearchServerlessConfiguration (dict) --
Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.
collectionArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch Service vector store.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
opensearchManagedClusterConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in OpenSearch Managed Cluster. For more information, see Create a vector index in Amazon OpenSearch Service.
domainEndpoint (string) --
The endpoint URL the OpenSearch domain.
domainArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch domain.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
pineconeConfiguration (dict) --
Contains the storage configuration of the knowledge base in Pinecone.
connectionString (string) --
The endpoint URL for your index management page.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Pinecone API key.
namespace (string) --
The namespace to be used to write new data to your database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
redisEnterpriseCloudConfiguration (dict) --
Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.
endpoint (string) --
The endpoint URL of the Redis Enterprise Cloud database.
vectorIndexName (string) --
The name of the vector index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
rdsConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see Create a vector index in Amazon RDS.
resourceArn (string) --
The Amazon Resource Name (ARN) of the vector store.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.
databaseName (string) --
The name of your Amazon RDS database.
tableName (string) --
The name of the table in the database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
primaryKeyField (string) --
The name of the field in which Amazon Bedrock stores the ID for each entry.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
customMetadataField (string) --
Provide a name for the universal metadata field where Amazon Bedrock will store any custom metadata from your data source.
mongoDbAtlasConfiguration (dict) --
Contains the storage configuration of the knowledge base in MongoDB Atlas.
endpoint (string) --
The endpoint URL of your MongoDB Atlas cluster for your knowledge base.
databaseName (string) --
The database name in your MongoDB Atlas cluster for your knowledge base.
collectionName (string) --
The collection name of the knowledge base in MongoDB Atlas.
vectorIndexName (string) --
The name of the MongoDB Atlas vector search index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that contains user credentials for your MongoDB Atlas cluster.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
endpointServiceName (string) --
The name of the VPC endpoint service in your account that is connected to your MongoDB Atlas cluster.
textIndexName (string) --
The name of the text search index in the MongoDB collection. This is required for using the hybrid search feature.
neptuneAnalyticsConfiguration (dict) --
Contains details about the Neptune Analytics configuration of the knowledge base in Amazon Neptune. For more information, see Create a vector index in Amazon Neptune Analytics..
graphArn (string) --
The Amazon Resource Name (ARN) of the Neptune Analytics vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
s3VectorsConfiguration (dict) --
The configuration settings for storing knowledge base data using S3 vectors. This includes vector index information and S3 bucket details for vector storage.
vectorBucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket where vector embeddings are stored. This bucket contains the vector data used by the knowledge base.
indexArn (string) --
The Amazon Resource Name (ARN) of the vector index used for the knowledge base. This ARN identifies the specific vector index resource within Amazon Bedrock.
indexName (string) --
The name of the vector index used for the knowledge base. This name identifies the vector index within the Amazon Bedrock service.
status (string) --
The status of the knowledge base. The following statuses are possible:
CREATING – The knowledge base is being created.
ACTIVE – The knowledge base is ready to be queried.
DELETING – The knowledge base is being deleted.
UPDATING – The knowledge base is being updated.
FAILED – The knowledge base API operation failed.
createdAt (datetime) --
The time the knowledge base was created.
updatedAt (datetime) --
The time the knowledge base was last updated.
failureReasons (list) --
A list of reasons that the API operation on the knowledge base failed.
(string) --
{'vectorIngestionConfiguration': {'parsingConfiguration': {'parsingStrategy': {'MULTI_MODAL_EMBEDDINGS'}}}}
Response {'dataSource': {'vectorIngestionConfiguration': {'parsingConfiguration': {'parsingStrategy': {'MULTI_MODAL_EMBEDDINGS'}}}}}
Updates the configurations for a data source connector.
See also: AWS API Documentation
Request Syntax
client.update_data_source(
knowledgeBaseId='string',
dataSourceId='string',
name='string',
description='string',
dataSourceConfiguration={
'type': 'S3'|'WEB'|'CONFLUENCE'|'SALESFORCE'|'SHAREPOINT'|'CUSTOM'|'REDSHIFT_METADATA'|'MANAGED_KNOWLEDGE_BASE_CONNECTOR',
'managedKnowledgeBaseConnectorConfiguration': {
'deletionProtectionConfiguration': {
'deletionProtectionStatus': 'ENABLED'|'DISABLED',
'deletionProtectionThreshold': 123
},
'mediaExtractionConfiguration': {
'imageExtractionConfiguration': {
'imageExtractionStatus': 'ENABLED'|'DISABLED'
},
'audioExtractionConfiguration': {
'audioExtractionStatus': 'ENABLED'|'DISABLED'
},
'videoExtractionConfiguration': {
'videoExtractionStatus': 'ENABLED'|'DISABLED'
}
},
'connectorParameters': {...}|[...]|123|123.4|'string'|True|None,
'syncSchedule': {
'daily': {}
,
'weekly': {
'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
},
'monthly': {
'dayOfMonth': {
'dayNumber': 123,
'lastDayOfMonth': {}
}
}
}
},
's3Configuration': {
'bucketArn': 'string',
'inclusionPrefixes': [
'string',
],
'bucketOwnerAccountId': 'string'
},
'webConfiguration': {
'sourceConfiguration': {
'urlConfiguration': {
'seedUrls': [
{
'url': 'string'
},
]
}
},
'crawlerConfiguration': {
'crawlerLimits': {
'rateLimit': 123,
'maxPages': 123
},
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
],
'scope': 'HOST_ONLY'|'SUBDOMAINS',
'userAgent': 'string',
'userAgentHeader': 'string'
}
},
'confluenceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'hostType': 'SAAS',
'authType': 'BASIC'|'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'salesforceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'authType': 'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'sharePointConfiguration': {
'sourceConfiguration': {
'tenantId': 'string',
'domain': 'string',
'siteUrls': [
'string',
],
'hostType': 'ONLINE',
'authType': 'OAUTH2_CLIENT_CREDENTIALS'|'OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
}
},
dataDeletionPolicy='RETAIN'|'DELETE',
serverSideEncryptionConfiguration={
'kmsKeyArn': 'string'
},
vectorIngestionConfiguration={
'chunkingConfiguration': {
'chunkingStrategy': 'FIXED_SIZE'|'NONE'|'HIERARCHICAL'|'SEMANTIC',
'fixedSizeChunkingConfiguration': {
'maxTokens': 123,
'overlapPercentage': 123
},
'hierarchicalChunkingConfiguration': {
'levelConfigurations': [
{
'maxTokens': 123
},
],
'overlapTokens': 123
},
'semanticChunkingConfiguration': {
'maxTokens': 123,
'bufferSize': 123,
'breakpointPercentileThreshold': 123
}
},
'customTransformationConfiguration': {
'intermediateStorage': {
's3Location': {
'uri': 'string'
}
},
'transformations': [
{
'transformationFunction': {
'transformationLambdaConfiguration': {
'lambdaArn': 'string'
}
},
'stepToApply': 'POST_CHUNKING'
},
]
},
'parsingConfiguration': {
'parsingStrategy': 'BEDROCK_FOUNDATION_MODEL'|'BEDROCK_DATA_AUTOMATION'|'SMART_PARSING'|'MULTI_MODAL_EMBEDDINGS',
'bedrockFoundationModelConfiguration': {
'modelArn': 'string',
'parsingPrompt': {
'parsingPromptText': 'string'
},
'parsingModality': 'MULTIMODAL'
},
'bedrockDataAutomationConfiguration': {
'parsingModality': 'MULTIMODAL'
}
},
'contextEnrichmentConfiguration': {
'type': 'BEDROCK_FOUNDATION_MODEL',
'bedrockFoundationModelConfiguration': {
'enrichmentStrategyConfiguration': {
'method': 'CHUNK_ENTITY_EXTRACTION'
},
'modelArn': 'string'
}
}
}
)
string
[REQUIRED]
The unique identifier of the knowledge base for the data source.
string
[REQUIRED]
The unique identifier of the data source.
string
[REQUIRED]
Specifies a new name for the data source.
string
Specifies a new description for the data source.
dict
[REQUIRED]
The connection configuration for the data source that you want to update.
type (string) -- [REQUIRED]
The type of data source.
managedKnowledgeBaseConnectorConfiguration (dict) --
Contains the configuration for a data source that connects a managed knowledge base to a supported data source connector. Specify this object when the data source type is MANAGED_KNOWLEDGE_BASE_CONNECTOR.
deletionProtectionConfiguration (dict) --
A safeguard against accidental bulk deletion of indexed content.
deletionProtectionStatus (string) -- [REQUIRED]
Enable or disable deletion protection for the connector.
deletionProtectionThreshold (integer) --
The threshold is the maximum percentage of documents that a sync job can delete from your index. If a sync would delete more than this percentage, the sync skips its delete phase, leaving your indexed documents in place. Not supported for the Custom connector.
mediaExtractionConfiguration (dict) --
Configuration for extracting media (images, audio, video) from data source files.
imageExtractionConfiguration (dict) --
Configuration for image extraction.
imageExtractionStatus (string) -- [REQUIRED]
Whether image extraction is enabled or disabled.
audioExtractionConfiguration (dict) --
Configuration for audio extraction.
audioExtractionStatus (string) -- [REQUIRED]
Whether audio extraction is enabled or disabled.
videoExtractionConfiguration (dict) --
Configuration for video extraction.
videoExtractionStatus (string) -- [REQUIRED]
Whether video extraction is enabled or disabled.
connectorParameters (:ref:`document<document>`) --
Connector-specific parameters. For more information, see Connect a data source.
syncSchedule (dict) --
The recurring schedule on which the connector automatically syncs this data source. If not specified, the data source is not synced automatically and you start each sync yourself. Not supported for the Custom connector.
daily (dict) --
A daily sync that runs once a day at a system-chosen off-peak time. The run time is not configurable.
weekly (dict) --
A weekly sync that runs once a week on the specified day of the week.
dayOfWeek (string) -- [REQUIRED]
The day of the week on which the weekly sync runs.
monthly (dict) --
A monthly sync that runs once a month on the specified day of the month.
dayOfMonth (dict) -- [REQUIRED]
The day of the month on which the monthly sync runs.
dayNumber (integer) --
A specific day of the month, from 1 to 28. Values are capped at 28, so a monthly sync runs in every month, including February.
lastDayOfMonth (dict) --
Set this option to run the monthly sync on the last calendar day of each month.
s3Configuration (dict) --
The configuration information to connect to Amazon S3 as your data source for self-managed knowledge bases. To configure this data source for managed knowledge bases, use managedKnowledgeBaseConnectorConfiguration.
bucketArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the S3 bucket that contains your data.
inclusionPrefixes (list) --
A list of S3 prefixes to include certain files or content. For more information, see Organizing objects using prefixes.
(string) --
bucketOwnerAccountId (string) --
The account ID for the owner of the S3 bucket.
webConfiguration (dict) --
The configuration of web URLs to crawl for your data source. You should be authorized to crawl the URLs.
sourceConfiguration (dict) -- [REQUIRED]
The source configuration details for the web data source.
urlConfiguration (dict) -- [REQUIRED]
The configuration of the URL/URLs.
seedUrls (list) --
One or more seed or starting point URLs.
(dict) --
The seed or starting point URL. You should be authorized to crawl the URL.
url (string) --
A seed or starting point URL.
crawlerConfiguration (dict) --
The Web Crawler configuration details for the web data source.
crawlerLimits (dict) --
The configuration of crawl limits for the web URLs.
rateLimit (integer) --
The max rate at which pages are crawled, up to 300 per minute per host.
maxPages (integer) --
The max number of web pages crawled from your source URLs, up to 25,000 pages. If the web pages exceed this limit, the data source sync will fail and no web pages will be ingested.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
scope (string) --
The scope of what is crawled for your URLs.
You can choose to crawl only web pages that belong to the same host or primary domain. For example, only web pages that contain the seed URL "https://docs.aws.amazon.com/bedrock/latest/userguide/" and no other domains. You can choose to include sub domains in addition to the host or primary domain. For example, web pages that contain "aws.amazon.com" can also include sub domain "docs.aws.amazon.com".
userAgent (string) --
Returns the user agent suffix for your web crawler.
userAgentHeader (string) --
A string used for identifying the crawler or bot when it accesses a web server. The user agent header value consists of the bedrockbot, UUID, and a user agent suffix for your crawler (if one is provided). By default, it is set to bedrockbot_UUID. You can optionally append a custom suffix to bedrockbot_UUID to allowlist a specific user agent permitted to access your source URLs.
confluenceConfiguration (dict) --
The configuration information to connect to Confluence as your data source for self-managed knowledge bases.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your Confluence data source.
hostUrl (string) -- [REQUIRED]
The Confluence host URL or instance URL.
hostType (string) -- [REQUIRED]
The supported host type, whether online/cloud or server/on-premises.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your Confluence instance.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Confluence instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Confluence connection configuration.
crawlerConfiguration (dict) --
The configuration of the Confluence content. For example, configuring specific types of Confluence content.
filterConfiguration (dict) --
The configuration of filtering the Confluence content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
salesforceConfiguration (dict) --
The configuration information to connect to Salesforce as your data source.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your Salesforce data source.
hostUrl (string) -- [REQUIRED]
The Salesforce host URL or instance URL.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your Salesforce instance.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Salesforce instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Salesforce connection configuration.
crawlerConfiguration (dict) --
The configuration of the Salesforce content. For example, configuring specific types of Salesforce content.
filterConfiguration (dict) --
The configuration of filtering the Salesforce content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
sharePointConfiguration (dict) --
The configuration information to connect to SharePoint as your data source for self-managed knowledge bases.
sourceConfiguration (dict) -- [REQUIRED]
The endpoint information to connect to your SharePoint data source.
tenantId (string) --
The identifier of your Microsoft 365 tenant.
domain (string) -- [REQUIRED]
The domain of your SharePoint instance or site URL/URLs.
siteUrls (list) -- [REQUIRED]
A list of one or more SharePoint site URLs.
(string) --
hostType (string) -- [REQUIRED]
The supported host type, whether online/cloud or server/on-premises.
authType (string) -- [REQUIRED]
The supported authentication type to authenticate and connect to your SharePoint site/sites.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your SharePoint site/sites. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see SharePoint connection configuration.
crawlerConfiguration (dict) --
The configuration of the SharePoint content. For example, configuring specific types of SharePoint content.
filterConfiguration (dict) --
The configuration of filtering the SharePoint content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) -- [REQUIRED]
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) -- [REQUIRED]
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) -- [REQUIRED]
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
string
The data deletion policy for the data source that you want to update.
dict
Contains details about server-side encryption of the data source.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
dict
Contains details about how to ingest the documents in the data source.
chunkingConfiguration (dict) --
Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.
chunkingStrategy (string) -- [REQUIRED]
Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.
FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.
HIERARCHICAL – Split documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
SEMANTIC – Split documents into chunks based on groups of similar content derived with natural language processing.
NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.
fixedSizeChunkingConfiguration (dict) --
Configurations for when you choose fixed-size chunking. If you set the chunkingStrategy as NONE, exclude this field.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens to include in a chunk.
overlapPercentage (integer) -- [REQUIRED]
The percentage of overlap between adjacent chunks of a data source.
hierarchicalChunkingConfiguration (dict) --
Settings for hierarchical document chunking for a data source. Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
levelConfigurations (list) -- [REQUIRED]
Token settings for each layer.
(dict) --
Token settings for a layer in a hierarchical chunking configuration.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens that a chunk can contain in this layer.
overlapTokens (integer) -- [REQUIRED]
The number of tokens to repeat across chunks in the same layer.
semanticChunkingConfiguration (dict) --
Settings for semantic document chunking for a data source. Semantic chunking splits a document into into smaller documents based on groups of similar content derived from the text with natural language processing.
maxTokens (integer) -- [REQUIRED]
The maximum number of tokens that a chunk can contain.
bufferSize (integer) -- [REQUIRED]
The buffer size.
breakpointPercentileThreshold (integer) -- [REQUIRED]
The dissimilarity threshold for splitting chunks.
customTransformationConfiguration (dict) --
A custom document transformer for parsed data source documents.
intermediateStorage (dict) -- [REQUIRED]
An S3 bucket path for input and output objects.
s3Location (dict) -- [REQUIRED]
An S3 bucket path.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
transformations (list) -- [REQUIRED]
A Lambda function that processes documents.
(dict) --
A custom processing step for documents moving through a data source ingestion pipeline. To process documents after they have been converted into chunks, set the step to apply to POST_CHUNKING.
transformationFunction (dict) -- [REQUIRED]
A Lambda function that processes documents.
transformationLambdaConfiguration (dict) -- [REQUIRED]
The Lambda function.
lambdaArn (string) -- [REQUIRED]
The function's ARN identifier.
stepToApply (string) -- [REQUIRED]
When the service applies the transformation.
parsingConfiguration (dict) --
Configurations for a parser to use for parsing documents in your data source. If you exclude this field, the default parser will be used.
parsingStrategy (string) -- [REQUIRED]
The parsing strategy for the data source.
For managed knowledge bases, the strategy that you can select depends on the embedding model that your knowledge base uses:
If your knowledge base uses a native multimodal embedding model, specify MULTI_MODAL_EMBEDDINGS. With this strategy, files are sent directly to the embedding model instead of being parsed into text. This is the only strategy that is supported for these knowledge bases.
Otherwise, specify SMART_PARSING.
For more information, see Customize ingestion for managed knowledge bases.
bedrockFoundationModelConfiguration (dict) --
If you specify BEDROCK_FOUNDATION_MODEL as the parsing strategy for ingesting your data source, use this object to modify configurations for using a foundation model to parse documents.
modelArn (string) -- [REQUIRED]
The ARN of the foundation model to use for parsing.
parsingPrompt (dict) --
Instructions for interpreting the contents of a document.
parsingPromptText (string) -- [REQUIRED]
Instructions for interpreting the contents of a document.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
bedrockDataAutomationConfiguration (dict) --
If you specify BEDROCK_DATA_AUTOMATION as the parsing strategy for ingesting your data source, use this object to modify configurations for using the Amazon Bedrock Data Automation parser.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
contextEnrichmentConfiguration (dict) --
The context enrichment configuration used for ingestion of the data into the vector store.
type (string) -- [REQUIRED]
The method used for context enrichment. It must be Amazon Bedrock foundation models.
bedrockFoundationModelConfiguration (dict) --
The configuration of the Amazon Bedrock foundation model used for context enrichment.
enrichmentStrategyConfiguration (dict) -- [REQUIRED]
The enrichment stategy used to provide additional context. For example, Neptune GraphRAG uses Amazon Bedrock foundation models to perform chunk entity extraction.
method (string) -- [REQUIRED]
The method used for the context enrichment strategy.
modelArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
dict
Response Syntax
{
'dataSource': {
'knowledgeBaseId': 'string',
'dataSourceId': 'string',
'name': 'string',
'status': 'AVAILABLE'|'DELETING'|'DELETE_UNSUCCESSFUL'|'CREATING'|'UPDATING'|'FAILED',
'description': 'string',
'dataSourceConfiguration': {
'type': 'S3'|'WEB'|'CONFLUENCE'|'SALESFORCE'|'SHAREPOINT'|'CUSTOM'|'REDSHIFT_METADATA'|'MANAGED_KNOWLEDGE_BASE_CONNECTOR',
'managedKnowledgeBaseConnectorConfiguration': {
'deletionProtectionConfiguration': {
'deletionProtectionStatus': 'ENABLED'|'DISABLED',
'deletionProtectionThreshold': 123
},
'mediaExtractionConfiguration': {
'imageExtractionConfiguration': {
'imageExtractionStatus': 'ENABLED'|'DISABLED'
},
'audioExtractionConfiguration': {
'audioExtractionStatus': 'ENABLED'|'DISABLED'
},
'videoExtractionConfiguration': {
'videoExtractionStatus': 'ENABLED'|'DISABLED'
}
},
'connectorParameters': {...}|[...]|123|123.4|'string'|True|None,
'syncSchedule': {
'daily': {},
'weekly': {
'dayOfWeek': 'SUNDAY'|'MONDAY'|'TUESDAY'|'WEDNESDAY'|'THURSDAY'|'FRIDAY'|'SATURDAY'
},
'monthly': {
'dayOfMonth': {
'dayNumber': 123,
'lastDayOfMonth': {}
}
}
}
},
's3Configuration': {
'bucketArn': 'string',
'inclusionPrefixes': [
'string',
],
'bucketOwnerAccountId': 'string'
},
'webConfiguration': {
'sourceConfiguration': {
'urlConfiguration': {
'seedUrls': [
{
'url': 'string'
},
]
}
},
'crawlerConfiguration': {
'crawlerLimits': {
'rateLimit': 123,
'maxPages': 123
},
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
],
'scope': 'HOST_ONLY'|'SUBDOMAINS',
'userAgent': 'string',
'userAgentHeader': 'string'
}
},
'confluenceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'hostType': 'SAAS',
'authType': 'BASIC'|'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'salesforceConfiguration': {
'sourceConfiguration': {
'hostUrl': 'string',
'authType': 'OAUTH2_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
},
'sharePointConfiguration': {
'sourceConfiguration': {
'tenantId': 'string',
'domain': 'string',
'siteUrls': [
'string',
],
'hostType': 'ONLINE',
'authType': 'OAUTH2_CLIENT_CREDENTIALS'|'OAUTH2_SHAREPOINT_APP_ONLY_CLIENT_CREDENTIALS',
'credentialsSecretArn': 'string'
},
'crawlerConfiguration': {
'filterConfiguration': {
'type': 'PATTERN',
'patternObjectFilter': {
'filters': [
{
'objectType': 'string',
'inclusionFilters': [
'string',
],
'exclusionFilters': [
'string',
]
},
]
}
}
}
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'vectorIngestionConfiguration': {
'chunkingConfiguration': {
'chunkingStrategy': 'FIXED_SIZE'|'NONE'|'HIERARCHICAL'|'SEMANTIC',
'fixedSizeChunkingConfiguration': {
'maxTokens': 123,
'overlapPercentage': 123
},
'hierarchicalChunkingConfiguration': {
'levelConfigurations': [
{
'maxTokens': 123
},
],
'overlapTokens': 123
},
'semanticChunkingConfiguration': {
'maxTokens': 123,
'bufferSize': 123,
'breakpointPercentileThreshold': 123
}
},
'customTransformationConfiguration': {
'intermediateStorage': {
's3Location': {
'uri': 'string'
}
},
'transformations': [
{
'transformationFunction': {
'transformationLambdaConfiguration': {
'lambdaArn': 'string'
}
},
'stepToApply': 'POST_CHUNKING'
},
]
},
'parsingConfiguration': {
'parsingStrategy': 'BEDROCK_FOUNDATION_MODEL'|'BEDROCK_DATA_AUTOMATION'|'SMART_PARSING'|'MULTI_MODAL_EMBEDDINGS',
'bedrockFoundationModelConfiguration': {
'modelArn': 'string',
'parsingPrompt': {
'parsingPromptText': 'string'
},
'parsingModality': 'MULTIMODAL'
},
'bedrockDataAutomationConfiguration': {
'parsingModality': 'MULTIMODAL'
}
},
'contextEnrichmentConfiguration': {
'type': 'BEDROCK_FOUNDATION_MODEL',
'bedrockFoundationModelConfiguration': {
'enrichmentStrategyConfiguration': {
'method': 'CHUNK_ENTITY_EXTRACTION'
},
'modelArn': 'string'
}
}
},
'dataDeletionPolicy': 'RETAIN'|'DELETE',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
dataSource (dict) --
Contains details about the data source.
knowledgeBaseId (string) --
The unique identifier of the knowledge base to which the data source belongs.
dataSourceId (string) --
The unique identifier of the data source.
name (string) --
The name of the data source.
status (string) --
The status of the data source. The following statuses are possible:
Available – The data source has been created and is ready for ingestion into the knowledge base.
Deleting – The data source is being deleted.
description (string) --
The description of the data source.
dataSourceConfiguration (dict) --
The connection configuration for the data source.
type (string) --
The type of data source.
managedKnowledgeBaseConnectorConfiguration (dict) --
Contains the configuration for a data source that connects a managed knowledge base to a supported data source connector. Specify this object when the data source type is MANAGED_KNOWLEDGE_BASE_CONNECTOR.
deletionProtectionConfiguration (dict) --
A safeguard against accidental bulk deletion of indexed content.
deletionProtectionStatus (string) --
Enable or disable deletion protection for the connector.
deletionProtectionThreshold (integer) --
The threshold is the maximum percentage of documents that a sync job can delete from your index. If a sync would delete more than this percentage, the sync skips its delete phase, leaving your indexed documents in place. Not supported for the Custom connector.
mediaExtractionConfiguration (dict) --
Configuration for extracting media (images, audio, video) from data source files.
imageExtractionConfiguration (dict) --
Configuration for image extraction.
imageExtractionStatus (string) --
Whether image extraction is enabled or disabled.
audioExtractionConfiguration (dict) --
Configuration for audio extraction.
audioExtractionStatus (string) --
Whether audio extraction is enabled or disabled.
videoExtractionConfiguration (dict) --
Configuration for video extraction.
videoExtractionStatus (string) --
Whether video extraction is enabled or disabled.
connectorParameters (:ref:`document<document>`) --
Connector-specific parameters. For more information, see Connect a data source.
syncSchedule (dict) --
The recurring schedule on which the connector automatically syncs this data source. If not specified, the data source is not synced automatically and you start each sync yourself. Not supported for the Custom connector.
daily (dict) --
A daily sync that runs once a day at a system-chosen off-peak time. The run time is not configurable.
weekly (dict) --
A weekly sync that runs once a week on the specified day of the week.
dayOfWeek (string) --
The day of the week on which the weekly sync runs.
monthly (dict) --
A monthly sync that runs once a month on the specified day of the month.
dayOfMonth (dict) --
The day of the month on which the monthly sync runs.
dayNumber (integer) --
A specific day of the month, from 1 to 28. Values are capped at 28, so a monthly sync runs in every month, including February.
lastDayOfMonth (dict) --
Set this option to run the monthly sync on the last calendar day of each month.
s3Configuration (dict) --
The configuration information to connect to Amazon S3 as your data source for self-managed knowledge bases. To configure this data source for managed knowledge bases, use managedKnowledgeBaseConnectorConfiguration.
bucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket that contains your data.
inclusionPrefixes (list) --
A list of S3 prefixes to include certain files or content. For more information, see Organizing objects using prefixes.
(string) --
bucketOwnerAccountId (string) --
The account ID for the owner of the S3 bucket.
webConfiguration (dict) --
The configuration of web URLs to crawl for your data source. You should be authorized to crawl the URLs.
sourceConfiguration (dict) --
The source configuration details for the web data source.
urlConfiguration (dict) --
The configuration of the URL/URLs.
seedUrls (list) --
One or more seed or starting point URLs.
(dict) --
The seed or starting point URL. You should be authorized to crawl the URL.
url (string) --
A seed or starting point URL.
crawlerConfiguration (dict) --
The Web Crawler configuration details for the web data source.
crawlerLimits (dict) --
The configuration of crawl limits for the web URLs.
rateLimit (integer) --
The max rate at which pages are crawled, up to 300 per minute per host.
maxPages (integer) --
The max number of web pages crawled from your source URLs, up to 25,000 pages. If the web pages exceed this limit, the data source sync will fail and no web pages will be ingested.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain URLs. If you specify an inclusion and exclusion filter/pattern and both match a URL, the exclusion filter takes precedence and the web content of the URL isn’t crawled.
(string) --
scope (string) --
The scope of what is crawled for your URLs.
You can choose to crawl only web pages that belong to the same host or primary domain. For example, only web pages that contain the seed URL "https://docs.aws.amazon.com/bedrock/latest/userguide/" and no other domains. You can choose to include sub domains in addition to the host or primary domain. For example, web pages that contain "aws.amazon.com" can also include sub domain "docs.aws.amazon.com".
userAgent (string) --
Returns the user agent suffix for your web crawler.
userAgentHeader (string) --
A string used for identifying the crawler or bot when it accesses a web server. The user agent header value consists of the bedrockbot, UUID, and a user agent suffix for your crawler (if one is provided). By default, it is set to bedrockbot_UUID. You can optionally append a custom suffix to bedrockbot_UUID to allowlist a specific user agent permitted to access your source URLs.
confluenceConfiguration (dict) --
The configuration information to connect to Confluence as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your Confluence data source.
hostUrl (string) --
The Confluence host URL or instance URL.
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your Confluence instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Confluence instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Confluence connection configuration.
crawlerConfiguration (dict) --
The configuration of the Confluence content. For example, configuring specific types of Confluence content.
filterConfiguration (dict) --
The configuration of filtering the Confluence content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
salesforceConfiguration (dict) --
The configuration information to connect to Salesforce as your data source.
sourceConfiguration (dict) --
The endpoint information to connect to your Salesforce data source.
hostUrl (string) --
The Salesforce host URL or instance URL.
authType (string) --
The supported authentication type to authenticate and connect to your Salesforce instance.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your Salesforce instance URL. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see Salesforce connection configuration.
crawlerConfiguration (dict) --
The configuration of the Salesforce content. For example, configuring specific types of Salesforce content.
filterConfiguration (dict) --
The configuration of filtering the Salesforce content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
sharePointConfiguration (dict) --
The configuration information to connect to SharePoint as your data source for self-managed knowledge bases.
sourceConfiguration (dict) --
The endpoint information to connect to your SharePoint data source.
tenantId (string) --
The identifier of your Microsoft 365 tenant.
domain (string) --
The domain of your SharePoint instance or site URL/URLs.
siteUrls (list) --
A list of one or more SharePoint site URLs.
(string) --
hostType (string) --
The supported host type, whether online/cloud or server/on-premises.
authType (string) --
The supported authentication type to authenticate and connect to your SharePoint site/sites.
credentialsSecretArn (string) --
The Amazon Resource Name of an Secrets Manager secret that stores your authentication credentials for your SharePoint site/sites. For more information on the key-value pairs that must be included in your secret, depending on your authentication type, see SharePoint connection configuration.
crawlerConfiguration (dict) --
The configuration of the SharePoint content. For example, configuring specific types of SharePoint content.
filterConfiguration (dict) --
The configuration of filtering the SharePoint content. For example, configuring regular expression patterns to include or exclude certain content.
type (string) --
The type of filtering that you want to apply to certain objects or content of the data source. For example, the PATTERN type is regular expression patterns you can apply to filter your content.
patternObjectFilter (dict) --
The configuration of filtering certain objects or content types of the data source.
filters (list) --
The configuration of specific filters applied to your data source content. You can filter out or include certain content.
(dict) --
The specific filters applied to your data source content. You can filter out or include certain content.
objectType (string) --
The supported object type or content type of the data source.
inclusionFilters (list) --
A list of one or more inclusion regular expression patterns to include certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
exclusionFilters (list) --
A list of one or more exclusion regular expression patterns to exclude certain object types that adhere to the pattern. If you specify an inclusion and exclusion filter/pattern and both match a document, the exclusion filter takes precedence and the document isn’t crawled.
(string) --
serverSideEncryptionConfiguration (dict) --
Contains details about the configuration of the server-side encryption.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
vectorIngestionConfiguration (dict) --
Contains details about how to ingest the documents in the data source.
chunkingConfiguration (dict) --
Details about how to chunk the documents in the data source. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried.
chunkingStrategy (string) --
Knowledge base can split your source data into chunks. A chunk refers to an excerpt from a data source that is returned when the knowledge base that it belongs to is queried. You have the following options for chunking your data. If you opt for NONE, then you may want to pre-process your files by splitting them up such that each file corresponds to a chunk.
FIXED_SIZE – Amazon Bedrock splits your source data into chunks of the approximate size that you set in the fixedSizeChunkingConfiguration.
HIERARCHICAL – Split documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
SEMANTIC – Split documents into chunks based on groups of similar content derived with natural language processing.
NONE – Amazon Bedrock treats each file as one chunk. If you choose this option, you may want to pre-process your documents by splitting them into separate files.
fixedSizeChunkingConfiguration (dict) --
Configurations for when you choose fixed-size chunking. If you set the chunkingStrategy as NONE, exclude this field.
maxTokens (integer) --
The maximum number of tokens to include in a chunk.
overlapPercentage (integer) --
The percentage of overlap between adjacent chunks of a data source.
hierarchicalChunkingConfiguration (dict) --
Settings for hierarchical document chunking for a data source. Hierarchical chunking splits documents into layers of chunks where the first layer contains large chunks, and the second layer contains smaller chunks derived from the first layer.
levelConfigurations (list) --
Token settings for each layer.
(dict) --
Token settings for a layer in a hierarchical chunking configuration.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain in this layer.
overlapTokens (integer) --
The number of tokens to repeat across chunks in the same layer.
semanticChunkingConfiguration (dict) --
Settings for semantic document chunking for a data source. Semantic chunking splits a document into into smaller documents based on groups of similar content derived from the text with natural language processing.
maxTokens (integer) --
The maximum number of tokens that a chunk can contain.
bufferSize (integer) --
The buffer size.
breakpointPercentileThreshold (integer) --
The dissimilarity threshold for splitting chunks.
customTransformationConfiguration (dict) --
A custom document transformer for parsed data source documents.
intermediateStorage (dict) --
An S3 bucket path for input and output objects.
s3Location (dict) --
An S3 bucket path.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
transformations (list) --
A Lambda function that processes documents.
(dict) --
A custom processing step for documents moving through a data source ingestion pipeline. To process documents after they have been converted into chunks, set the step to apply to POST_CHUNKING.
transformationFunction (dict) --
A Lambda function that processes documents.
transformationLambdaConfiguration (dict) --
The Lambda function.
lambdaArn (string) --
The function's ARN identifier.
stepToApply (string) --
When the service applies the transformation.
parsingConfiguration (dict) --
Configurations for a parser to use for parsing documents in your data source. If you exclude this field, the default parser will be used.
parsingStrategy (string) --
The parsing strategy for the data source.
For managed knowledge bases, the strategy that you can select depends on the embedding model that your knowledge base uses:
If your knowledge base uses a native multimodal embedding model, specify MULTI_MODAL_EMBEDDINGS. With this strategy, files are sent directly to the embedding model instead of being parsed into text. This is the only strategy that is supported for these knowledge bases.
Otherwise, specify SMART_PARSING.
For more information, see Customize ingestion for managed knowledge bases.
bedrockFoundationModelConfiguration (dict) --
If you specify BEDROCK_FOUNDATION_MODEL as the parsing strategy for ingesting your data source, use this object to modify configurations for using a foundation model to parse documents.
modelArn (string) --
The ARN of the foundation model to use for parsing.
parsingPrompt (dict) --
Instructions for interpreting the contents of a document.
parsingPromptText (string) --
Instructions for interpreting the contents of a document.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
bedrockDataAutomationConfiguration (dict) --
If you specify BEDROCK_DATA_AUTOMATION as the parsing strategy for ingesting your data source, use this object to modify configurations for using the Amazon Bedrock Data Automation parser.
parsingModality (string) --
Specifies whether to enable parsing of multimodal data, including both text and/or images.
contextEnrichmentConfiguration (dict) --
The context enrichment configuration used for ingestion of the data into the vector store.
type (string) --
The method used for context enrichment. It must be Amazon Bedrock foundation models.
bedrockFoundationModelConfiguration (dict) --
The configuration of the Amazon Bedrock foundation model used for context enrichment.
enrichmentStrategyConfiguration (dict) --
The enrichment stategy used to provide additional context. For example, Neptune GraphRAG uses Amazon Bedrock foundation models to perform chunk entity extraction.
method (string) --
The method used for the context enrichment strategy.
modelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
dataDeletionPolicy (string) --
The data deletion policy for the data source.
createdAt (datetime) --
The time at which the data source was created.
updatedAt (datetime) --
The time at which the data source was last updated.
failureReasons (list) --
The detailed reasons on the failure to delete a data source.
(string) --
{'knowledgeBaseConfiguration': {'managedKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}},
'supplementalDataStorageConfiguration': {'storageLocations': [{'s3Location': {'uri': 'string'},
'type': 'S3'}]}},
'vectorKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}}}}}
Response {'knowledgeBase': {'knowledgeBaseConfiguration': {'managedKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}},
'supplementalDataStorageConfiguration': {'storageLocations': [{'s3Location': {'uri': 'string'},
'type': 'S3'}]}},
'vectorKnowledgeBaseConfiguration': {'embeddingModelConfiguration': {'bedrockEmbeddingModelConfiguration': {'modelConfiguration': {}}}}}}}
Updates the configuration of a knowledge base with the fields that you specify. Because all fields will be overwritten, you must include the same values for fields that you want to keep the same.
You can change the following fields:
name
description
roleArn
You can't change the knowledgeBaseConfiguration or storageConfiguration fields, so you must specify the same configurations as when you created the knowledge base. You can send a GetKnowledgeBase request and copy the same configurations.
See also: AWS API Documentation
Request Syntax
client.update_knowledge_base(
knowledgeBaseId='string',
name='string',
description='string',
roleArn='string',
knowledgeBaseConfiguration={
'type': 'VECTOR'|'KENDRA'|'SQL'|'MANAGED',
'vectorKnowledgeBaseConfiguration': {
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'managedKnowledgeBaseConfiguration': {
'embeddingModelType': 'CUSTOM'|'MANAGED',
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'kendraKnowledgeBaseConfiguration': {
'kendraIndexArn': 'string'
},
'sqlKnowledgeBaseConfiguration': {
'type': 'REDSHIFT',
'redshiftConfiguration': {
'storageConfigurations': [
{
'type': 'REDSHIFT'|'AWS_DATA_CATALOG',
'awsDataCatalogConfiguration': {
'tableNames': [
'string',
]
},
'redshiftConfiguration': {
'databaseName': 'string'
}
},
],
'queryEngineConfiguration': {
'type': 'SERVERLESS'|'PROVISIONED',
'serverlessConfiguration': {
'workgroupArn': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD',
'usernamePasswordSecretArn': 'string'
}
},
'provisionedConfiguration': {
'clusterIdentifier': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD'|'USERNAME',
'databaseUser': 'string',
'usernamePasswordSecretArn': 'string'
}
}
},
'queryGenerationConfiguration': {
'executionTimeoutSeconds': 123,
'generationContext': {
'tables': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE',
'columns': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE'
},
]
},
],
'curatedQueries': [
{
'naturalLanguage': 'string',
'sql': 'string'
},
]
}
}
}
}
},
storageConfiguration={
'type': 'OPENSEARCH_SERVERLESS'|'PINECONE'|'REDIS_ENTERPRISE_CLOUD'|'RDS'|'MONGO_DB_ATLAS'|'NEPTUNE_ANALYTICS'|'OPENSEARCH_MANAGED_CLUSTER'|'S3_VECTORS',
'opensearchServerlessConfiguration': {
'collectionArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'opensearchManagedClusterConfiguration': {
'domainEndpoint': 'string',
'domainArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'pineconeConfiguration': {
'connectionString': 'string',
'credentialsSecretArn': 'string',
'namespace': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
'redisEnterpriseCloudConfiguration': {
'endpoint': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'rdsConfiguration': {
'resourceArn': 'string',
'credentialsSecretArn': 'string',
'databaseName': 'string',
'tableName': 'string',
'fieldMapping': {
'primaryKeyField': 'string',
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string',
'customMetadataField': 'string'
}
},
'mongoDbAtlasConfiguration': {
'endpoint': 'string',
'databaseName': 'string',
'collectionName': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
},
'endpointServiceName': 'string',
'textIndexName': 'string'
},
'neptuneAnalyticsConfiguration': {
'graphArn': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
's3VectorsConfiguration': {
'vectorBucketArn': 'string',
'indexArn': 'string',
'indexName': 'string'
}
}
)
string
[REQUIRED]
The unique identifier of the knowledge base to update.
string
[REQUIRED]
Specifies a new name for the knowledge base.
string
Specifies a new description for the knowledge base.
string
[REQUIRED]
Specifies a different Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the knowledge base.
dict
[REQUIRED]
Specifies the configuration for the embeddings model used for the knowledge base. You must use the same configuration as when the knowledge base was created.
type (string) -- [REQUIRED]
The type of data that the data source is converted into for the knowledge base. Choose MANAGED to create a managed knowledge base.
vectorKnowledgeBaseConfiguration (dict) --
Contains details about the model that's used to convert the data source into vector embeddings.
embeddingModelArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
embeddingModelConfiguration (dict) --
The embeddings model configuration details for the vector model used in Knowledge Base.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
supplementalDataStorageConfiguration (dict) --
If you include multimodal data from your data source, use this object to specify configurations for the storage location of the images extracted from your documents. These images can be retrieved and returned to the end user. They can also be used in generation when using RetrieveAndGenerate.
storageLocations (list) -- [REQUIRED]
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) -- [REQUIRED]
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
managedKnowledgeBaseConfiguration (dict) --
Contains configuration details for a knowledge base that uses a vector store fully managed by Amazon Bedrock. Specify this object when the knowledge base type is MANAGED.
embeddingModelType (string) --
Choose CUSTOM to provide your own Bedrock embedding model ARN. Choose MANAGED to use a service-managed embedding model.
embeddingModelArn (string) --
The ARN for the embeddings model.
embeddingModelConfiguration (dict) --
The configuration details for the embeddings model. Not required when choosing the MANAGED embeddingModelType.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) -- [REQUIRED]
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) -- [REQUIRED]
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
serverSideEncryptionConfiguration (dict) --
Contains the configuration for server-side encryption for your managed knowledge base.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
supplementalDataStorageConfiguration (dict) --
Use this object to specify the Amazon S3 location that the knowledge base uses to process and ingest multimodal content. This field is required when you use a native multimodal embedding model.
storageLocations (list) -- [REQUIRED]
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) -- [REQUIRED]
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) -- [REQUIRED]
The location's URI. For example, s3://my-bucket/chunk-processor/.
kendraKnowledgeBaseConfiguration (dict) --
Settings for an Amazon Kendra knowledge base.
kendraIndexArn (string) -- [REQUIRED]
The ARN of the Amazon Kendra index.
sqlKnowledgeBaseConfiguration (dict) --
Specifies configurations for a knowledge base connected to an SQL database.
type (string) -- [REQUIRED]
The type of SQL database to connect to the knowledge base.
redshiftConfiguration (dict) --
Specifies configurations for a knowledge base connected to an Amazon Redshift database.
storageConfigurations (list) -- [REQUIRED]
Specifies configurations for Amazon Redshift database storage.
(dict) --
Contains configurations for Amazon Redshift data storage. Specify the data storage service to use in the type field and include the corresponding field. For more information, see Build a knowledge base by connecting to a structured data source in the Amazon Bedrock User Guide.
type (string) -- [REQUIRED]
The data storage service to use.
awsDataCatalogConfiguration (dict) --
Specifies configurations for storage in Glue Data Catalog.
tableNames (list) -- [REQUIRED]
A list of names of the tables to use.
(string) --
redshiftConfiguration (dict) --
Specifies configurations for storage in Amazon Redshift.
databaseName (string) -- [REQUIRED]
The name of the Amazon Redshift database.
queryEngineConfiguration (dict) -- [REQUIRED]
Specifies configurations for an Amazon Redshift query engine.
type (string) -- [REQUIRED]
The type of query engine.
serverlessConfiguration (dict) --
Specifies configurations for a serverless Amazon Redshift query engine.
workgroupArn (string) -- [REQUIRED]
The ARN of the Amazon Redshift workgroup.
authConfiguration (dict) -- [REQUIRED]
Specifies configurations for authentication to an Amazon Redshift provisioned data warehouse.
type (string) -- [REQUIRED]
The type of authentication to use.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
provisionedConfiguration (dict) --
Specifies configurations for a provisioned Amazon Redshift query engine.
clusterIdentifier (string) -- [REQUIRED]
The ID of the Amazon Redshift cluster.
authConfiguration (dict) -- [REQUIRED]
Specifies configurations for authentication to Amazon Redshift.
type (string) -- [REQUIRED]
The type of authentication to use.
databaseUser (string) --
The database username for authentication to an Amazon Redshift provisioned data warehouse.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
queryGenerationConfiguration (dict) --
Specifies configurations for generating queries.
executionTimeoutSeconds (integer) --
The time after which query generation will time out.
generationContext (dict) --
Specifies configurations for context to use during query generation.
tables (list) --
An array of objects, each of which defines information about a table in the database.
(dict) --
Contains information about a table for the query engine to consider.
name (string) -- [REQUIRED]
The name of the table for which the other fields in this object apply.
description (string) --
A description of the table that helps the query engine understand the contents of the table.
inclusion (string) --
Specifies whether to include or exclude the table during query generation. If you specify EXCLUDE, the table will be ignored. If you specify INCLUDE, all other tables will be ignored.
columns (list) --
An array of objects, each of which defines information about a column in the table.
(dict) --
Contains information about a column in the current table for the query engine to consider.
name (string) --
The name of the column for which the other fields in this object apply.
description (string) --
A description of the column that helps the query engine understand the contents of the column.
inclusion (string) --
Specifies whether to include or exclude the column during query generation. If you specify EXCLUDE, the column will be ignored. If you specify INCLUDE, all other columns in the table will be ignored.
curatedQueries (list) --
An array of objects, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
(dict) --
Contains configurations for a query, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
naturalLanguage (string) -- [REQUIRED]
An example natural language query.
sql (string) -- [REQUIRED]
The SQL equivalent of the natural language query.
dict
Specifies the configuration for the vector store used for the knowledge base. You must use the same configuration as when the knowledge base was created.
type (string) -- [REQUIRED]
The vector store service in which the knowledge base is stored.
opensearchServerlessConfiguration (dict) --
Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.
collectionArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the OpenSearch Service vector store.
vectorIndexName (string) -- [REQUIRED]
The name of the vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
opensearchManagedClusterConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in OpenSearch Managed Cluster. For more information, see Create a vector index in Amazon OpenSearch Service.
domainEndpoint (string) -- [REQUIRED]
The endpoint URL the OpenSearch domain.
domainArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the OpenSearch domain.
vectorIndexName (string) -- [REQUIRED]
The name of the vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
pineconeConfiguration (dict) --
Contains the storage configuration of the knowledge base in Pinecone.
connectionString (string) -- [REQUIRED]
The endpoint URL for your index management page.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Pinecone API key.
namespace (string) --
The namespace to be used to write new data to your database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
redisEnterpriseCloudConfiguration (dict) --
Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.
endpoint (string) -- [REQUIRED]
The endpoint URL of the Redis Enterprise Cloud database.
vectorIndexName (string) -- [REQUIRED]
The name of the vector index.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
rdsConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see Create a vector index in Amazon RDS.
resourceArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the vector store.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.
databaseName (string) -- [REQUIRED]
The name of your Amazon RDS database.
tableName (string) -- [REQUIRED]
The name of the table in the database.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
primaryKeyField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the ID for each entry.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
customMetadataField (string) --
Provide a name for the universal metadata field where Amazon Bedrock will store any custom metadata from your data source.
mongoDbAtlasConfiguration (dict) --
Contains the storage configuration of the knowledge base in MongoDB Atlas.
endpoint (string) -- [REQUIRED]
The endpoint URL of your MongoDB Atlas cluster for your knowledge base.
databaseName (string) -- [REQUIRED]
The database name in your MongoDB Atlas cluster for your knowledge base.
collectionName (string) -- [REQUIRED]
The collection name of the knowledge base in MongoDB Atlas.
vectorIndexName (string) -- [REQUIRED]
The name of the MongoDB Atlas vector search index.
credentialsSecretArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that contains user credentials for your MongoDB Atlas cluster.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
vectorField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
endpointServiceName (string) --
The name of the VPC endpoint service in your account that is connected to your MongoDB Atlas cluster.
textIndexName (string) --
The name of the text search index in the MongoDB collection. This is required for using the hybrid search feature.
neptuneAnalyticsConfiguration (dict) --
Contains details about the Neptune Analytics configuration of the knowledge base in Amazon Neptune. For more information, see Create a vector index in Amazon Neptune Analytics..
graphArn (string) -- [REQUIRED]
The Amazon Resource Name (ARN) of the Neptune Analytics vector store.
fieldMapping (dict) -- [REQUIRED]
Contains the names of the fields to which to map information about the vector store.
textField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) -- [REQUIRED]
The name of the field in which Amazon Bedrock stores metadata about the vector store.
s3VectorsConfiguration (dict) --
The configuration settings for storing knowledge base data using S3 vectors. This includes vector index information and S3 bucket details for vector storage.
vectorBucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket where vector embeddings are stored. This bucket contains the vector data used by the knowledge base.
indexArn (string) --
The Amazon Resource Name (ARN) of the vector index used for the knowledge base. This ARN identifies the specific vector index resource within Amazon Bedrock.
indexName (string) --
The name of the vector index used for the knowledge base. This name identifies the vector index within the Amazon Bedrock service.
dict
Response Syntax
{
'knowledgeBase': {
'knowledgeBaseId': 'string',
'name': 'string',
'knowledgeBaseArn': 'string',
'description': 'string',
'roleArn': 'string',
'knowledgeBaseConfiguration': {
'type': 'VECTOR'|'KENDRA'|'SQL'|'MANAGED',
'vectorKnowledgeBaseConfiguration': {
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'managedKnowledgeBaseConfiguration': {
'embeddingModelType': 'CUSTOM'|'MANAGED',
'embeddingModelArn': 'string',
'embeddingModelConfiguration': {
'bedrockEmbeddingModelConfiguration': {
'dimensions': 123,
'embeddingDataType': 'FLOAT32'|'BINARY',
'audio': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'video': [
{
'segmentationConfiguration': {
'fixedLengthDuration': 123
}
},
],
'modelConfiguration': {...}|[...]|123|123.4|'string'|True|None
}
},
'serverSideEncryptionConfiguration': {
'kmsKeyArn': 'string'
},
'supplementalDataStorageConfiguration': {
'storageLocations': [
{
'type': 'S3',
's3Location': {
'uri': 'string'
}
},
]
}
},
'kendraKnowledgeBaseConfiguration': {
'kendraIndexArn': 'string'
},
'sqlKnowledgeBaseConfiguration': {
'type': 'REDSHIFT',
'redshiftConfiguration': {
'storageConfigurations': [
{
'type': 'REDSHIFT'|'AWS_DATA_CATALOG',
'awsDataCatalogConfiguration': {
'tableNames': [
'string',
]
},
'redshiftConfiguration': {
'databaseName': 'string'
}
},
],
'queryEngineConfiguration': {
'type': 'SERVERLESS'|'PROVISIONED',
'serverlessConfiguration': {
'workgroupArn': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD',
'usernamePasswordSecretArn': 'string'
}
},
'provisionedConfiguration': {
'clusterIdentifier': 'string',
'authConfiguration': {
'type': 'IAM'|'USERNAME_PASSWORD'|'USERNAME',
'databaseUser': 'string',
'usernamePasswordSecretArn': 'string'
}
}
},
'queryGenerationConfiguration': {
'executionTimeoutSeconds': 123,
'generationContext': {
'tables': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE',
'columns': [
{
'name': 'string',
'description': 'string',
'inclusion': 'INCLUDE'|'EXCLUDE'
},
]
},
],
'curatedQueries': [
{
'naturalLanguage': 'string',
'sql': 'string'
},
]
}
}
}
}
},
'storageConfiguration': {
'type': 'OPENSEARCH_SERVERLESS'|'PINECONE'|'REDIS_ENTERPRISE_CLOUD'|'RDS'|'MONGO_DB_ATLAS'|'NEPTUNE_ANALYTICS'|'OPENSEARCH_MANAGED_CLUSTER'|'S3_VECTORS',
'opensearchServerlessConfiguration': {
'collectionArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'opensearchManagedClusterConfiguration': {
'domainEndpoint': 'string',
'domainArn': 'string',
'vectorIndexName': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'pineconeConfiguration': {
'connectionString': 'string',
'credentialsSecretArn': 'string',
'namespace': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
'redisEnterpriseCloudConfiguration': {
'endpoint': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
}
},
'rdsConfiguration': {
'resourceArn': 'string',
'credentialsSecretArn': 'string',
'databaseName': 'string',
'tableName': 'string',
'fieldMapping': {
'primaryKeyField': 'string',
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string',
'customMetadataField': 'string'
}
},
'mongoDbAtlasConfiguration': {
'endpoint': 'string',
'databaseName': 'string',
'collectionName': 'string',
'vectorIndexName': 'string',
'credentialsSecretArn': 'string',
'fieldMapping': {
'vectorField': 'string',
'textField': 'string',
'metadataField': 'string'
},
'endpointServiceName': 'string',
'textIndexName': 'string'
},
'neptuneAnalyticsConfiguration': {
'graphArn': 'string',
'fieldMapping': {
'textField': 'string',
'metadataField': 'string'
}
},
's3VectorsConfiguration': {
'vectorBucketArn': 'string',
'indexArn': 'string',
'indexName': 'string'
}
},
'status': 'CREATING'|'ACTIVE'|'DELETING'|'UPDATING'|'FAILED'|'DELETE_UNSUCCESSFUL'|'UPDATE_UNSUCCESSFUL',
'createdAt': datetime(2015, 1, 1),
'updatedAt': datetime(2015, 1, 1),
'failureReasons': [
'string',
]
}
}
Response Structure
(dict) --
knowledgeBase (dict) --
Contains details about the knowledge base.
knowledgeBaseId (string) --
The unique identifier of the knowledge base.
name (string) --
The name of the knowledge base.
knowledgeBaseArn (string) --
The Amazon Resource Name (ARN) of the knowledge base.
description (string) --
The description of the knowledge base.
roleArn (string) --
The Amazon Resource Name (ARN) of the IAM role with permissions to invoke API operations on the knowledge base.
knowledgeBaseConfiguration (dict) --
Contains details about the embeddings configuration of the knowledge base.
type (string) --
The type of data that the data source is converted into for the knowledge base. Choose MANAGED to create a managed knowledge base.
vectorKnowledgeBaseConfiguration (dict) --
Contains details about the model that's used to convert the data source into vector embeddings.
embeddingModelArn (string) --
The Amazon Resource Name (ARN) of the model used to create vector embeddings for the knowledge base.
embeddingModelConfiguration (dict) --
The embeddings model configuration details for the vector model used in Knowledge Base.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
supplementalDataStorageConfiguration (dict) --
If you include multimodal data from your data source, use this object to specify configurations for the storage location of the images extracted from your documents. These images can be retrieved and returned to the end user. They can also be used in generation when using RetrieveAndGenerate.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
managedKnowledgeBaseConfiguration (dict) --
Contains configuration details for a knowledge base that uses a vector store fully managed by Amazon Bedrock. Specify this object when the knowledge base type is MANAGED.
embeddingModelType (string) --
Choose CUSTOM to provide your own Bedrock embedding model ARN. Choose MANAGED to use a service-managed embedding model.
embeddingModelArn (string) --
The ARN for the embeddings model.
embeddingModelConfiguration (dict) --
The configuration details for the embeddings model. Not required when choosing the MANAGED embeddingModelType.
bedrockEmbeddingModelConfiguration (dict) --
The vector configuration details on the Bedrock embeddings model.
dimensions (integer) --
The dimensions details for the vector configuration used on the Bedrock embeddings model.
embeddingDataType (string) --
The data type for the vectors when using a model to convert text into vector embeddings. The model must support the specified data type for vector embeddings. Floating-point (float32) is the default data type, and is supported by most models for vector embeddings. See Supported embeddings models for information on the available models and their vector data types.
audio (list) --
Configuration settings for processing audio content in multimodal knowledge bases.
(dict) --
Audio configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting audio content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each audio segment. Audio files will be divided into chunks of this length for processing.
video (list) --
Configuration settings for processing video content in multimodal knowledge bases.
(dict) --
Video configuration for multi modal ingestion.
segmentationConfiguration (dict) --
Configuration for segmenting video content during processing.
fixedLengthDuration (integer) --
The duration in seconds for each video segment. Video files will be divided into chunks of this length for processing.
modelConfiguration (:ref:`document<document>`) --
Model-specific configuration for the embedding model, provided as a JSON object. Use this field to specify settings that apply to the embedding model that you selected, such as how audio and video files are divided into segments.
The fields that this object accepts depend on the embedding model. For the settings that each model accepts, see the documentation for that model.
serverSideEncryptionConfiguration (dict) --
Contains the configuration for server-side encryption for your managed knowledge base.
kmsKeyArn (string) --
The Amazon Resource Name (ARN) of the KMS key used to encrypt the resource.
supplementalDataStorageConfiguration (dict) --
Use this object to specify the Amazon S3 location that the knowledge base uses to process and ingest multimodal content. This field is required when you use a native multimodal embedding model.
storageLocations (list) --
A list of objects specifying storage locations for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
(dict) --
Contains information about a storage location for multimedia content (images, audio, and video) extracted from multimodal documents in your data source.
type (string) --
Specifies the storage service used for this location.
s3Location (dict) --
Contains information about the Amazon S3 location for the extracted multimedia content.
uri (string) --
The location's URI. For example, s3://my-bucket/chunk-processor/.
kendraKnowledgeBaseConfiguration (dict) --
Settings for an Amazon Kendra knowledge base.
kendraIndexArn (string) --
The ARN of the Amazon Kendra index.
sqlKnowledgeBaseConfiguration (dict) --
Specifies configurations for a knowledge base connected to an SQL database.
type (string) --
The type of SQL database to connect to the knowledge base.
redshiftConfiguration (dict) --
Specifies configurations for a knowledge base connected to an Amazon Redshift database.
storageConfigurations (list) --
Specifies configurations for Amazon Redshift database storage.
(dict) --
Contains configurations for Amazon Redshift data storage. Specify the data storage service to use in the type field and include the corresponding field. For more information, see Build a knowledge base by connecting to a structured data source in the Amazon Bedrock User Guide.
type (string) --
The data storage service to use.
awsDataCatalogConfiguration (dict) --
Specifies configurations for storage in Glue Data Catalog.
tableNames (list) --
A list of names of the tables to use.
(string) --
redshiftConfiguration (dict) --
Specifies configurations for storage in Amazon Redshift.
databaseName (string) --
The name of the Amazon Redshift database.
queryEngineConfiguration (dict) --
Specifies configurations for an Amazon Redshift query engine.
type (string) --
The type of query engine.
serverlessConfiguration (dict) --
Specifies configurations for a serverless Amazon Redshift query engine.
workgroupArn (string) --
The ARN of the Amazon Redshift workgroup.
authConfiguration (dict) --
Specifies configurations for authentication to an Amazon Redshift provisioned data warehouse.
type (string) --
The type of authentication to use.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
provisionedConfiguration (dict) --
Specifies configurations for a provisioned Amazon Redshift query engine.
clusterIdentifier (string) --
The ID of the Amazon Redshift cluster.
authConfiguration (dict) --
Specifies configurations for authentication to Amazon Redshift.
type (string) --
The type of authentication to use.
databaseUser (string) --
The database username for authentication to an Amazon Redshift provisioned data warehouse.
usernamePasswordSecretArn (string) --
The ARN of an Secrets Manager secret for authentication.
queryGenerationConfiguration (dict) --
Specifies configurations for generating queries.
executionTimeoutSeconds (integer) --
The time after which query generation will time out.
generationContext (dict) --
Specifies configurations for context to use during query generation.
tables (list) --
An array of objects, each of which defines information about a table in the database.
(dict) --
Contains information about a table for the query engine to consider.
name (string) --
The name of the table for which the other fields in this object apply.
description (string) --
A description of the table that helps the query engine understand the contents of the table.
inclusion (string) --
Specifies whether to include or exclude the table during query generation. If you specify EXCLUDE, the table will be ignored. If you specify INCLUDE, all other tables will be ignored.
columns (list) --
An array of objects, each of which defines information about a column in the table.
(dict) --
Contains information about a column in the current table for the query engine to consider.
name (string) --
The name of the column for which the other fields in this object apply.
description (string) --
A description of the column that helps the query engine understand the contents of the column.
inclusion (string) --
Specifies whether to include or exclude the column during query generation. If you specify EXCLUDE, the column will be ignored. If you specify INCLUDE, all other columns in the table will be ignored.
curatedQueries (list) --
An array of objects, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
(dict) --
Contains configurations for a query, each of which defines information about example queries to help the query engine generate appropriate SQL queries.
naturalLanguage (string) --
An example natural language query.
sql (string) --
The SQL equivalent of the natural language query.
storageConfiguration (dict) --
Contains details about the storage configuration of the knowledge base.
type (string) --
The vector store service in which the knowledge base is stored.
opensearchServerlessConfiguration (dict) --
Contains the storage configuration of the knowledge base in Amazon OpenSearch Service.
collectionArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch Service vector store.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
opensearchManagedClusterConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in OpenSearch Managed Cluster. For more information, see Create a vector index in Amazon OpenSearch Service.
domainEndpoint (string) --
The endpoint URL the OpenSearch domain.
domainArn (string) --
The Amazon Resource Name (ARN) of the OpenSearch domain.
vectorIndexName (string) --
The name of the vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
pineconeConfiguration (dict) --
Contains the storage configuration of the knowledge base in Pinecone.
connectionString (string) --
The endpoint URL for your index management page.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Pinecone API key.
namespace (string) --
The namespace to be used to write new data to your database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
redisEnterpriseCloudConfiguration (dict) --
Contains the storage configuration of the knowledge base in Redis Enterprise Cloud.
endpoint (string) --
The endpoint URL of the Redis Enterprise Cloud database.
vectorIndexName (string) --
The name of the vector index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Redis Enterprise Cloud database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
rdsConfiguration (dict) --
Contains details about the storage configuration of the knowledge base in Amazon RDS. For more information, see Create a vector index in Amazon RDS.
resourceArn (string) --
The Amazon Resource Name (ARN) of the vector store.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that is linked to your Amazon RDS database.
databaseName (string) --
The name of your Amazon RDS database.
tableName (string) --
The name of the table in the database.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
primaryKeyField (string) --
The name of the field in which Amazon Bedrock stores the ID for each entry.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
customMetadataField (string) --
Provide a name for the universal metadata field where Amazon Bedrock will store any custom metadata from your data source.
mongoDbAtlasConfiguration (dict) --
Contains the storage configuration of the knowledge base in MongoDB Atlas.
endpoint (string) --
The endpoint URL of your MongoDB Atlas cluster for your knowledge base.
databaseName (string) --
The database name in your MongoDB Atlas cluster for your knowledge base.
collectionName (string) --
The collection name of the knowledge base in MongoDB Atlas.
vectorIndexName (string) --
The name of the MongoDB Atlas vector search index.
credentialsSecretArn (string) --
The Amazon Resource Name (ARN) of the secret that you created in Secrets Manager that contains user credentials for your MongoDB Atlas cluster.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
vectorField (string) --
The name of the field in which Amazon Bedrock stores the vector embeddings for your data sources.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
endpointServiceName (string) --
The name of the VPC endpoint service in your account that is connected to your MongoDB Atlas cluster.
textIndexName (string) --
The name of the text search index in the MongoDB collection. This is required for using the hybrid search feature.
neptuneAnalyticsConfiguration (dict) --
Contains details about the Neptune Analytics configuration of the knowledge base in Amazon Neptune. For more information, see Create a vector index in Amazon Neptune Analytics..
graphArn (string) --
The Amazon Resource Name (ARN) of the Neptune Analytics vector store.
fieldMapping (dict) --
Contains the names of the fields to which to map information about the vector store.
textField (string) --
The name of the field in which Amazon Bedrock stores the raw text from your data. The text is split according to the chunking strategy you choose.
metadataField (string) --
The name of the field in which Amazon Bedrock stores metadata about the vector store.
s3VectorsConfiguration (dict) --
The configuration settings for storing knowledge base data using S3 vectors. This includes vector index information and S3 bucket details for vector storage.
vectorBucketArn (string) --
The Amazon Resource Name (ARN) of the S3 bucket where vector embeddings are stored. This bucket contains the vector data used by the knowledge base.
indexArn (string) --
The Amazon Resource Name (ARN) of the vector index used for the knowledge base. This ARN identifies the specific vector index resource within Amazon Bedrock.
indexName (string) --
The name of the vector index used for the knowledge base. This name identifies the vector index within the Amazon Bedrock service.
status (string) --
The status of the knowledge base. The following statuses are possible:
CREATING – The knowledge base is being created.
ACTIVE – The knowledge base is ready to be queried.
DELETING – The knowledge base is being deleted.
UPDATING – The knowledge base is being updated.
FAILED – The knowledge base API operation failed.
createdAt (datetime) --
The time the knowledge base was created.
updatedAt (datetime) --
The time the knowledge base was last updated.
failureReasons (list) --
A list of reasons that the API operation on the knowledge base failed.
(string) --