View a markdown version of this page

Connettere un’origine dati - Amazon Bedrock

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connettere un’origine dati

Dopo aver completato le configurazioni per la knowledge base, connettere alla knowledge base un’origine dati supportata.

Le knowledge base gestite di Amazon Bedrock supportano la connessione a fonti di dati non strutturate. Selezionare un argomento per scoprire come connettersi a quel tipo di origine dati:

Nota

Per le knowledge base gestite, l'CreateDataSourceoperazione è asincrona. Lo stato dell'origine dati passa dal AVAILABLE momento in cui l'operazione viene CREATING completata.

Per informazioni su come connettersi a un’origine dati utilizzando la console Amazon Bedrock, selezionare l’argomento corrispondente al tipo di origine dati in fondo a questa pagina:

Per connetterti a un'origine dati utilizzando l'API Amazon Bedrock, invia una CreateDataSourcerichiesta con un endpoint di runtime Agents for Amazon Bedrock.

Campi obbligatori:

Campo Description
knowledgeBaseId L’ID della knowledge base.
name Un nome per la fonte di dati.
dataSourceConfiguration Specificate il tipo di origine dati nel type campo e includete la configurazione corrispondente. Per ulteriori dettagli sulle configurazioni specifiche del connettore, seleziona l'argomento relativo al connettore dagli argomenti in fondo a questa pagina.

All'internodataSourceConfiguration, è necessario specificare quanto segue:

  • type — Deve essere MANAGED_KNOWLEDGE_BASE_CONNECTOR.

  • managedKnowledgeBaseConnectorConfiguration— Configurazione del connettore. Contiene i seguenti campi:

    • connectorParameters(obbligatorio): contiene un type campo che specifica il tipo di connettore e un version campo obbligatorio impostato 1 su. I valori di tipo supportati sono S3ONEDRIVE,CONFLUENCE,, SHAREPOINTWEB_CRAWLER, eGOOGLE_DRIVE. I campi rimanenti connectorParameters differiscono in base al tipo di connettore: consulta la pagina di ciascun connettore dati per maggiori dettagli.

    • deletionProtectionConfiguration(opzionale): una protezione contro l'eliminazione accidentale di massa di contenuti indicizzati. Contiene deletionProtectionStatus (ENABLEDoDISABLED) e, se abilitato, un elemento opzionale deletionProtectionThreshold (0-100, il valore predefinito è 15). La soglia è la percentuale massima di documenti che un processo di sincronizzazione può eliminare dall'indice. Se una sincronizzazione comporta l'eliminazione di una percentuale superiore a questa percentuale, la sincronizzazione salta la fase di eliminazione, lasciando invariati i documenti indicizzati. Non supportato per il connettore personalizzato.

    • mediaExtractionConfiguration(opzionale): configurazione per l'estrazione di contenuti multimediali (immagini, audio, video) dai file di origine dati.

Campi opzionali:

Campo Description
description Fornisci una descrizione per l'origine dei dati.
vectorIngestionConfiguration Contiene configurazioni per personalizzare il processo di ingestione. Per ulteriori informazioni, consulta Personalizzare l’importazione per un’origine dati.
clientToken Per garantire che la richiesta API venga completata solo una volta. Per ulteriori informazioni, consulta Garanzia di idempotenza.

L'esempio seguente mostra una CreateDataSource richiesta con un connettore 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"
                }
            }
        }
    }
}

Per saperne di più su un connettore specifico e sulla sua configurazione, seleziona uno degli argomenti seguenti.

Argomenti