View a markdown version of this page

データソースを接続する - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

データソースを接続する

ナレッジベースの設定が完了したら、サポートされているデータソースをナレッジベースに接続します。

Amazon Bedrock マネージドナレッジベースは、非構造化データソースへの接続をサポートしています。各データソースへの接続方法については、各トピックを選択してください。

注記

マネージドナレッジベースの場合、CreateDataSourceオペレーションは非同期です。オペレーションが完了すると、データソースのステータスは から CREATING に移行AVAILABLEします。

Amazon Bedrock コンソールを使用してデータソースに接続する方法については、このページの下部に掲載のデータソースタイプに対応するトピックを選択してください。

Amazon Bedrock API を使用してデータソースに接続するには、Amazon Bedrock エージェントのランタイムエンドポイントを使用して、CreateDataSource リクエストを送信します。

必須フィールド:

フィールド 説明
knowledgeBaseId ナレッジベースの ID。
name データソースの名前。
dataSourceConfiguration type フィールドにデータソースタイプを指定し、対応する設定を含めます。コネクタ固有の設定の詳細については、このページの下部にあるトピックからコネクタのトピックを選択します。

内ではdataSourceConfiguration、以下を指定する必要があります。

  • type — MANAGED_KNOWLEDGE_BASE_CONNECTOR を指定する必要があります。

  • managedKnowledgeBaseConnectorConfiguration – コネクタの設定。以下のフィールドが含まれています。

    • connectorParameters (必須) – コネクタタイプtypeを指定するversionフィールドと、 に設定された必須フィールドが含まれます1。サポートされている型値は、S3、、ONEDRIVE、CONFLUENCE、SHAREPOINTWEB_CRAWLER、および ですGOOGLE_DRIVE。の残りのフィールドconnectorParametersはコネクタタイプによって異なります。詳細については、各データコネクタページを参照してください。

    • deletionProtectionConfiguration (オプション) – インデックス付きコンテンツの偶発的な一括削除に対する保護。deletionProtectionStatus (ENABLED または DISABLED) と、有効にするとオプションの deletionProtectionThreshold (0～100、デフォルトは 15) が含まれます。しきい値は、同期ジョブがインデックスから削除できるドキュメントの最大パーセンテージです。同期がこの割合を超えて削除する場合、同期は削除フェーズをスキップし、インデックス化されたドキュメントはそのまま残ります。カスタムコネクタではサポートされていません。

    • mediaExtractionConfiguration (オプション) – データソースファイルからメディア (イメージ、オーディオ、ビデオ) を抽出するための設定。

オプションのフィールド:

フィールド 説明
description データソースの説明を入力します。
vectorIngestionConfiguration 取り込みプロセスをカスタマイズするための設定が含まれています。詳細については、「データソースの取り込みをカスタマイズする」を参照してください。
clientToken API リクエストが 1 回だけ完了するようにします。詳細については、「べき等性の確保」を参照してください。

次の例は、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
            },
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "my-bucket-name",
                    "bucketOwnerAccountId": "123456789012"
                },
                "filterConfiguration": {
                    "maxFileSizeInMegaBytes": "50"
                }
            }
        }
    }
}

特定のコネクタとその設定の詳細については、以下のトピックを選択してください。

トピック