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

# 將知識庫連結到自訂資料來源
<a name="custom-data-source-connector"></a>

您可以連結到自訂資料來源以享有下列優點，而不是選擇支援的資料來源服務：
+ 對您希望知識庫能夠存取的資料類型的彈性和控制。
+ 能夠使用 `KnowledgeBaseDocuments` API 操作直接擷取或刪除文件，而無需同步變更。
+ 能夠直接透過 Amazon Bedrock 主控台或 API 檢視資料來源中的文件。
+ 能夠直接在 中將文件上傳至資料來源， AWS 管理主控台 或內嵌新增文件。
+ 在資料來源中新增或更新文件時，可以直接將中繼資料新增至每個文件。如需從資料來源擷取資訊時如何使用中繼資料進行篩選的詳細資訊，請參閱[設定和自訂查詢和回應產生](kb-test-config.md)中的**中繼資料和篩選**索引標籤。

**多模態內容支援**  
自訂資料來源支援多模式內容，包括高達 10MB base64 編碼的影像、音訊和影片檔案。如需使用多模態內容的完整指引，請參閱 [建立多模態內容的知識庫](kb-multimodal.md)。

若要將知識庫連結到自訂資料來源，請使用 [Amazon Bedrock 代理人建置時期端點](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt)傳送 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 請求。指定要連結至其中的知識庫 `knowledgeBaseId`，將 `name` 提供給資料來源，並將 `dataSourceConfiguration` 中的 `type` 欄位指定為 `CUSTOM`。以下顯示建立此資料來源的最基本範例：

```
PUT /knowledgebases/{{KB12345678}}/datasources/ HTTP/1.1
Content-type: application/json

{
    "name": "MyCustomDataSource",
    "dataSourceConfiguration": {
        "type": "CUSTOM"
    }
}
```

您可以包含下列任何選用欄位來設定資料來源：


****  

| 欄位 | 使用案例 | 
| --- | --- | 
| description | 提供資料來源的描述。 | 
| clientToken | 為確保 API 請求，僅完成一次。如需詳細資訊，請參閱[確保冪等性](https://docs.aws.amazon.com/ec2/latest/devguide/ec2-api-idempotency.html)。 | 
| serverSideEncryptionConfiguration | 將資料轉換為嵌入時，為暫時性資料儲存指定自訂 KMS 金鑰。如需詳細資訊，請參閱[資料擷取期間的暫時性資料儲存加密](encryption-kb.md#encryption-kb-ingestion) | 
| dataDeletionPolicy | 如果您刪除資料來源，請為向量存放區中的資料來源設定向量嵌入的操作。指定 RETAIN 來保留向量存放區中的資料，或指定 DELETE 的預設選項來刪除這些資料。 | 
| vectorIngestionConfiguration | 設定資料來源的擷取選項。如需詳細資訊，請參閱下方。 | 

`vectorIngestionConfiguration` 欄位會對應至包含下列欄位的 [VectorIngestionConfiguration](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_VectorIngestionConfiguration.html) 物件：
+ chunkingConfiguration：設定策略，此策略會用於將資料來源中的文件分塊。如需有關分塊策略的詳細資訊，請參閱[內容群集如何適用於知識庫](kb-chunking.md)。
+ parsingConfiguration：設定用於剖析資料來源的策略。如需剖析選項的詳細資訊，請參閱[剖析資料來源的選項](kb-advanced-parsing.md)。
+ customTransformationConfiguration：自訂資料轉換的方式，以及套用 Lambda 函式以實現更多的自訂。如需如何使用 Lambda 函式自訂資料分塊和處理中繼資料的詳細資訊，請參閱[使用自訂轉換 Lambda 函式來定義如何擷取您的資料](kb-custom-transformation.md)。

設定自訂資料來源之後，您可以將文件新增至其中，並直接將其擷取至知識庫。與其他資料來源不同，您不需要同步自訂資料來源。若要了解如何直接擷取文件，請參閱[將變更直接擷取到知識庫](kb-direct-ingestion.md)。