Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Amazon S3

Amazon S3 ist ein Objektspeicherdienst, der Daten als Objekte in Buckets speichert. Sie können einen Amazon S3 S3-Bucket als Datenquelle für Ihre verwaltete Wissensdatenbank verbinden, um die dort gespeicherten Objekte aufzunehmen.

Unterstützte Features

Voraussetzungen

Stellen Sie in Amazon S3 Folgendes sicher:

Stellen Sie in Ihrem AWS Konto sicher, dass Sie:

Bucket-Richtlinien für kontoübergreifenden Zugriff und Kontozugriff KMS-encrypted

Wenn sich Ihr Amazon S3 S3-Bucket in einem anderen AWS Konto als Ihrer Wissensdatenbank befindet oder wenn er mit einem vom Kunden verwalteten KMS-Schlüssel verschlüsselt ist, fügen Sie eine ressourcenbasierte Richtlinie hinzu, um Ihrer Wissensdatenbank-Servicerolle Zugriff zu gewähren. Die folgenden Beispiele zeigen, welche Mindestanweisungen erforderlich sind.

Cross-account Bucket-Richtlinie

Fügen Sie in dem Konto, dem der Amazon S3 S3-Bucket gehört, die folgende Anweisung zur Bucket-Richtlinie hinzu. kb-account-idErsetzen Sie es durch die Konto-ID, unter der Ihre Wissensdatenbank erstellt wurde, kb-service-role durch den Namen Ihrer Wissensdatenbank-Servicerolle und bucket-name durch Ihren Bucket-Namen.

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

Eine allgemeinere Anleitung finden Sie unter Zugriff auf Amazon S3 S3-Buckets konfigurieren.

KMS-Schlüsselrichtlinie für verschlüsselte Buckets

Wenn Ihr Amazon S3 S3-Bucket mit einem vom Kunden verwalteten KMS-Schlüssel verschlüsselt ist, fügen Sie der Schlüsselrichtlinie die folgende Erklärung hinzu. Verwenden Sie dieselben Platzhalter wie in der kontoübergreifenden Bucket-Richtlinie. Warten Sie einige Minuten, bis wichtige Richtlinienänderungen wirksam werden.

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

"Resource": "*"Hier geht es um den Schlüssel, an den die Richtlinie angehängt ist.

So richten Sie eine Amazon S3 S3-Datenquelle ein

Die Einrichtung einer Amazon S3 S3-Datenquelle umfasst die folgenden Schritte:

Erstellen Sie die Datenquelle

Console

So verbinden Sie einen Amazon S3 S3-Bucket mit Ihrer verwalteten Wissensdatenbank

1. Geben Sie unter Datenquelle einen Namen für Ihre Datenquelle ein.

2. Wählen Sie Amazon S3 aus dem Drop-down-Menü für die Datenquelle aus.

3. Wählen Sie unter Speicherort der Datenquelle aus, ob sich der Amazon S3 S3-Bucket unter Dieses AWS-Konto oder Anderes AWS-Konto befindet.

4. Geben Sie die Amazon S3 S3-URI Ihres Buckets ein. Sie können Browse S3 wählen, um einen Bucket auszuwählen.

5. (Optional) Geben Sie ein Präfix für Metadatendateien ein — das Amazon S3 S3-Präfix, in dem Dokument-Metadatendateien (.metadata.json) für diese Datenquelle gespeichert werden.

6. (Optional) Erweitern Sie die S3-Präfixfiltermuster, um bestimmte Pfade ein- oder auszuschließen.

7. (Optional) Erweitern Sie Dateifiltermuster, um Regex-Muster hinzuzufügen, um bestimmte Dateien ein- oder auszuschließen.

8. (Optional) Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, wählen Sie Dokumentenzugriff mit ACLs kontrollieren und geben Sie den Amazon S3 S3-URI Ihrer globalen ACL-Datei ein. Diese Option kann nach der Erstellung nicht geändert werden. Details hierzu finden Sie unter Document-level Zugriffskontrollen.

API

Um eine Amazon S3 S3-Datenquelle zu erstellen, senden Sie eine CreateDataSourceAnfrage mit einem Build-Time-Endpunkt von Agents for Amazon Bedrock. Das folgende AWS Command Line Interface Beispiel erstellt eine Datenquelle für einen Bucket im selben Konto mit Präfix- und Musterfiltern. Eine Beschreibung der einzelnen Felder finden Sie in der nachfolgenden Referenz zu den Konnektorparametern.

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

Die s3-managed-connector.json Datei enthält Folgendes:

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

Um die Zugriffskontrolle auf Dokumentebene zu aktivieren, setzen Sie aclEnabled auf true und fügen Sie ein aclConfiguration mit hinzu. globalAccessControlListS3Uri Siehe Document-level Zugriffskontrollen.

Bei verwalteten Wissensdatenbanken CreateDataSource erfolgt der Vorgang asynchron: Der Status der Datenquelle wechselt von CREATING zu, AVAILABLE wenn der Vorgang abgeschlossen ist.

Connector-Parameter

Die Datenquellenkonfiguration verwendet die folgenden Konnektorparameter. Um eine Verbindung zu Amazon S3 herzustellen, geben Sie S3 als Konnektortyp anconnectorParameters. Informationen zu Feldern, die umbrechen connectorParameters (z. B. deletionProtectionConfiguration undmediaExtractionConfiguration), finden Sie unterVerbinden einer Datenquelle.

Metadaten-Dateien für Dokumente

Sie können jedem Dokument Metadaten hinzufügen, indem Sie eine Sidecar-Datei gleichzeitig hochladen. Erstellen Sie für jedes Dokument eine Datei mit filename.extension.metadata.json demselben Amazon S3-Pfad. Die Metadatendatei darf 10 KB nicht überschreiten. Laden Sie zum report.pdf Beispiel report.pdf.metadata.json nebenbei den folgenden Inhalt hoch:

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

Informationen zu den unterstützten Attributdatentypen und den Filteroperatoren, die Sie bei der Abfrage anwenden können, finden Sie unter Metadaten und Filterung.