View a markdown version of this page

连接数据来源 - Amazon Bedrock

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

连接数据来源

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

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

注意

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

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

要使用亚马逊 Bedrock API 连接到数据源，请使用亚马逊 Bedrock 代理运行时终端节点发送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（可选）-用于从数据源文件中提取媒体（图像、音频、视频）的配置。包含三个可以独立启用的子配置：

      • imageExtractionConfiguration（可选）— 处理、提取和索引来自独立图像文件（.png、.jpg、.jpeg、.jpe、.tif、.tif、.gif、.bmp、.webp、.svg、.jp2、.heic）的内容以及.pdf、.docx、.ppt、.ppt、.ppt、.ppt、.ppt、.ppt、.pptx 文件中的嵌入式视觉对象。

      • audioExtractionConfiguration（可选）— 处理、提取和索引支持的音频文件（.mp3、.wav、.m4a、.flac、.ogg）中的内容。

      • videoExtractionConfiguration（可选）-处理、提取和索引支持的视频文件（.mp4、.mov、.m4v）中的内容。

      有关完整的字段参考，请参阅亚马逊 Bedrock API 参考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"
                }
            }
        }
    }
}

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

主题