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 da 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 Amazon Bedrock, envie uma CreateDataSource solicitação com um endpoint de tempo de execução 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 as 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 para o 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 ONEDRIVE CONFLUENCESHAREPOINT,WEB_CRAWLER,, GOOGLE_DRIVE e. Os campos restantes connectorParameters diferem de acordo com o 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 de 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 um trabalho de sincronização pode excluir do seu índice. Se uma sincronização excluir mais do que essa porcentagem, a sincronização ignorará a fase de exclusão, deixando seus documentos indexados no lugar certo. Não há suporte para o conector personalizado.

    • mediaExtractionConfiguration(opcional) — Configuração para extrair mídia (imagens, áudio, vídeo) dos arquivos da fonte de dados. Contém três subconfigurações que você pode ativar de forma independente:

      • imageExtractionConfiguration(opcional) — Processa, extrai e indexa conteúdo de arquivos de imagem independentes (.png, .jpg, .jpeg, .jpe, .tif, .tiff, .gif, .bmp, .webp, .svg, .jp2, .heic) e imagens incorporadas em arquivos.pdf, .docx, .ppt, .pptx.

      • audioExtractionConfiguration(opcional) — Processa, extrai e indexa conteúdo de arquivos de áudio compatíveis (.mp3, .wav, .m4a, .flac, .ogg).

      • videoExtractionConfiguration(opcional) — Processa, extrai e indexa conteúdo de arquivos de vídeo compatíveis (.mp4, .mov, .m4v).

      Para obter a referência completa do campo, consulte MediaExtractionConfiguration a Referência da API Amazon Bedrock.

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