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 et les 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 à votre rôle de service de base de connaissances l'accès au rôle de service. Les exemples suivants indiquent les instructions minimales requises.

Cross-account politique des compartiments

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

{
    "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 des instructions plus générales, consultez la section Configuration de l'accès aux compartiments Amazon S3.

Politique de clé 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 l'instruction suivante à la politique de clé. 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": "*"
}

Ce "Resource": "*" champ s'applique à 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 la liste déroulante des sources de données.

3. Sous Emplacement de la source de données, choisissez 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 du document (.metadata.json) sont stockés pour cette source de données.

6. (Facultatif) Développez les modèles de filtre de préfixe 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 de regex afin d'inclure ou d'exclure des fichiers spécifiques.

8. (Facultatif) Pour activer le contrôle d'accès au niveau des documents, 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 CreateDataSource demande 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 compartiment 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 qui suit.

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 sur aclEnabled true et ajoutez un aclConfiguration avec. globalAccessControlListS3Uri Consultez Document-level contrôles d'accès.

Pour les bases de connaissances gérées, CreateDataSource est asynchrone : l'état de la source de données passe du statut de la source de données CREATING à la AVAILABLE fin de l'opération.

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 connecteur dansconnectorParameters. Pour les champs encapsulés connectorParameters (tels que deletionProtectionConfiguration etmediaExtractionConfiguration), consultezConnexion d’une sources de données.

Fichiers de métadonnées des documents

Vous pouvez joindre des métadonnées à chaque document en chargeant un fichier annexe à côté de 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 exemple, à côtéreport.pdf, téléchargez 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.