View a markdown version of this page

连接数据来源 - Amazon Bedrock

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

连接数据来源

完成知识库的配置后，您需要将支持的数据来源连接到知识库。

Amazon Bedrock 托管知识库支持连接到非结构化数据源。选择一个主题以了解如何连接到相应类型的数据来源：

注意

对于托管知识库，该CreateDataSource操作是异步的。操作完成后，数据源状态CREATING将AVAILABLE从变为。

要了解如何使用 Amazon Bedrock 控制台连接到数据来源，请在本页面底部选择与您的数据来源类型对应的主题：

要使用 Amazon Bedrock API 连接到数据源，请使用亚马逊 B edrock 运行时终端节点代理发送CreateDataSource请求。

必填字段：

字段 说明
knowledgeBaseId 知识库的 ID。
name 数据源的名称。
dataSourceConfiguration 在type字段中指定数据源类型并包括相应的配置。有关连接器特定配置的更多详细信息，请从本页底部的主题中选择连接器的主题。

在dataSourceConfiguration中，必须指定以下内容：

  • type – 必须为 MANAGED_KNOWLEDGE_BASE_CONNECTOR。

  • managedKnowledgeBaseConnectorConfiguration— 连接器的配置。包含以下字段：

    • connectorParameters（必填）-包含一个指定连接器类型的type字段和一个设置为的必填version字段1。支持的类型值为S3ONEDRIVE、CONFLUENCE、SHAREPOINT、WEB_CRAWLER、和GOOGLE_DRIVE。其余字段因连接器类型connectorParameters而异 — 有关更多详细信息，请参阅每个数据连接器页面。

    • deletionProtectionConfiguration（可选）— 防止意外批量删除已编入索引的内容的防范措施。包含deletionProtectionStatus（ENABLED或DISABLED），启用后还包含一个可选的deletionProtectionThreshold（0—100，默认为 15）。阈值是同步任务可以从您的索引中删除的最大文档百分比。如果同步删除的内容超过此百分比，则同步会跳过其删除阶段，将已编入索引的文档保留在原处。自定义连接器不支持。

    • mediaExtractionConfiguration（可选）-用于从数据源文件中提取媒体（图像、音频、视频）的配置。

可选字段：

字段 说明
description 提供数据源的描述。
vectorIngestionConfiguration 包含用于自定义摄取过程的配置。有关更多信息，请参阅 自定义数据来源的摄取。
clientToken 确保 API 请求仅完成一次。有关更多信息，请参阅确保幂等性。

以下示例显示了使用 S3 连接器的CreateDataSource请求：

{
    "knowledgeBaseId": "your-knowledge-base-id",
    "name": "my-s3-data-source",
    "description": "S3 data source for my managed knowledge base",
    "dataSourceConfiguration": {
        "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
        "managedKnowledgeBaseConnectorConfiguration": {
            "mediaExtractionConfiguration": {
                "imageExtractionConfiguration": {
                    "imageExtractionStatus": "ENABLED"
                }
            },
            "deletionProtectionConfiguration": {
                "deletionProtectionStatus": "ENABLED",
                "deletionProtectionThreshold": 15
            },
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "my-bucket-name",
                    "bucketOwnerAccountId": "123456789012"
                },
                "filterConfiguration": {
                    "maxFileSizeInMegaBytes": "50"
                }
            }
        }
    }
}

要了解有关特定连接器及其配置的更多信息，请在下面选择一个主题。

主题