View a markdown version of this page

Voraussetzungen - Amazon Kendra
Melde dich an für AWS-KontoAmazon Kendra Ressourcen: AWS CLI, SDK, Konsole

Amazon Kendra ist nicht mehr offen für neue Kunden. In den Amazon Bedrock Knowledge Bases finden Sie ähnliche Funktionen wie. Amazon KendraWeitere Informationen.

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.

Voraussetzungen

Die folgenden Schritte sind Voraussetzungen für die Übungen mit den ersten Schritten. In den Schritten erfahren Sie, wie Sie Ihr Konto einrichten, eine IAM Rolle erstellen, die Amazon Kendra berechtigt, in Ihrem Namen Anrufe zu tätigen, und Dokumente aus einem Amazon S3 Bucket indexieren. Ein S3-Bucket wird als Beispiel verwendet, aber Sie können auch andere Datenquellen verwenden, die dies Amazon Kendra unterstützen. Siehe Datenquellen.

Melde dich an für AWS-Konto

Um damit zu beginnen AWS, benötigen Sie eine AWS-Konto. Informationen zum Erstellen einer AWS-Konto finden Sie AWS-Konto im AWS -Kontenverwaltung Referenzhandbuch unter Erste Schritte mit einer.

  • Wenn Sie einen S3-Bucket verwenden, der Dokumente zum Testen enthält Amazon Kendra, erstellen Sie einen S3-Bucket in derselben Region, die Sie verwenden Amazon Kendra. Anweisungen finden Sie unter Erstellen und Konfigurieren eines S3-Buckets im Amazon Simple Storage Service-Benutzerhandbuch.

    Laden Sie Ihre Dokumente in Ihren S3-Bucket hoch. Eine Anleitung finden Sie unter Objekte hochladen, herunterladen und verwalten im Amazon Simple Storage Service-Benutzerhandbuch.

    Wenn Sie eine andere Datenquelle verwenden, benötigen Sie eine aktive Site und Anmeldeinformationen, um eine Verbindung mit der Datenquelle herzustellen.

Wenn Sie zunächst die Konsole verwenden, beginnen Sie mitErste Schritte mit dem Amazon Kendra Konsole.

Amazon Kendra Ressourcen: AWS CLI, SDK, Konsole

Wenn Sie CLI, SDK oder die Konsole verwenden, sind bestimmte Berechtigungen erforderlich.

Um die CLI, das SDK oder die Konsole verwenden Amazon Kendra zu können, benötigen Sie die erforderlichen Berechtigungen Amazon Kendra , um Ressourcen in Ihrem Namen erstellen und verwalten zu können. Je nach Anwendungsfall beinhalten diese Berechtigungen den Zugriff auf die Amazon Kendra API selbst, AWS KMS keys wenn Sie Ihre Daten über ein benutzerdefiniertes CMK verschlüsseln möchten, und das Identity Center-Verzeichnis, falls Sie eine Sucherfahrung integrieren AWS IAM Identity Center oder erstellen möchten. Eine vollständige Liste der Berechtigungen für verschiedene Anwendungsfälle finden Sie unter IAM Rollen.

Zunächst müssen Sie Ihrem IAM-Benutzer die folgenden Berechtigungen zuordnen.

JSON
{
  "Version":"2012-10-17",
  "Statement": [
    {
      "Sid": "Stmt1644430853544",
      "Action": [
        "kms:CreateGrant",
        "kms:DescribeKey"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430878150",
      "Action": "kendra:*",
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430973706",
      "Action": [
        "sso:AssociateProfile",
        "sso:CreateManagedApplicationInstance",
        "sso:DeleteManagedApplicationInstance",
        "sso:DisassociateProfile",
        "sso:GetManagedApplicationInstance",
        "sso:GetProfile",
        "sso:ListDirectoryAssociations",
        "sso:ListProfileAssociations",
        "sso:ListProfiles"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644430999558",
      "Action": [
        "sso-directory:DescribeGroup",
        "sso-directory:DescribeGroups",
        "sso-directory:DescribeUser",
        "sso-directory:DescribeUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    },
    {
      "Sid": "Stmt1644431025960",
      "Action": [
        "identitystore:DescribeGroup",
        "identitystore:DescribeUser",
        "identitystore:ListGroups",
        "identitystore:ListUsers"
      ],
      "Effect": "Allow",
      "Resource": "*"
    }
  ]
}

Zweitens müssen Sie, wenn Sie die CLI oder das SDK verwenden, auch eine IAM Rolle und eine Richtlinie für den Zugriff Amazon CloudWatch Logs erstellen. Wenn Sie die Konsole verwenden, müssen Sie dafür keine IAM Rolle und Richtlinie erstellen. Sie erstellen dies als Teil der Konsolenprozedur.

Um eine zu erstellen IAM Rolle und Politik für die AWS CLI und SDK, das ermöglicht Amazon Kendra um auf Ihre zuzugreifen Amazon CloudWatch Logs.

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im linken Menü Richtlinien und dann Richtlinie erstellen aus.

  3. Wählen Sie JSON und ersetzen Sie dann die Standardrichtlinie durch Folgendes:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "cloudwatch:PutMetricData"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "cloudwatch:namespace": "AWS/Kendra"
                }
            }
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogGroups"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:CreateLogGroup"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kendra/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "logs:DescribeLogStreams",
                "logs:CreateLogStream",
                "logs:PutLogEvents"
            ],
            "Resource": [
                "arn:aws:logs:us-east-1:123456789012:log-group:/aws/kendra/*:log-stream:*"
            ]
        }
    ]
}

  4. Wählen Sie Richtlinie prüfen.

  5. Benennen Sie die Richtlinie "KendraPolicyForGettingStartedIndex" und wählen Sie dann Create policy aus.

  6. Wählen Sie im linken Menü Rollen und dann Rolle erstellen aus.

  7. Wählen Sie Anderes AWS Konto aus und geben Sie dann Ihre Konto-ID in das Feld Konto-ID ein. Wählen Sie Weiter: Berechtigungen aus.

  8. Wählen Sie die Richtlinie aus, die Sie oben erstellt haben, und wählen Sie dann Weiter: Tags

  9. Fügen Sie keine Tags hinzu. Wählen Sie Weiter: Prüfen aus.

  10. Benennen Sie die Rolle "KendraRoleForGettingStartedIndex" und wählen Sie dann Rolle erstellen aus.

  11. Suchen Sie die Rolle, die Sie gerade erstellt haben. Wählen Sie den Rollennamen, um die Zusammenfassung zu öffnen. Wählen Sie Vertrauensbeziehungen und dann Vertrauensbeziehung bearbeiten aus.

  12. Ersetzen Sie die bestehende Vertrauensbeziehung durch Folgendes:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Wählen Sie Update trust policy (Vertrauensrichtlinie aktualisieren) aus.

Drittens: Wenn Sie an Amazon S3 zum Speichern Ihrer Dokumente verwenden oder S3 zum Testen verwenden Amazon Kendra, müssen Sie auch eine IAM Rolle und eine Richtlinie für den Zugriff auf Ihren Bucket erstellen. Wenn Sie eine andere Datenquelle verwenden, finden Sie weitere Informationen unter IAM Rollen für Datenquellen.

Um eine zu erstellen IAM Rolle und Richtlinie, die es ermöglichen Amazon Kendra um auf Ihre zuzugreifen und sie zu indizieren Amazon S3 Eimer.

  1. Melden Sie sich bei der an AWS-Managementkonsole und öffnen Sie die IAM-Konsole unter https://console.aws.amazon.com/iam/.

  2. Wählen Sie im linken Menü Richtlinien und dann Richtlinie erstellen aus.

  3. Wählen Sie JSON und ersetzen Sie dann die Standardrichtlinie durch Folgendes:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "s3:GetObject"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name/*"
            ],
            "Effect": "Allow"
        },
        {
            "Action": [
                "s3:ListBucket"
            ],
            "Resource": [
                "arn:aws:s3:::bucket name"
            ],
            "Effect": "Allow"
        },
        {
            "Effect": "Allow",
            "Action": [
                "kendra:BatchPutDocument",
                "kendra:BatchDeleteDocument"
            ],
            "Resource": "arn:aws:kendra:us-east-1:123456789012:index/*"
        }
    ]
}

  4. Wählen Sie Richtlinie prüfen.

  5. Nennen Sie die Richtlinie "KendraPolicyForGettingStartedDataSource" und wählen Sie dann Richtlinie erstellen aus.

  6. Wählen Sie im linken Menü Rollen und dann Rolle erstellen aus.

  7. Wählen Sie Anderes AWS Konto aus und geben Sie dann Ihre Konto-ID in das Feld Konto-ID ein. Wählen Sie Weiter: Berechtigungen aus.

  8. Wählen Sie die Richtlinie aus, die Sie oben erstellt haben, und wählen Sie dann Weiter: Tags

  9. Fügen Sie keine Tags hinzu. Wählen Sie Weiter: Prüfen aus.

  10. Nennen Sie die Rolle KendraRoleForGettingStartedDataSource "" und wählen Sie dann Rolle erstellen.

  11. Suchen Sie die Rolle, die Sie gerade erstellt haben. Wählen Sie den Rollennamen, um die Zusammenfassung zu öffnen. Wählen Sie Vertrauensbeziehungen und dann Vertrauensbeziehung bearbeiten aus.

  12. Ersetzen Sie die bestehende Vertrauensbeziehung durch Folgendes:

    JSON
    {
    "Version":"2012-10-17",
    "Statement": [
      {
        "Effect": "Allow",
        "Principal": {
          "Service": "kendra.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
      }
    ]
}

  13. Wählen Sie Update trust policy (Vertrauensrichtlinie aktualisieren) aus.

Je nachdem, wie Sie die Amazon Kendra API verwenden möchten, führen Sie einen der folgenden Schritte aus.