View a markdown version of this page

Conditions préalables - Amazon Kendra
Inscrivez-vous pour Compte AWSAmazon Kendra ressources : AWS CLI, SDK, console

Amazon Kendra n'est plus ouvert aux nouveaux clients. Pour des fonctionnalités similaires à Amazon Kendra, explorez les bases de connaissances Amazon Bedrock. En savoir plus.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Conditions préalables

Les étapes suivantes sont des conditions préalables à la mise en route des exercices. Les étapes vous montrent comment configurer votre compte, créer un IAM rôle qui vous Amazon Kendra autorise à passer des appels en votre nom et indexer les documents d'un Amazon S3 compartiment. Un compartiment S3 est utilisé à titre d'exemple, mais vous pouvez utiliser d'autres sources de données Amazon Kendra compatibles. Voir Sources de données.

Inscrivez-vous pour Compte AWS

Pour commencer AWS, vous avez besoin d'un Compte AWS. Pour plus d'informations sur la création d'un Compte AWS, consultez la section Démarrage avec un Compte AWS dans le Guide de Gestion de compte AWS référence.

  • Si vous utilisez un compartiment S3 contenant des documents à tester Amazon Kendra, créez un compartiment S3 dans la même région que vous utilisez Amazon Kendra. Pour obtenir des instructions, consultez la section Création et configuration d'un compartiment S3 dans le guide de l'utilisateur d'Amazon Simple Storage Service.

    Téléchargez vos documents dans votre compartiment S3. Pour obtenir des instructions, consultez la section Charger, télécharger et gérer des objets dans le guide de l'utilisateur d'Amazon Simple Storage Service.

    Si vous utilisez une autre source de données, vous devez disposer d'un site actif et d'informations d'identification pour vous connecter à la source de données.

Si vous utilisez la console pour commencer, commencez parDémarrage avec le plugin Amazon Kendra console.

Amazon Kendra ressources : AWS CLI, SDK, console

Certaines autorisations sont requises si vous utilisez la CLI, le SDK ou la console.

Pour l'utiliser Amazon Kendra pour la CLI, le SDK ou la console, vous devez disposer des autorisations nécessaires Amazon Kendra pour créer et gérer des ressources en votre nom. Selon votre cas d'utilisation, ces autorisations incluent l'accès à l' Amazon Kendra API elle-même, AWS KMS keys si vous souhaitez crypter vos données via une CMK personnalisée, ou un répertoire Identity Center si vous souhaitez intégrer AWS IAM Identity Center ou créer une expérience de recherche. Pour une liste complète des autorisations pour les différents cas d'utilisation, consultez la section IAM Rôles.

Tout d'abord, vous devez associer les autorisations ci-dessous à votre utilisateur IAM.

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

Deuxièmement, si vous utilisez la CLI ou le SDK, vous devez également créer un IAM rôle et une politique d'accès Amazon CloudWatch Logs. Si vous utilisez la console, vous n'avez pas besoin de créer de IAM rôle ni de politique pour cela. Vous le créez dans le cadre de la procédure de la console.

Pour créer un IAM rôle et politique de AWS CLI et un SDK qui permet Amazon Kendra pour accéder à votre Amazon CloudWatch Logs.

  1. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

  2. Dans le menu de gauche, choisissez Politiques, puis sélectionnez Créer une politique.

  3. Choisissez JSON, puis remplacez la politique par défaut par la suivante :

    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. Choisissez Examiner une politique.

  5. Donnez un nom à la politique, "KendraPolicyForGettingStartedIndex" puis choisissez Créer une politique.

  6. Dans le menu de gauche, choisissez Rôles, puis sélectionnez Créer un rôle.

  7. Choisissez Un autre AWS compte, puis saisissez votre identifiant de compte dans ID de compte. Choisissez Suivant : Autorisations.

  8. Choisissez la politique que vous avez créée ci-dessus, puis choisissez Suivant : Tags

  9. N’ajoutez aucune balise. Choisissez Suivant : Vérification.

  10. Donnez un nom au rôle, "KendraRoleForGettingStartedIndex" puis choisissez Créer un rôle.

  11. Trouvez le rôle que vous venez de créer. Choisissez le nom du rôle pour ouvrir le résumé. Choisissez Relations de confiance, puis sélectionnez Modifier la relation de confiance.

  12. Remplacez la relation de confiance existante par la suivante :

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

  13. Choisissez Update Trust Policy (Mettre à jour la stratégie d’approbation).

Troisièmement, si vous utilisez an Amazon S3 pour stocker vos documents ou si vous utilisez S3 pour effectuer des tests Amazon Kendra, vous devez également créer un IAM rôle et une politique pour accéder à votre compartiment. Si vous utilisez une autre source de données, consultez la section IAM Rôles pour les sources de données.

Pour créer un IAM rôle et politique qui permettent Amazon Kendra pour accéder à votre Amazon S3 seau.

  1. Connectez-vous au Console de gestion AWS et ouvrez la console IAM à https://console.aws.amazon.com/iam/ l'adresse.

  2. Dans le menu de gauche, choisissez Politiques, puis sélectionnez Créer une politique.

  3. Choisissez JSON, puis remplacez la politique par défaut par la suivante :

    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. Choisissez Examiner une politique.

  5. Nommez la politique « KendraPolicyForGettingStartedDataSource », puis choisissez Créer une politique.

  6. Dans le menu de gauche, choisissez Rôles, puis sélectionnez Créer un rôle.

  7. Choisissez Un autre AWS compte, puis saisissez votre identifiant de compte dans ID de compte. Choisissez Suivant : Autorisations.

  8. Choisissez la politique que vous avez créée ci-dessus, puis choisissez Suivant : Tags

  9. N’ajoutez aucune balise. Choisissez Suivant : Vérification.

  10. Nommez le rôle « KendraRoleForGettingStartedDataSource », puis choisissez Créer un rôle.

  11. Trouvez le rôle que vous venez de créer. Choisissez le nom du rôle pour ouvrir le résumé. Choisissez Relations de confiance, puis sélectionnez Modifier la relation de confiance.

  12. Remplacez la relation de confiance existante par la suivante :

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

  13. Choisissez Update Trust Policy (Mettre à jour la stratégie d’approbation).

Selon la manière dont vous souhaitez utiliser l' Amazon Kendra API, effectuez l'une des opérations suivantes.