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

# 連接資料來源
<a name="kb-managed-connect-ds"></a>

完成知識庫的設定後，您就可以將支援的資料來源連結到知識庫。

Amazon Bedrock 受管知識庫支援連線至非結構化資料來源。選取主題以了解如何連結至該類型的資料來源：

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

若要了解如何使用 Amazon Bedrock 主控台連結至資料來源，請選取此頁面底部的與資料來源類型對應的主題：

若要使用 Amazon Bedrock API 連結至資料來源，請使用 [Amazon Bedrock 代理人執行時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt)傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。

**必要欄位：**



| 欄位 | 說明 | 
| --- | --- | 
| knowledgeBaseId | 知識庫的 ID。 | 
| name | 資料來源的名稱。 | 
| dataSourceConfiguration | 在 type 欄位中指定資料來源類型，並包含對應的組態。如需連接器特定組態的詳細資訊，請從此頁面底部的主題中選取連接器的主題。 | 

在 中`dataSourceConfiguration`，您必須指定下列項目：
+ `type` - 必須為 `MANAGED_KNOWLEDGE_BASE_CONNECTOR`。
+ `managedKnowledgeBaseConnectorConfiguration` – 連接器的組態。包含下列欄位：
  + `connectorParameters` （必要） – 包含指定連接器類型的`type`欄位，以及將必要`version`欄位設定為 `1`。支援的類型值為 `S3`、`ONEDRIVE`、`CONFLUENCE`、`WEB_CRAWLER`、 `SHAREPOINT`和 `GOOGLE_DRIVE`。中的其餘欄位會因連接器類型`connectorParameters`而有所不同 — 如需詳細資訊，請參閱每個資料連接器頁面。
  + `deletionProtectionConfiguration` （選用） – 防止索引內容意外大量刪除的防護措施。包含 `deletionProtectionStatus`(`ENABLED` 或 `DISABLED`)，啟用時為選用 `deletionProtectionThreshold`(0–100，預設為 15)。閾值是同步任務可以從索引中刪除的文件百分比上限。如果同步會刪除超過此百分比，同步會略過其刪除階段，並保留您的索引文件。自訂連接器不支援 。
  + `mediaExtractionConfiguration` （選用） – 從資料來源檔案擷取媒體 （影像、音訊、影片） 的組態。包含三個您可以獨立啟用的子組態：
    + `imageExtractionConfiguration` （選用） – 從 .pdf、.docx、.ppt、.pptx 檔案中的獨立映像檔案 (.png、.jpg、.jpeg、.jpe、.tif、.tiff、.gif、.bmp、.webp、.svg、.jp2、.heic) 和內嵌視覺效果中處理、擷取和索引內容。
    + `audioExtractionConfiguration` （選用） – 從支援的音訊檔案 (.mp3、.wav、.m4a、.flac、.ogg) 處理、擷取和索引內容。
    + `videoExtractionConfiguration` （選用） – 從支援的影片檔案 (.mp4、.mov、.m4v) 處理、擷取和索引內容。

    如需完整欄位參考，請參閱《Amazon Bedrock API 參考》中的 [MediaExtractionConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_MediaExtractionConfiguration.html)。
  + `syncSchedule` （選用） – 設定 Amazon Bedrock 自動同步資料來源的週期性排程。請明確指定下列其中一項：
    + `daily` – 空的物件。每天在系統選擇的離峰時間同步一次。
    + `weekly` – 包含必要`dayOfWeek`欄位，值從 `SUNDAY`到 `SATURDAY`。
    + `monthly` – 包含必要`dayOfMonth`欄位，其中包含`dayNumber`從 1 到 28 的 或空`lastDayOfMonth`物件。

    省略`syncSchedule`僅隨需同步。如需詳細資訊，請參閱[設定資料來源的同步排程](kb-managed-sync.md#kb-managed-sync-schedule)。

**選用欄位：**



| 欄位 | 說明 | 
| --- | --- | 
| description | 提供資料來源的說明。 | 
| vectorIngestionConfiguration | 包含用於自訂擷取程序的組態。如需詳細資訊，請參閱[自訂資料來源的擷取](kb-managed-customize-ingestion.md)。 | 
| clientToken | 為確保 API 請求，僅完成一次。如需詳細資訊，請參閱[確保冪等性](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html)。 | 

下列範例顯示具有 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
            },
            "syncSchedule": {
                "weekly": {
                    "dayOfWeek": "MONDAY"
                }
            },
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "{{my-bucket-name}}",
                    "bucketOwnerAccountId": "{{123456789012}}"
                },
                "filterConfiguration": {
                    "maxFileSizeInMegaBytes": "50"
                }
            }
        }
    }
}
```

若要進一步了解特定連接器及其組態，請選取下列主題。

對於支援使用者受管設定 (3LO) 的第三方資料來源，例如 SharePoint、 OneDrive和 Confluence，您需要特定 AWS Identity and Access Management 許可才能登入。如需詳細資訊，請參閱[使用者受管設定的 IAM 許可 (3LO)](kb-managed-3lo-setup.md)。

**Topics**
+ [使用者受管設定的 IAM 許可 (3LO)](kb-managed-3lo-setup.md)
+ [Box (立方體)](kb-managed-ds-box.md)
+ [Amazon S3](kb-managed-ds-s3.md)
+ [Confluence](kb-managed-ds-confluence.md)
+ [Confluence 資料中心](kb-managed-ds-confluence-onprem.md)
+ [Custom](kb-managed-ds-custom.md)
+ [Google 雲端硬碟](kb-managed-ds-googledrive.md)
+ [Microsoft OneDrive](kb-managed-ds-onedrive.md)
+ [ServiceNow](kb-managed-ds-servicenow.md)
+ [Microsoft SharePoint](kb-managed-ds-sharepoint.md)
+ [Web 編目程式](kb-managed-ds-webcrawler.md)
+ [設定資料來源的 VPC 連線](kb-managed-vpc-configuration.md)