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

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

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

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

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

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

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

ナレッジベースをカスタムデータソースに接続するには、Agents for 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 回だけ完了するようにするため。詳細については、「べき等性の確保」を参照してください。
serverSideEncryption設定	データを埋め込みに変換する際に、一時データストレージのカスタムKMSキーを指定するには。詳細については、「データインジェスト時の一時データストレージの暗号化」を参照してください
dataDeletionPolicy	データソースを削除する場合に、ベクトルストアのデータソースのベクトル埋め込みで何をするかを設定するには。ベクトルストアにデータを保持するRETAINには DELETEを指定し、削除するには のデフォルトオプションを指定します。
vectorIngestionConfiguration	データソースの取り込みオプションを設定するには。詳細については、以下を参照してください。

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

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

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

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

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