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.

    • syncSchedule(opcional) — Define uma programação recorrente na qual o Amazon Bedrock sincroniza automaticamente a fonte de dados. Especifique exatamente uma das seguintes opções:

      • daily— Um objeto vazio. Sincroniza uma vez por dia em um horário fora do horário de pico escolhido pelo sistema.

      • weekly— Contém um dayOfWeek campo obrigatório, com um valor de SUNDAY atéSATURDAY.

      • monthly— Contém um dayOfMonth campo obrigatório, que contém um dayNumber de 1 a 28 ou um lastDayOfMonth objeto vazio.

      Omita syncSchedule a sincronização somente sob demanda. Para obter mais informações, consulte Definir um cronograma de sincronização para uma 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
            },
            "syncSchedule": {
                "weekly": {
                    "dayOfWeek": "MONDAY"
                }
            },
            "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.

Para fontes de dados de terceiros que oferecem suporte à configuração gerenciada pelo usuário (3LO), como SharePointOneDrive, eConfluence, você precisa de AWS Identity and Access Management permissões específicas para fazer login. Para obter mais informações, consulte Permissões do IAM para configuração gerenciada pelo usuário (3LO).

Tópicos