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. # Ajouter des synonymes personnalisés à un index Pour ajouter des synonymes personnalisés à un index, vous devez les spécifier dans un fichier de thésaurus. Vous pouvez inclure des termes spécifiques à l'entreprise ou spécialisés lorsque vous Amazon Kendra utilisez des synonymes. Les synonymes anglais génériques, tels que`leader, head`, sont intégrés Amazon Kendra et ne doivent pas être inclus dans un fichier de thésaurus, y compris les synonymes génériques qui utilisent des traits d'union. Amazon Kendra prend en charge les synonymes pour tous les types de réponses, y compris les types de `DOCUMENT` `ANSWER` réponse `QUESTION_ANSWER` et/ou les types de réponse. Amazon Kendra ne prend actuellement pas en charge l'ajout de synonymes marqués comme des mots d'arrêt. Cela sera inclus dans une future version. Amazon Kendra établit des corrélations entre les synonymes. Par exemple, l'utilisation de la paire `Dynamo, Amazon DynamoDB` de synonymes met Dynamo en Amazon Kendra corrélation avec. Amazon DynamoDB La requête « Qu'est-ce que la dynamo ? » renvoie ensuite un document tel que « Qu'est-ce que c'est Amazon DynamoDB ? ». Avec les synonymes, Amazon Kendra vous pouvez plus facilement détecter la corrélation. Le fichier de thésaurus est un fichier texte stocké dans un Amazon S3 bucket. Consultez [Ajouter un thésaurus à un index](index-synonyms-adding-thesaurus-file.md). Le fichier de thésaurus utilise le format [synonyme Solr.](https://lucene.apache.org/solr/guide/6_6/filter-descriptions.html#FilterDescriptions-SynonymGraphFilter) Amazon Kendra impose une limite au nombre de thésaurus par index. Consultez [Quotas](https://docs.aws.amazon.com/kendra/latest/dg/quotas.html). Les synonymes peuvent être utiles dans les scénarios suivants : + Termes spécialisés qui ne sont pas des synonymes traditionnels en anglais, tels que`NLP, Natural Language Processing`. + Noms propres avec des associations sémantiques complexes. Ce sont des noms que le grand public est peu susceptible de comprendre, par exemple, dans le domaine de l'apprentissage automatique. `cost, loss, model performance` + Différentes formes de noms de produits, par exemple,`Elastic Compute Cloud, EC2`. + Termes spécifiques au domaine ou à l'entreprise, tels que les noms de produits. Par exemple, `Route53, DNS`. N'utilisez pas de synonymes dans les scénarios suivants : + Synonymes génériques en anglais tels que`leader, head`. Ces synonymes ne sont pas spécifiques à un domaine, et l'utilisation de synonymes dans ces scénarios peut avoir des effets inattendus. + Des erreurs typographiques telles que`teh => the`. + Variantes morphologiques telles que le pluriel et le possessif des noms, la forme comparative et superlative des adjectifs, le passé, le participe passé et la forme progressive des verbes. Un exemple d'adjectifs comparatifs et superlatifs est. `good, better, best` + Unigram (mot unique) arrête les mots tels que`WHO`. Les mots d'arrêt Unigram ne sont pas autorisés dans le thésaurus et sont exclus de la recherche. Par exemple, `WHO => World Health Organization` est rejeté. Vous pouvez `W.H.O.` toutefois l'utiliser comme synonyme, et vous pouvez utiliser des mots interrompus dans le cadre d'un synonyme comportant plusieurs mots. Par exemple, ce n'`of`est pas autorisé mais `United States of America` est accepté. Les synonymes personnalisés facilitent la compréhension Amazon Kendra de la terminologie propre à votre entreprise en élargissant vos requêtes pour couvrir les synonymes spécifiques à votre entreprise. Bien que les synonymes puissent améliorer la précision de la recherche, il est important de comprendre comment les synonymes affectent la latence afin de pouvoir optimiser cela. La règle générale en matière de synonymes est la suivante : plus le nombre de termes de votre requête mis en correspondance et développés avec des synonymes est élevé, plus l'impact potentiel sur le temps de latence est important. Parmi les autres facteurs qui influent sur la latence, citons la taille moyenne des documents indexés, la taille de votre index, les éventuels filtres appliqués aux résultats de recherche et la charge globale de votre Amazon Kendra index. Les requêtes qui ne correspondent à aucun synonyme ne sont pas affectées. Une directive générale sur la façon dont les synonymes affectent le temps de latence : [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/kendra/latest/dg/index-synonyms.html) \$1 Les *performances varient en fonction de votre utilisation spécifique des synonymes et des configurations dans votre index. Il est préférable de tester les performances de recherche afin d'obtenir des points de référence plus précis pour votre cas d'utilisation spécifique.* Si votre thésaurus est volumineux, présente un taux d'extension à long terme élevé et que l'augmentation de la latence ne se situe pas dans les limites acceptables, vous pouvez essayer l'une des solutions suivantes ou les deux : + Réduisez votre thésaurus pour réduire le taux d'extension (nombre de synonymes par terme). + Réduisez la couverture globale des termes (nombre de lignes dans votre thésaurus). Vous pouvez également augmenter la capacité de provisionnement (unités de stockage virtuelles) pour compenser l'augmentation de la latence. **Topics** + [Création d'un fichier de thésaurus](index-synonyms-creating-thesaurus-file.md) + [Ajouter un thésaurus à un index](index-synonyms-adding-thesaurus-file.md) + [Mettre à jour un thésaurus](index-synonyms-update.md) + [Supprimer un thésaurus](index-synonyms-delete.md) + [Points saillants dans les résultats de recherche](index-synonyms-enabling-synonyms-in-results.md) # Création d'un fichier de thésaurus Un fichier de Amazon Kendra thésaurus est un fichier codé en UTF-8 contenant une liste de synonymes au format de liste de synonymes Solr. La taille du fichier du thésaurus doit être inférieure à 5 Mo. Il existe deux manières de spécifier les mappages de synonymes : + Les *synonymes bidirectionnels* sont spécifiés sous forme de liste de termes séparés par des virgules. Si votre utilisateur interroge l'un des termes, tous les termes de la liste sont utilisés pour rechercher des documents, y compris le terme demandé d'origine. + Les *synonymes unidirectionnels* sont spécifiés sous forme de termes séparés par le symbole « => » entre eux pour associer les termes à leurs synonymes. Si votre utilisateur recherche un terme situé à gauche du symbole « => », il est associé à un terme situé à droite pour rechercher des documents utilisant le synonyme. Il n'est pas mappé vice versa, ce qui le rend unidirectionnel. Les synonymes eux-mêmes font la distinction majuscules/majuscules, mais les termes auxquels ils correspondent ne font pas la distinction majuscules/minuscules. Par exemple, `ML => Machine Learning` cela signifie que si votre utilisateur demande « ML » ou « ml » ou utilise un autre cas, il sera mappé sur « Machine Learning ». Si vous deviez mapper cela inversement`Machine Learning => ML`, alors « Machine Learning » ou « machine learning » ou un autre cas correspondrait à « ML ». Un synonyme ne recherche pas de correspondance exacte entre les caractères spéciaux. Par exemple, si vous recherchez dead-letter-queue « », vous Amazon Kendra pouvez renvoyer des documents correspondant à la « file d'attente de lettres mortes » (sans tiret). Si vos documents contiennent des traits d'union, tels que dead-letter-queue « », Amazon Kendra traite les documents pendant la recherche pour supprimer les traits d'union. Pour les termes synonymes génériques en anglais qui sont intégrés à un fichier de thésaurus Amazon Kendra et ne devraient pas y être inclus, Amazon Kendra vous pouvez rechercher à la fois la version du terme avec tiret et la version sans trait d'union du terme. Par exemple, si vous recherchez « tiers » et « tiers », Amazon Kendra les documents qui correspondent à l'une ou l'autre version de ces termes sont renvoyés. Pour les synonymes contenant des mots clés ou des mots couramment utilisés, Amazon Kendra renvoie des documents qui correspondent à des termes, y compris des mots d'arrêt. Par exemple, vous pouvez créer une règle de synonymes pour associer les termes « onboarding » et « onboarding ». Vous ne pouvez pas utiliser uniquement des mots d'arrêt pour les synonymes. Par exemple, si vous recherchez « on », vous Amazon Kendra ne pouvez pas renvoyer tous les documents contenant « on ». Certaines règles relatives aux synonymes sont ignorées. Par exemple, `a => b` est une règle, mais elle `a => a` est ignorée et ne compte pas comme règle. Le nombre de termes est le nombre de termes uniques contenus dans le fichier théaurus. Le fichier d'exemple ci-dessous inclut les termes`AWS CodeStar`,`ML`,`Machine Learning`,`autoscaling group`,`ASG`, et plus encore. Il existe un nombre maximum de règles de synonymes par thésaurus et un maximum de synonymes par terme. Pour de plus amples informations, veuillez consulter [Quotas pour Amazon Kendra](quotas.md). L'exemple suivant montre un fichier de thésaurus avec des règles relatives aux synonymes. Chaque ligne contient une seule règle de synonymes. Les lignes vides et les commentaires sont ignorés. ``` # Lines starting with pound are comments and blank lines are ignored. # Synonym relationships can be defined as unidirectional or bidirectional relationships. # Unidirection relationships are represented by any term sequence # on the left hand side (LHS) of "=>" followed by synonyms on the right hand side (RHS) CodeStar => AWS CodeStar # This will map CodeStar to AWS CodeStar, but not vice-versa # To map terms vice versa ML => Machine Learning Machine Learning => ML # Multiple synonym relationships may be defined in one line as well by comma seperation. autoscaling group, ASG => Auto Scaling group, autoscaling # The above is equivalent to: # autoscaling group => Auto Scaling group, autoscaling # ASG => Auto Scaling group, autoscaling # Bi-directional synonyms are comma separated terms with no "=>" DNS, Route53, Route 53 # DNS, Route53, and Route 53 map to one another and are interchangeable at match time # The above is equivalent to: # DNS => Route53, Route 53 # Route53 => DNS, Route 53 # Route 53 => DNS, Route53 # Overlapping LHS terms will be merged Beta => Alpha Beta => Gamma Beta, Delta # is equivalent to: # Beta => Alpha, Gamma, Delta # Delta => Beta # Each line contains a single synonym rule. # Synonym rule count is the total number of lines defining synonym relationships # Term count is the total number of unique terms for all rules. # Comments and blanks lines do not count. ``` # Ajouter un thésaurus à un index Les procédures suivantes indiquent comment ajouter un fichier de thésaurus contenant des synonymes à un index. Les effets de la mise à jour de votre fichier de thésaurus peuvent prendre jusqu'à 30 minutes. Pour plus d'informations sur le fichier de thésaurus, consultez[Création d'un fichier de thésaurus](index-synonyms-creating-thesaurus-file.md). ------ #### [ Console ] **Pour ajouter un thésaurus** 1. Dans le volet de navigation de gauche, sous l'index dans lequel vous souhaitez ajouter une liste de synonymes, dans votre thésaurus, choisissez **Synonymes**. 1. Sur la page des **synonymes**, choisissez **Ajouter un thésaurus**. 1. Dans **Définir le thésaurus**, donnez un nom à votre thésaurus et une description facultative. 1. Dans les **paramètres du thésaurus**, indiquez le Amazon S3 chemin d'accès à votre fichier de thésaurus. La taille du fichier doit être inférieure à 5 Mo. 1. Pour **le rôle IAM**, sélectionnez un rôle ou sélectionnez **Créer un nouveau rôle** et spécifiez un nom de rôle pour créer un nouveau rôle. Amazon Kendra utilise ce rôle pour accéder à la Amazon S3 ressource en votre nom. Le rôle IAM porte le préfixe « AmazonKendra - ». 1. Choisissez **Enregistrer** pour enregistrer la configuration et ajouter le thésaurus. Une fois le thésaurus ingéré, il est actif et les synonymes sont mis en évidence dans les résultats. Les effets de votre fichier de thésaurus peuvent prendre jusqu'à 30 minutes. ------ #### [ CLI ] Pour ajouter un thésaurus à un index avec le AWS CLI, appelez `create-thesaurus` : ``` aws kendra create-thesaurus \ --index-id index-id \ --name "thesaurus-name" \ --description "thesaurus-description" \ --source-s3-path "Bucket=bucket-name,Key=thesaurus/synonyms.txt" \ --role-arn role-arn ``` Appelez `list-thesauri` pour consulter la liste des thésaurus : ``` aws kendra list-thesauri \ --index-id index-id ``` Pour consulter les détails d'un thésaurus, appelez `describe-thesaurus` : ``` aws kendra describe-thesaurus \ --index-id index-id \ --index-id thesaurus-id ``` Les effets de votre fichier de thésaurus peuvent prendre jusqu'à 30 minutes. ------ #### [ Python ] ``` import boto3 from botocore.exceptions import ClientError import pprint import time kendra = boto3.client("kendra") print("Create a thesaurus") thesaurus_name = "thesaurus-name" thesaurus_description = "thesaurus-description" thesaurus_role_arn = "role-arn" index_id = "index-id" s3_bucket_name = "bucket-name" s3_key = "thesaurus-file" source_s3_path= { 'Bucket': s3_bucket_name, 'Key': s3_key } try: thesaurus_response = kendra.create_thesaurus( Description = thesaurus_description, Name = thesaurus_name, RoleArn = thesaurus_role_arn, IndexId = index_id, SourceS3Path = source_s3_path ) pprint.pprint(thesaurus_response) thesaurus_id = thesaurus_response["Id"] print("Wait for Kendra to create the thesaurus.") while True: # Get thesaurus description thesaurus_description = kendra.describe_thesaurus( Id = thesaurus_id, IndexId = index_id ) # If status is not CREATING quit status = thesaurus_description["Status"] print("Creating thesaurus. Status: " + status) if status != "CREATING": break time.sleep(60) except ClientError as e: print("%s" % e) print("Program ends.") ``` ------ #### [ Java ] ``` package com.amazonaws.kendra; import software.amazon.awssdk.services.kendra.KendraClient; import software.amazon.awssdk.services.kendra.model.CreateThesaurusRequest; import software.amazon.awssdk.services.kendra.model.CreateThesaurusResponse; import software.amazon.awssdk.services.kendra.model.DescribeThesaurusRequest; import software.amazon.awssdk.services.kendra.model.DescribeThesaurusResponse; import software.amazon.awssdk.services.kendra.model.S3Path; import software.amazon.awssdk.services.kendra.model.ThesaurusStatus; public class CreateThesaurusExample { public static void main(String[] args) throws InterruptedException { KendraClient kendra = KendraClient.builder().build(); String thesaurusName = "thesaurus-name"; String thesaurusDescription = "thesaurus-description"; String thesaurusRoleArn = "role-arn"; String s3BucketName = "bucket-name"; String s3Key = "thesaurus-file"; String indexId = "index-id"; System.out.println(String.format("Creating a thesaurus named %s", thesaurusName)); CreateThesaurusRequest createThesaurusRequest = CreateThesaurusRequest .builder() .name(thesaurusName) .indexId(indexId) .description(thesaurusDescription) .roleArn(thesaurusRoleArn) .sourceS3Path(S3Path.builder() .bucket(s3BucketName) .key(s3Key) .build()) .build(); CreateThesaurusResponse createThesaurusResponse = kendra.createThesaurus(createThesaurusRequest); System.out.println(String.format("Thesaurus response %s", createThesaurusResponse)); String thesaurusId = createThesaurusResponse.id(); System.out.println(String.format("Waiting until the thesaurus with ID %s is created.", thesaurusId)); while (true) { DescribeThesaurusRequest describeThesaurusRequest = DescribeThesaurusRequest.builder() .id(thesaurusId) .indexId(indexId) .build(); DescribeThesaurusResponse describeThesaurusResponse = kendra.describeThesaurus(describeThesaurusRequest); ThesaurusStatus status = describeThesaurusResponse.status(); if (status != ThesaurusStatus.CREATING) { break; } TimeUnit.SECONDS.sleep(60); } System.out.println("Thesaurus creation is complete."); } } ``` ------ # Mettre à jour un thésaurus Vous pouvez modifier la configuration d'un thésaurus après sa création. Vous pouvez modifier des informations telles que le nom du thésaurus et les informations IAM. Vous pouvez également modifier l'emplacement du chemin Amazon S3 du fichier de thésaurus. Si vous modifiez le chemin du fichier de thésaurus, Amazon Kendra remplace le thésaurus existant par le thésaurus spécifié dans le chemin mis à jour. Les effets de la mise à jour de votre fichier de thésaurus peuvent prendre jusqu'à 30 minutes. **Note** En cas d'erreurs de validation ou de syntaxe dans le fichier de thésaurus, le fichier de thésaurus précédemment téléchargé est conservé. Les procédures suivantes indiquent comment modifier les détails du thésaurus. ------ #### [ Console ] **Pour modifier les détails du thésaurus** 1. Dans le volet de navigation de gauche, sous l'index que vous souhaitez modifier, sélectionnez **Synonymes**. 1. **Sur la page des **synonymes**, sélectionnez le thésaurus que vous souhaitez modifier, puis choisissez Modifier.** 1. Sur la page **Mettre à jour le thésaurus**, mettez à jour les détails du thésaurus. 1. (Facultatif) Choisissez **Modifier le chemin du fichier de thésaurus**, puis spécifiez un Amazon S3 chemin d'accès au nouveau fichier de thésaurus. Votre fichier de thésaurus existant est remplacé par le fichier que vous spécifiez. Si vous ne modifiez pas le chemin, Amazon Kendra recharge le thésaurus à partir du chemin existant. Si vous sélectionnez **Conserver le fichier de thésaurus actuel, Amazon Kendra cela ne recharge pas le fichier** de thésaurus. 1. Choisissez **Enregistrer** pour enregistrer la configuration. Vous pouvez également recharger le thésaurus à partir du chemin du thésaurus existant. **Pour recharger un thésaurus à partir d'un chemin existant** 1. Dans le volet de navigation de gauche, sous l'index que vous souhaitez modifier, sélectionnez **Synonymes**. 1. **Sur la page des **synonymes**, sélectionnez le thésaurus que vous souhaitez recharger, puis choisissez Actualiser.** 1. Sur la page **Recharger le fichier de thésaurus**, confirmez que vous souhaitez actualiser le fichier de thésaurus. ------ #### [ CLI ] Pour mettre à jour un thésaurus, appelez `update-thesaurus` : ``` aws kendra update-thesaurus \ --index-id index-id \ --name "thesaurus-name" \ --description "thesaurus-description" \ --source-s3-path "Bucket=bucket-name,Key=thesaurus/synonyms.txt" \ --role-arn role-arn ``` ------ #### [ Python ] ``` import boto3 from botocore.exceptions import ClientError import pprint import time kendra = boto3.client("kendra") print("Update a thesaurus") thesaurus_name = "thesaurus-name" thesaurus_description = "thesaurus-description" thesaurus_role_arn = "role-arn" thesaurus_id = "thesaurus-id" index_id = "index-id" s3_bucket_name = "bucket-name" s3_key = "thesaurus-file" source_s3_path= { 'Bucket': s3_bucket_name, 'Key': s3_key } try: kendra.update_thesaurus( Id = thesaurus_id, IndexId = index_id, Description = thesaurus_description, Name = thesaurus_name, RoleArn = thesaurus_role_arn, SourceS3Path = source_s3_path ) print("Wait for Kendra to update the thesaurus.") while True: # Get thesaurus description thesaurus_description = kendra.describe_thesaurus( Id = thesaurus_id, IndexId = index_id ) # If status is not UPDATING quit status = thesaurus_description["Status"] print("Updating thesaurus. Status: " + status) if status != "UPDATING": break time.sleep(60) except ClientError as e: print("%s" % e) print("Program ends.") ``` ------ #### [ Java ] ``` package com.amazonaws.kendra; import software.amazon.awssdk.services.kendra.KendraClient; import software.amazon.awssdk.services.kendra.model.UpdateThesaurusRequest; import software.amazon.awssdk.services.kendra.model.DescribeThesaurusRequest; import software.amazon.awssdk.services.kendra.model.DescribeThesaurusResponse; import software.amazon.awssdk.services.kendra.model.S3Path; import software.amazon.awssdk.services.kendra.model.ThesaurusStatus; public class UpdateThesaurusExample { public static void main(String[] args) throws InterruptedException { KendraClient kendra = KendraClient.builder().build(); String thesaurusName = "thesaurus-name"; String thesaurusDescription = "thesaurus-description"; String thesaurusRoleArn = "role-arn"; String s3BucketName = "bucket-name"; String s3Key = "thesaurus-file"; String thesaurusId = "thesaurus-id"; String indexId = "index-id"; UpdateThesaurusRequest updateThesaurusRequest = UpdateThesaurusRequest .builder() .id(thesaurusId) .indexId(indexId) .name(thesaurusName) .description(thesaurusDescription) .roleArn(thesaurusRoleArn) .sourceS3Path(S3Path.builder() .bucket(s3BucketName) .key(s3Key) .build()) .build(); kendra.updateThesaurus(updateThesaurusRequest); System.out.println(String.format("Waiting until the thesaurus with ID %s is updated.", thesaurusId)); // a new source s3 path requires re-consumption by Kendra // and so can take as long as a Create Thesaurus operation while (true) { DescribeThesaurusRequest describeThesaurusRequest = DescribeThesaurusRequest.builder() .id(thesaurusId) .indexId(indexId) .build(); DescribeThesaurusResponse describeThesaurusResponse = kendra.describeThesaurus(describeThesaurusRequest); ThesaurusStatus status = describeThesaurusResponse.status(); if (status != ThesaurusStatus.UPDATING) { break; } TimeUnit.SECONDS.sleep(60); } System.out.println("Thesaurus update is complete."); } } ``` ------ # Supprimer un thésaurus Les procédures suivantes indiquent comment supprimer un thésaurus. ------ #### [ Console ] 1. Dans le volet de navigation de gauche, sous l'index que vous souhaitez modifier, sélectionnez **Synonymes**. 1. Sur la page des **synonymes**, sélectionnez le thésaurus que vous souhaitez supprimer. 1. Sur la page **détaillée du thésaurus**, choisissez **Supprimer**, puis confirmez la suppression. ------ #### [ CLI ] Pour supprimer un thésaurus dans un index avec le AWS CLI, appelez `delete-thesaurus` : ``` aws kendra delete-thesaurus \ --index-id index-id \ --id thesaurus-id ``` ------ #### [ Python ] ``` import boto3 from botocore.exceptions import ClientError kendra = boto3.client("kendra") print("Delete a thesaurus") thesaurus_id = "thesaurus-id" index_id = "index-id" try: kendra.delete_thesaurus( Id = thesaurus_id, IndexId = index_id ) except ClientError as e: print("%s" % e) print("Program ends.") ``` ------ #### [ Java ] ``` package com.amazonaws.kendra; import software.amazon.awssdk.services.kendra.KendraClient; import software.amazon.awssdk.services.kendra.model.DeleteThesaurusRequest; public class DeleteThesaurusExample { public static void main(String[] args) throws InterruptedException { KendraClient kendra = KendraClient.builder().build(); String thesaurusId = "thesaurus-id"; String indexId = "index-id"; DeleteThesaurusRequest updateThesaurusRequest = DeleteThesaurusRequest .builder() .id(thesaurusId) .indexId(indexId) .build(); kendra.deleteThesaurus(updateThesaurusRequest); } } ``` ------ # Points saillants dans les résultats de recherche Le surlignage des synonymes est activé par défaut. Les informations de surlignage sont incluses dans les résultats des requêtes du Amazon Kendra SDK et de la CLI. Si vous interagissez à Amazon Kendra l'aide du SDK ou de la CLI, vous déterminez comment afficher les résultats. Les surlignages synonymes auront le type `THESAURUS_SYNONYM` de surlignage. Pour plus d'informations sur les surlignages, consultez l'objet [Highlight](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Highlight.html).