本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Amazon S3

Amazon S3 是將資料當做物件存放在儲存貯體中的物件儲存服務。您可以連接 Amazon S3 儲存貯體做為受管知識庫的資料來源，以擷取您存放在其中的物件。

支援的功能

先決條件

在 Amazon S3 中，請確定您：

在您的帳戶中 AWS ，請確定您：

跨帳戶和 KMS 加密存取的儲存貯體政策

如果您的 Amazon S3 儲存貯體位於與知識庫不同的 AWS 帳戶中，或者使用客戶受管 KMS 金鑰加密，請新增資源型政策來授予知識庫服務角色存取權。下列範例顯示所需的最低陳述式。

跨帳戶儲存貯體政策

在擁有 Amazon S3 儲存貯體的帳戶中，將下列陳述式新增至儲存貯體政策。將 kb-account-id 取代為建立知識庫的帳戶 ID、將 kb-service-role 取代為知識庫服務角色的名稱，將 bucket-name 取代為儲存貯體名稱。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowBedrockKnowledgeBaseAccess",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::kb-account-id:role/kb-service-role"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name",
                "arn:aws:s3:::bucket-name/*"
            ]
        }
    ]
}

如需更多一般指引，請參閱設定對 Amazon S3 儲存貯體的存取。

加密儲存貯體的 KMS 金鑰政策

如果您的 Amazon S3 儲存貯體使用客戶受管 KMS 金鑰加密，請將下列陳述式新增至金鑰政策。使用與跨帳戶儲存貯體政策中相同的預留位置。金鑰政策變更需要幾分鐘的時間才能傳播。

{
    "Sid": "AllowBedrockKnowledgeBaseKmsAccess",
    "Effect": "Allow",
    "Principal": {
        "AWS": "arn:aws:iam::kb-account-id:role/kb-service-role"
    },
    "Action": [
        "kms:Decrypt",
        "kms:DescribeKey"
    ],
    "Resource": "*"
}

"Resource": "*" 此處的範圍為政策所連接的金鑰。

如何設定 Amazon S3 資料來源

設定 Amazon S3 資料來源包含下列步驟：

建立資料來源

Console

將 Amazon S3 儲存貯體連接至您的受管知識庫

1. 在資料來源下，提供資料來源的名稱。

2. 從資料來源下拉式清單中選取 Amazon S3。

3. 在資料來源位置下，選擇 Amazon S3 儲存貯體是否位於此 AWS 帳戶或其他 AWS 帳戶中。

4. 輸入儲存貯體的 Amazon S3 URI。您可以選擇瀏覽 S3 來選取儲存貯體。

5. （選用） 輸入中繼資料檔案字首 — Amazon S3 字首，其中存放此資料來源的文件中繼資料檔案 (.metadata.json)。

6. （選用） 展開 S3 字首篩選條件模式，以包含或排除特定路徑。

7. （選用） 展開檔案篩選模式以新增 regex 模式，以包含或排除特定檔案。

8. （選用） 若要啟用文件層級存取控制，請選取使用 ACLs 控制文件存取，並提供全域 ACL 檔案的 Amazon S3 URI。此選項無法在建立後變更。如需詳細資訊，請參閱文件層級存取控制。

API

若要建立 Amazon S3 資料來源，請使用 Amazon Bedrock 建置時間端點的代理程式傳送 CreateDataSource 請求。下列 AWS Command Line Interface 範例會為相同帳戶中的儲存貯體建立資料來源，其中包含字首和模式篩選條件。如需每個欄位的說明，請參閱以下連接器參數參考。

aws bedrock-agent create-data-source \
 --name "S3-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://s3-managed-connector.json

s3-managed-connector.json 檔案包含下列項目：

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "S3",
            "version": "1",
            "connectionConfiguration": {
                "bucketName": "my-knowledge-base-bucket",
                "bucketOwnerAccountId": "123456789012"
            },
            "filterConfiguration": {
                "inclusionPrefixes": ["documents/"],
                "inclusionPatterns": [".*\\.pdf", ".*\\.txt"],
                "exclusionPatterns": [".*\\.tmp"]
            },
            "metadataFilesPrefix": "metadata/"
        }
    }
}

若要啟用文件層級存取控制，aclEnabled請將 設定為 aclConfiguration，true並使用 新增 globalAccessControlListS3Uri。請參閱 文件層級存取控制。

對於受管知識庫， CreateDataSource是非同步的：當操作完成CREATINGAVAILABLE時，資料來源狀態會從 轉換為 。

連接器參數

資料來源組態使用下列連接器參數。若要連線至 Amazon S3，請在 中將 指定S3為連接器類型connectorParameters。如需包裝的欄位 connectorParameters（例如 deletionProtectionConfiguration和 mediaExtractionConfiguration)，請參閱 連接資料來源。

文件中繼資料檔案

您可以上傳附屬檔案，將中繼資料連接到每個文件。針對每個文件，在相同的 Amazon S3 路徑filename.extension.metadata.json中建立名為 的檔案。中繼資料檔案不得超過 10 KB。例如，除了 之外report.pdf，report.pdf.metadata.json使用下列內容上傳 ：

{
    "metadataAttributes": {
        "company": {
            "value": {
                "type": "STRING",
                "stringValue": "BioPharm Innovations"
            }
        },
        "created_date": {
            "value": {
                "type": "NUMBER",
                "numberValue": 20221205
            }
        },
        "author": {
            "value": {
                "type": "STRING",
                "stringValue": "Lisa Thompson"
            }
        }
    }
}

如需支援的屬性資料類型和您可以在查詢時間套用的篩選運算子的相關資訊，請參閱中繼資料和篩選。