Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Amazon S3

Amazon S3 est un service de stockage d’objets qui stocke les données en tant qu’objets dans des compartiments. Vous pouvez connecter un compartiment Amazon S3 en tant que source de données pour votre base de connaissances gérée afin d'ingérer les objets que vous y stockez.

Fonctionnalités prises en charge

Conditions préalables

Dans Amazon S3 :

Dans votre AWS compte, assurez-vous de :

Politiques relatives aux compartiments pour les comptes multiples et l'accès KMS-encrypted

Si votre compartiment Amazon S3 se trouve dans un AWS compte différent de celui de votre base de connaissances, ou s'il est chiffré à l'aide d'une clé KMS gérée par le client, ajoutez une politique basée sur les ressources pour accorder l'accès aux rôles de service de votre base de connaissances. Les exemples suivants indiquent le nombre minimum d'instructions requises.

Cross-account politique relative aux compartiments

Dans le compte propriétaire du compartiment Amazon S3, ajoutez l'instruction suivante à la politique du compartiment. kb-account-idRemplacez-le par l'ID du compte sur lequel votre base de connaissances a été créée, kb-service-role par le nom de votre rôle de service de base de connaissances et bucket-name par le nom de votre bucket.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowBedrockKnowledgeBaseAccess",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::kb-account-id:role/kb-service-role"
            },
            "Action": [
                "s3:GetObject",
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket-name",
                "arn:aws:s3:::bucket-name/*"
            ]
        }
    ]
}

Pour obtenir des conseils plus généraux, consultez Configurer l'accès aux compartiments Amazon S3.

Politique relative aux clés KMS pour les compartiments chiffrés

Si votre compartiment Amazon S3 est chiffré à l'aide d'une clé KMS gérée par le client, ajoutez la déclaration suivante à la politique en matière de clés. Utilisez les mêmes espaces réservés que dans la politique relative aux compartiments entre comptes. Attendez quelques minutes pour que les principaux changements de politique se propagent.

{
    "Sid": "AllowBedrockKnowledgeBaseKmsAccess",
    "Effect": "Allow",
    "Principal": {
        "AWS": "arn:aws:iam::kb-account-id:role/kb-service-role"
    },
    "Action": [
        "kms:Decrypt",
        "kms:DescribeKey"
    ],
    "Resource": "*"
}

Le champ d'application "Resource": "*" ici correspond à la clé à laquelle la politique est attachée.

Comment configurer une source de données Amazon S3

La configuration d'une source de données Amazon S3 implique les étapes suivantes :

Création de la source de données

Console

Pour connecter un compartiment Amazon S3 à votre base de connaissances gérée

1. Sous Source de données, donnez un nom à votre source de données.

2. Sélectionnez Amazon S3 dans le menu déroulant des sources de données.

3. Sous Emplacement de la source de données, indiquez si le compartiment Amazon S3 se trouve dans ce compte AWS ou dans un autre compte AWS.

4. Entrez l'URI Amazon S3 de votre compartiment. Vous pouvez choisir Browse S3 pour sélectionner un compartiment.

5. (Facultatif) Entrez un préfixe de fichiers de métadonnées, le préfixe Amazon S3 dans lequel les fichiers de métadonnées de document (.metadata.json) sont stockés pour cette source de données.

6. (Facultatif) Développez les modèles de filtres de préfixes S3 pour inclure ou exclure des chemins spécifiques.

7. (Facultatif) Développez les modèles de filtre de fichiers pour ajouter des modèles regex afin d'inclure ou d'exclure des fichiers spécifiques.

8. (Facultatif) Pour activer le contrôle d'accès au niveau du document, sélectionnez Contrôler l'accès aux documents avec des ACL et fournissez l'URI Amazon S3 de votre fichier ACL global. Cette option ne peut pas être modifiée après sa création. Pour en savoir plus, consultez Document-level contrôles d'accès.

API

Pour créer une source de données Amazon S3, envoyez une CreateDataSourcedemande avec un point de terminaison Agents for Amazon Bedrock Build-time. L' AWS Command Line Interface exemple suivant crée une source de données pour un bucket du même compte, avec des filtres de préfixes et de modèles. Pour une description de chaque champ, reportez-vous à la référence des paramètres du connecteur ci-dessous.

aws bedrock-agent create-data-source \
 --name "S3-connector" \
 --knowledge-base-id "your-knowledge-base-id" \
 --data-source-configuration file://s3-managed-connector.json

Le s3-managed-connector.json fichier contient les éléments suivants :

{
    "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
    "managedKnowledgeBaseConnectorConfiguration": {
        "connectorParameters": {
            "type": "S3",
            "version": "1",
            "connectionConfiguration": {
                "bucketName": "my-knowledge-base-bucket",
                "bucketOwnerAccountId": "123456789012"
            },
            "filterConfiguration": {
                "inclusionPrefixes": ["documents/"],
                "inclusionPatterns": [".*\\.pdf", ".*\\.txt"],
                "exclusionPatterns": [".*\\.tmp"]
            },
            "metadataFilesPrefix": "metadata/"
        }
    }
}

Pour activer le contrôle d'accès au niveau du document, définissez aclEnabled true et ajoutez un aclConfiguration with. globalAccessControlListS3Uri Consultez Document-level contrôles d'accès.

Pour les bases de connaissances gérées, CreateDataSource c'est asynchrone : le statut de la source de données passe de « CREATING à » AVAILABLE lorsque l'opération est terminée.

Paramètres du connecteur

La configuration de la source de données utilise les paramètres de connecteur suivants. Pour vous connecter à Amazon S3, spécifiez S3 le type de connecteurconnectorParameters. Pour les champs encapsulés connectorParameters (tels que deletionProtectionConfiguration etmediaExtractionConfiguration), reportez-vous à la sectionConnexion d’une sources de données.

Fichiers de métadonnées de documents

Vous pouvez joindre des métadonnées à chaque document en téléchargeant un fichier annexe à celui-ci. Pour chaque document, créez un fichier nommé filename.extension.metadata.json dans le même chemin Amazon S3. Le fichier de métadonnées ne doit pas dépasser 10 Ko. Par exemplereport.pdf, chargez en parallèle report.pdf.metadata.json avec le contenu suivant :

{
    "metadataAttributes": {
        "company": {
            "value": {
                "type": "STRING",
                "stringValue": "BioPharm Innovations"
            }
        },
        "created_date": {
            "value": {
                "type": "NUMBER",
                "numberValue": 20221205
            }
        },
        "author": {
            "value": {
                "type": "STRING",
                "stringValue": "Lisa Thompson"
            }
        }
    }
}

Pour plus d'informations sur les types de données attributaires pris en charge et les opérateurs de filtrage que vous pouvez appliquer au moment de la requête, consultez la section Métadonnées et filtrage.