View a markdown version of this page

Conectar uma fonte de dados - Amazon Bedrock

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á.

Conectar uma fonte de dados

Depois de concluir as configurações da base de conhecimento, conecte uma fonte de dados compatível a ela.

As bases de conhecimento gerenciadas do Amazon Bedrock oferecem suporte à conexão com fontes de dados não estruturadas. Selecione um tópico para saber como se conectar a esse tipo de fonte de dados:

nota

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

Para saber como se conectar a uma fonte de dados usando o console do Amazon Bedrock, selecione o tópico que corresponde ao seu tipo de fonte de dados na parte inferior desta página:

Para se conectar a uma fonte de dados usando a API do Amazon Bedrock, envie uma CreateDataSourcesolicitação com um endpoint de tempo de execução do Agents for Amazon Bedrock.

Campos obrigatórios:

Campo Description
knowledgeBaseId O ID da base de conhecimento.
name Um nome para a fonte de dados.
dataSourceConfiguration Especifique o tipo de fonte de dados no type campo e inclua a configuração correspondente. Para obter mais detalhes sobre configurações específicas do conector, selecione o tópico do conector nos tópicos na parte inferior desta página.

DentrodataSourceConfiguration, você deve especificar o seguinte:

  • type: deve ser MANAGED_KNOWLEDGE_BASE_CONNECTOR.

  • managedKnowledgeBaseConnectorConfiguration— Configuração do conector. Contém os seguintes campos:

    • connectorParameters(obrigatório) — Contém um type campo que especifica o tipo de conector e um version campo obrigatório definido como. 1 Os valores de tipo suportados são S3 ONEDRIVECONFLUENCE,SHAREPOINT,WEB_CRAWLER,, GOOGLE_DRIVE e. Os campos restantes connectorParameters diferem por tipo de conector — consulte a página de cada conector de dados para obter mais detalhes.

    • deletionProtectionConfiguration(opcional) — Uma proteção contra a exclusão acidental em massa do conteúdo indexado. Contém deletionProtectionStatus (ENABLEDouDISABLED) e, quando ativado, um opcional deletionProtectionThreshold (0—100, o padrão é 15). O limite é a porcentagem máxima de documentos que uma tarefa de sincronização pode excluir do seu índice. Se uma sincronização excluir mais do que essa porcentagem, a sincronização pulará a fase de exclusão, deixando seus documentos indexados no lugar certo. Não é compatível com o conector personalizado.

    • mediaExtractionConfiguration(opcional) — Configuração para extrair mídia (imagens, áudio, vídeo) dos arquivos da fonte de dados.

Campos opcionais:

Campo Description
description Forneça uma descrição para a fonte de dados.
vectorIngestionConfiguration Contém configurações para personalizar o processo de ingestão. Para obter mais informações, consulte Personalizar a ingestão para uma fonte de dados.
clientToken Para garantir que a solicitação de API seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.

O exemplo a seguir mostra uma CreateDataSource solicitação com um conector S3:

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

Para saber mais sobre um conector específico e sua configuração, selecione um tópico abaixo.

Tópicos