ナレッジベースをカスタムデータソースに接続する

サポートされているデータソースサービスを選択する代わりに、カスタムデータソースに接続すると、次の利点があります。

• ナレッジベースがアクセスできるようにするデータ型の柔軟性と制御。

• KnowledgeBaseDocuments API オペレーションを使用して、変更を同期しなくてもドキュメントを直接取り込みまたは削除できます。

• Amazon Bedrock コンソールまたは API を使用して、データソース内のドキュメントを直接表示する機能。

• でドキュメントをデータソースに直接アップロード AWS Management Console したり、インラインで追加したりできます。

• データソースでドキュメントを追加または更新するときに、 の各ドキュメントにメタデータを直接追加する機能。データソースから情報を取得するときにメタデータを使用してフィルタリングする方法の詳細については、「」の「メタデータとフィルタリング」タブを参照してくださいクエリとレスポンスの生成を設定してカスタマイズする。

ナレッジベースをカスタムデータソースに接続するには、Amazon Bedrock エージェントのビルドタイムエンドポイントを使用して CreateDataSource リクエストを送信します。接続するknowledgeBaseIdナレッジベースの を指定し、 nameをデータソースに渡し、 の typeフィールドを dataSourceConfigurationとして指定しますCUSTOM。このデータソースを作成する最小限の例を次に示します。

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

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

データソースを設定するには、次のいずれかのオプションフィールドを含めることができます。

フィールド	ユースケース
description	データソースの説明を入力します。
clientToken	API リクエストが 1 回だけ完了するようにします。詳細については、「べき等性の確保」を参照してください。
serverSideEncryptionConfiguration	データを埋め込みに変換する際に、一時データストレージのカスタム KMS キーを指定するには。詳細については、「データインジェスト時の一時データストレージの暗号化」を参照してください
dataDeletionPolicy	データソースを削除する場合に、ベクトルストアのデータソースのベクトル埋め込みで何をするかを設定するには。ベクトルストアにデータを保持するRETAINには を指定し、削除するDELETEには のデフォルトオプションを指定します。
vectorIngestionConfiguration	データソースの取り込みオプションを設定します。詳細については、以下を参照してください。

vectorIngestionConfiguration フィールドは、次のフィールドを含む VectorIngestionConfiguration オブジェクトにマッピングされます。

• chunkingConfiguration – データソース内のドキュメントをチャンキングするために使用する戦略を設定します。チャンキング戦略の詳細については、「」を参照してくださいナレッジベースでのコンテンツチャンキングの仕組み。

• parsingConfiguration – データソースの解析に使用する戦略を設定します。解析オプションの詳細については、「」を参照してくださいデータソースの解析オプション。

• customTransformationConfiguration – データの変換方法をカスタマイズし、Lambda 関数を適用してカスタマイズを強化します。Lambda 関数を使用してデータのチャンキングとメタデータの処理をカスタマイズする方法の詳細については、「」を参照してくださいカスタム変換 Lambda 関数を使用してデータの取り込み方法を定義する。

カスタムデータソースを設定したら、ドキュメントを追加してナレッジベースに直接取り込むことができます。他のデータソースとは異なり、カスタムデータソースを同期する必要はありません。ドキュメントを直接取り込む方法については、「」を参照してくださいナレッジベースに直接変更を取り込む。