As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Amazon S3

O Amazon S3 é um serviço de armazenamento de objetos que armazena dados como objetos em buckets. Você pode conectar um bucket do Amazon S3 como fonte de dados para sua base de conhecimento gerenciada para ingerir os objetos que você armazena lá.

Recursos compatíveis

Pré-requisitos

No Amazon S3, verifique se:

Em sua AWS conta, certifique-se de:

Políticas de bucket para acesso e KMS-encrypted contas cruzadas

Se o bucket do Amazon S3 estiver em uma AWS conta diferente da sua base de conhecimento ou se estiver criptografado com uma chave KMS gerenciada pelo cliente, adicione uma política baseada em recursos para conceder acesso à função de serviço da sua base de conhecimento. Os exemplos a seguir mostram as declarações mínimas necessárias.

Cross-account política de bucket

Na conta que possui o bucket do Amazon S3, adicione a seguinte declaração à política do bucket. kb-account-idSubstitua pelo ID da conta em que sua base de conhecimento foi criada, kb-service-role pelo nome da função de serviço da base de conhecimento e bucket-name pelo nome do 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/*"
            ]
        }
    ]
}

Para obter mais orientações gerais, consulte Configurar o acesso aos buckets do Amazon S3.

Política de chaves do KMS para buckets criptografados

Se seu bucket do Amazon S3 estiver criptografado com uma chave KMS gerenciada pelo cliente, adicione a seguinte declaração à política de chaves. Use os mesmos espaços reservados da política de compartimento entre contas. Aguarde alguns minutos para que as principais mudanças na política se propaguem.

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

O "Resource": "*" aqui abrange a chave à qual a política está anexada.

Como configurar uma fonte de dados do Amazon S3

A configuração de uma fonte de dados do Amazon S3 envolve as seguintes etapas:

Crie a fonte de dados

Console

Para conectar um bucket do Amazon S3 à sua base de conhecimento gerenciada

1. Em Fonte de dados, forneça um nome para sua fonte de dados.

2. Selecione Amazon S3 na lista suspensa da fonte de dados.

3. Em Localização da fonte de dados, escolha se o bucket do Amazon S3 está em Esta conta da AWS ou em Outra conta da AWS.

4. Insira o URI do Amazon S3 do seu bucket. Você pode escolher Browse S3 para selecionar um bucket.

5. (Opcional) Insira um prefixo de arquivos de metadados — o prefixo do Amazon S3 em que os arquivos de metadados do documento .metadata.json () são armazenados para essa fonte de dados.

6. (Opcional) Expanda os padrões de filtro de prefixo do S3 para incluir ou excluir caminhos específicos.

7. (Opcional) Expanda Padrões de filtro de arquivo para adicionar padrões de regex para incluir ou excluir arquivos específicos.

8. (Opcional) Para habilitar o controle de acesso em nível de documento, selecione Controlar acesso a documentos com ACLs e forneça o URI do Amazon S3 do seu arquivo ACL global. Essa opção não pode ser alterada após a criação. Para obter detalhes, consulte Document-level controles de acesso.

API

Para criar uma fonte de dados do Amazon S3, envie uma CreateDataSourcesolicitação com um endpoint de tempo de construção do Agents for Amazon Bedrock. O AWS Command Line Interface exemplo a seguir cria uma fonte de dados para um bucket na mesma conta, com filtros de prefixo e padrão. Para obter uma descrição de cada campo, consulte a referência de parâmetros do conector a seguir.

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

O s3-managed-connector.json arquivo contém o seguinte:

{
    "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/"
        }
    }
}

Para ativar o controle de acesso em nível de documento, aclEnabled defina true e adicione um aclConfiguration com. globalAccessControlListS3Uri Consulte Document-level controles de acesso.

Para bases de conhecimento gerenciadas, CreateDataSource é assíncrono: o status da fonte de dados muda de CREATING para AVAILABLE quando a operação é concluída.

Parâmetros do conector

A configuração da fonte de dados usa os seguintes parâmetros do conector. Para se conectar ao Amazon S3, especifique S3 como tipo de conector. connectorParameters Para os campos que são agrupados connectorParameters (como deletionProtectionConfiguration emediaExtractionConfiguration), consulteConectar uma fonte de dados.

Arquivos de metadados do documento

Você pode anexar metadados a cada documento fazendo o upload de um arquivo auxiliar ao lado dele. Para cada documento, crie um arquivo nomeado filename.extension.metadata.json no mesmo caminho do Amazon S3. O arquivo de metadados não deve exceder 10 KB. Por exemplo, ao ladoreport.pdf, faça o upload report.pdf.metadata.json com o seguinte conteúdo:

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

Para obter informações sobre os tipos de dados de atributos suportados e os operadores de filtragem que você pode aplicar no momento da consulta, consulte Metadados e filtragem.