Étape 4 : Création d'un index Amazon Kendra et ingestion des métadonnées

Ouvrez la console Amazon Kendra à l'adresse. https://console.aws.amazon.com/kendra/

Choisissez Créer un index.

Pour les détails de l'index sur la page Spécifier les détails de l'index, procédez comme suit :

1. Pour Nom de l'index, saisissez kendra-index.

2. Laissez le champ Description vide.

3. Pour IAMrôle, choisissez Créer un nouveau rôle. Ce rôle permet d'accéder à votre compartiment Amazon S3.

4. Pour le Nom du rôle, saisissez kendra-role. Le IAM rôle aura le préfixeAmazonKendra-.

5. Conservez les paramètres par défaut pour le chiffrement et les balises, puis choisissez Next.

Pour les paramètres de contrôle d'accès sur la page Configurer le contrôle d'accès utilisateur, choisissez Non, puis Suivant.

Pour les éditions Provisioning sur la page des détails de Provisioning, choisissez Developer edition puis Create.

Pour créer et associer un IAM rôle à Amazon Kendra qui la reconnaisse comme une entité de confiance, procédez comme suit :

1. Enregistrez la politique de confiance suivante sous forme de JSON fichier appelé kendra-trust-policy.json dans un éditeur de texte sur votre appareil local.

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

2. Pour créer un IAM rôle appelé kendra-role et y joindre votre kendra-trust-policy.json fichier enregistré, utilisez la commande create-role :

   Linux

   aws iam create-role \
             --role-name kendra-role \
             --assume-role-policy-document file://path/kendra-trust-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-trust-policy.json appareil local.

   macOS

   aws iam create-role \
             --role-name kendra-role \
             --assume-role-policy-document file://path/kendra-trust-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-trust-policy.json appareil local.

   Windows

   aws iam create-role ^
             --role-name kendra-role ^
             --assume-role-policy-document file://path/kendra-trust-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-trust-policy.json appareil local.

3. Copiez le nom de la ressource Amazon (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom dekendra-role-arn.

   Note

   ARNLe format est similaire à arn:aws:iam::123456789012:role/kendra-role. Vous avez besoin du ARN fichier que vous avez enregistré kendra-role-arn pour exécuter les tâches Amazon Kendra.

Avant de créer un index, vous devez autoriser kendra-role l'écriture dans CloudWatch Logs. Pour y arriver, exécutez les étapes suivantes.

1. Enregistrez la politique de confiance suivante sous forme de JSON fichier appelé kendra-cloudwatch-policy.json dans un éditeur de texte sur votre appareil local.

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

   Remplacez aws-region avec votre AWS région, et aws-account-id avec votre identifiant de AWS compte à 12 chiffres.

2. Pour créer une IAM politique d'accès aux CloudWatch journaux, utilisez la commande create-policy :

   Linux

   aws iam create-policy \
             --policy-name kendra-cloudwatch-policy \
             --policy-document file://path/kendra-cloudwatch-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-cloudwatch-policy.json appareil local.

   macOS

   aws iam create-policy \
             --policy-name kendra-cloudwatch-policy \
             --policy-document file://path/kendra-cloudwatch-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-cloudwatch-policy.json appareil local.

   Windows

   aws iam create-policy ^
             --policy-name kendra-cloudwatch-policy ^
             --policy-document file://path/kendra-cloudwatch-policy.json

   Où :

   • path/ est le chemin du fichier vers votre kendra-cloudwatch-policy.json appareil local.

3. Copiez le nom de la ressource Amazon (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom dekendra-cloudwatch-arn.

   Note

   ARNLe format est similaire à arn:aws:iam::123456789012:role/kendra-cloudwatch-policy. Vous avez besoin du ARN fichier que vous avez enregistré kendra-cloudwatch-arn pour l'associer kendra-cloudwatch-policy à votre IAM rôle.

4. Pour l'associer kendra-cloudwatch-policy à votre IAM rôle, utilisez la attach-role-policycommande :

   Linux

   aws iam attach-role-policy \
             --policy-arn policy-arn \
             --role-name kendra-role

   Où :

   • policy-arn est votre sauvegardekendra-cloudwatch-arn.

   macOS

   aws iam attach-role-policy \
             --policy-arn policy-arn \
             --role-name kendra-role

   Où :

   • policy-arn est votre sauvegardekendra-cloudwatch-arn.

   Windows

   aws iam attach-role-policy ^
             --policy-arn policy-arn ^
             --role-name kendra-role

   Où :

   • policy-arn est votre sauvegardekendra-cloudwatch-arn.

Pour créer un index, utilisez la commande create-index :

Copiez l'index Id et enregistrez-le dans un éditeur de texte souskendra-index-id. IdCela vous permet de suivre l'état de la création de votre index.

Pour suivre la progression de votre tâche de création d'index, utilisez la commande describe-index :

Ouvrez la IAM console à l'adresse https://console.aws.amazon.com/iam/.

Dans le volet de navigation de gauche, choisissez Rôles et entrez kendra-role dans la zone de recherche au-dessus du nom du rôle.

Parmi les options proposées, cliquez surkendra-role.

Dans Résumé, choisissez Joindre des politiques.

Dans Autorisations d'attachement, dans la zone de recherche, entrez S3 et cochez la case à côté de la ReadOnlyAccess politique AmazonS3 parmi les options suggérées.

Choisissez Attach policy (Attacher une politique). Sur la page Résumé, vous pouvez désormais voir deux politiques associées au IAM rôle.

Revenez à la console Amazon Kendra à l'adresse https://console.aws.amazon.com/kendra/et attendez que le statut de votre index passe de Création à Actif avant de passer à l'étape suivante.

Enregistrez le texte suivant dans un JSON fichier appelé kendra-S3-access-policy.json dans un éditeur de texte sur votre appareil local.

{
   "Version":"2012-10-17",
   "Statement":[
      {
         "Action":[
            "s3:GetObject"
         ],
         "Resource":[
            "arn:aws:s3:::amzn-s3-demo-bucket/*"
         ],
         "Effect":"Allow"
      },
      {
         "Action":[
            "s3:ListBucket"
         ],
         "Resource":[
            "arn:aws:s3:::amzn-s3-demo-bucket"
         ],
         "Effect":"Allow"
      },
      {
         "Effect":"Allow",
         "Action":[
            "kendra:BatchPutDocument",
            "kendra:BatchDeleteDocument",
            "kendra:ListDataSourceSyncJobs"
         ],
         "Resource":[
            "arn:aws:kendra:aws-region:aws-account-id:index/kendra-index-id"
         ]
      }
   ]
}

Remplacez amzn-s3-demo-bucket par le nom de votre compartiment S3, aws-region avec votre AWS région, aws-account-id avec votre identifiant de AWS compte à 12 chiffres, et kendra-index-id avec votre sauvegardekendra-index-id.

Pour créer une IAM politique d'accès à votre compartiment S3, utilisez la commande create-policy :

Copiez le nom de la ressource Amazon (ARN) dans votre éditeur de texte et enregistrez-le localement sous le nom dekendra-S3-access-arn.

Pour associer le kendra-S3-access-policy à votre IAM rôle Amazon Kendra, utilisez la attach-role-policycommande suivante :

Ouvrez la console Amazon Kendra à l'adresse. https://console.aws.amazon.com/kendra/

Dans la liste des index, cliquez surkendra-index.

Dans le panneau de navigation de gauche, sous Gestion des données, choisissez Définition des facettes.

Dans le menu des champs d'index, choisissez Ajouter un champ.

Dans la boîte de dialogue Ajouter un champ d'index, procédez comme suit :

1. Dans Nom du champ, entrezCOMMERCIAL_ITEM.

2. Dans Type de données, sélectionnez Liste de chaînes.

3. Dans Types d'utilisation, sélectionnez Facetable, Consultable et Displayable, puis choisissez Ajouter.

4. Répétez les étapes a à c pour chaque type d'entité Amazon Comprehend : COMMERCIAL _ITEM,DATE,EVENT,LOCATION,,ORGANIZATION, OTHERPERSON,QUANTITY. TITLE

Enregistrez le texte suivant sous forme de JSON fichier appelé custom-attributes.json dans un éditeur de texte sur votre appareil local.

[
   {
       "Name": "COMMERCIAL_ITEM",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "DATE",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "EVENT",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "LOCATION",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "ORGANIZATION",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "OTHER",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "PERSON",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "QUANTITY",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   },
   {
       "Name": "TITLE",
       "Type": "STRING_LIST_VALUE",
       "Search": {
           "Facetable": true,
           "Searchable": true,
           "Displayable": true
       }
   }
]

Pour créer des champs personnalisés dans votre index, utilisez la commande update-index :

Pour vérifier que les attributs personnalisés ont été ajoutés à votre index, utilisez la commande describe-index :

Ouvrez la console Amazon Kendra à l'adresse. https://console.aws.amazon.com/kendra/

Dans la liste des index, cliquez surkendra-index.

Dans le menu de navigation de gauche, sous Gestion des données, sélectionnez Sources de données.

Dans la section Sélectionner le type de connecteur de source de données, accédez à Amazon S3 et choisissez Ajouter un connecteur.

Sur la page Spécifier les détails de la source de données, procédez comme suit :

1. Sous Nom et description, dans Nom de la source de données, entrezS3-data-source.

2. Laissez la section Description vide.

3. Conservez les paramètres par défaut pour les balises.

4. Choisissez Suivant.

Sur la page Configurer les paramètres de synchronisation, dans la section Étendue de la synchronisation, procédez comme suit :

1. Dans Entrez l'emplacement de la source de données, choisissez Parcourir S3.

2. Dans Choisir les ressources, sélectionnez votre compartiment S3, puis choisissez Choose.

3. Dans Emplacement du dossier de préfixes des fichiers de métadonnées, choisissez Parcourir S3.

4. Dans Choisir les ressources, cliquez sur le nom de votre bucket dans la liste des buckets.

5. Pour Objets, cochez la case d'option correspondant à metadata et choisissez Choisir. Le champ de localisation doit maintenant indiquermetadata/.

6. Conservez les paramètres par défaut pour l'emplacement du fichier de configuration de la liste de contrôle d'accès, la sélection de la clé de déchiffrement et la configuration supplémentaire.

Pour IAMle rôle, sur la page Configurer les paramètres de synchronisation, sélectionnezkendra-role.

Sur la page Configurer les paramètres de synchronisation, sous Calendrier d'exécution de synchronisation, pour Fréquence, choisissez Exécuter à la demande, puis Suivant.

Sur la page Révision et création, passez en revue vos choix concernant les détails de la source de données et choisissez Ajouter une source de données.

Enregistrez le texte suivant sous forme de JSON fichier appelé S3-data-connector.json dans un éditeur de texte sur votre appareil local.

{
   "S3Configuration":{
      "BucketName":"amzn-s3-demo-bucket",
      "DocumentsMetadataConfiguration":{
         "S3Prefix":"metadata"
      }
   }
}

Remplacez amzn-s3-demo-bucket par le nom de votre compartiment S3.

Pour connecter votre compartiment S3 à votre index, utilisez la create-data-sourcecommande suivante :

Copiez le connecteur Id et enregistrez-le dans un éditeur de texte sous le nom deS3-connector-id. IdCela vous permet de suivre l'état du processus de connexion des données.

Pour vous assurer que votre source de données S3 a été correctement connectée, utilisez la describe-data-sourcecommande suivante :

Ouvrez la console Amazon Kendra à l'adresse. https://console.aws.amazon.com/kendra/

Dans la liste des index, cliquez surkendra-index.

Dans le menu de navigation de gauche, sélectionnez Sources de données.

Dans Sources de données, sélectionnezS3-data-source.

Dans la barre de navigation supérieure, choisissez Synchroniser maintenant.

Pour synchroniser votre index, utilisez la commande start-data-source-sync-job :

Pour vérifier l'état de la synchronisation des index, utilisez la commande list-data-source-sync-jobs :