As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Adicionar sinônimos personalizados a um índice Para adicionar sinônimos personalizados a um índice, você os especifica em um arquivo de dicionário de sinônimos. Você pode incluir termos específicos ou especializados da empresa ao Amazon Kendra usar sinônimos. Sinônimos genéricos em inglês, como`leader, head`, são incorporados Amazon Kendra e não devem ser incluídos em um arquivo de dicionário de sinônimos, incluindo sinônimos genéricos que usam hífens. Amazon Kendra suporta sinônimos para todos os tipos de resposta, que incluem tipos de `DOCUMENT` resposta `QUESTION_ANSWER` e/ou tipos de `ANSWER` resposta. Amazon Kendra atualmente não suporta a adição de sinônimos marcados como palavras irrelevantes. Esse sinalizador será incluído em um release futuro. Amazon Kendra faz correlações entre sinônimos. Por exemplo, usando o par sinônimo`Dynamo, Amazon DynamoDB`, Amazon Kendra correlaciona o Dynamo com. Amazon DynamoDB A consulta “O que é dínamo?” em seguida, retorna um documento como “O que é Amazon DynamoDB?”. Com sinônimos, Amazon Kendra é mais fácil captar a correlação. O arquivo de dicionário de sinônimos é um arquivo de texto armazenado em um Amazon S3 bucket. Consulte [Adicionar um dicionário de sinônimos a um índice](index-synonyms-adding-thesaurus-file.md). O arquivo de dicionário de sinônimos usa o formato de sinônimo [Solr.](https://lucene.apache.org/solr/guide/6_6/filter-descriptions.html#FilterDescriptions-SynonymGraphFilter) Amazon Kendra tem um limite no número de dicionários de sinônimos por índice. Consulte [Cotas](https://docs.aws.amazon.com/kendra/latest/dg/quotas.html). Os sinônimos podem ser úteis nos seguintes cenários: + Termos especializados que não são sinônimos tradicionais do idioma inglês, como `NLP, Natural Language Processing`. + Substantivos próprios com associações semânticas complexas. Esses são substantivos que são improváveis que o público em geral entenda como, por exemplo, no machine learning, `cost, loss, model performance`. + Diferentes formas de nomes de produtos como, por exemplo, `Elastic Compute Cloud, EC2`. + Termos específicos do domínio ou da empresa, como nomes de produtos. Por exemplo, .`Route53, DNS` Não use sinônimos nos seguintes cenários: + Sinônimos genéricos do idioma inglês, como `leader, head`. Esses sinônimos não são específicos do domínio, e o uso de sinônimos nesses cenários pode ter efeitos indesejados. + Erros tipográficos, como `teh => the`. + Variantes morfológicas como os plurais e os possessivos dos substantivos, a forma comparativa e superlativa dos adjetivos e o pretérito, o particípio passado e a forma progressiva dos verbos. Um exemplo de adjetivos comparativos e superlativos é `good, better, best`. + Unigram (palavra única) interrompe palavras como `WHO`. Palavras-limite do Unigram não são permitidas no dicionário de sinônimos e são excluídas da pesquisa. Por exemplo, `WHO => World Health Organization` é rejeitado. No entanto, você pode usar `W.H.O.` como um termo sinônimo e pode usar palavras irregulares como parte de um sinônimo de várias palavras. Por exemplo, `of` não é permitido, mas `United States of America` é. Os sinônimos personalizados facilitam a compreensão Amazon Kendra da terminologia específica da sua empresa, expandindo suas consultas para abranger os sinônimos específicos da sua empresa. Embora os sinônimos possam melhorar a precisão da pesquisa, é importante entender como os sinônimos afetam a latência para que você possa otimizar isso. Uma regra geral para sinônimos é: quanto mais termos em sua consulta forem combinados e expandidos com sinônimos, maior será o impacto potencial na latência. Outros fatores que afetam a latência incluem o tamanho médio dos documentos indexados, o tamanho do seu índice, qualquer filtragem nos resultados da pesquisa e a carga geral do seu índice. Amazon Kendra As consultas que não correspondem a nenhum sinônimo não são afetadas. Uma diretriz geral sobre como os sinônimos afetam a latência: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/kendra/latest/dg/index-synonyms.html) \$1*O desempenho varia com base no uso específico de sinônimos e configurações no índice. É melhor testar o desempenho da pesquisa para obter referências mais precisas para o caso de uso específico.* Se o dicionário de sinônimos for grande, tiver uma alta taxa de expansão de prazo e o aumento de latência não estiver dentro dos limites aceitáveis, você pode tentar uma ou as duas opções a seguir: + Corte o dicionário de sinônimos para reduzir a taxa de expansão (número de sinônimos por termo). + Reduza a cobertura geral dos termos (número de linhas no dicionário de sinônimos). Como alternativa, você pode aumentar a capacidade de provisionamento (unidades de armazenamento virtual) para compensar o aumento da latência. **Topics** + [Criando um arquivo de dicionário de sinônimos](index-synonyms-creating-thesaurus-file.md) + [Adicionar um dicionário de sinônimos a um índice](index-synonyms-adding-thesaurus-file.md) + [Atualizando um dicionário de sinônimos](index-synonyms-update.md) + [Atualizando um dicionário de sinônimos](index-synonyms-delete.md) + [Destaques nos resultados da pesquisa](index-synonyms-enabling-synonyms-in-results.md) # Criando um arquivo de dicionário de sinônimos Um arquivo de Amazon Kendra dicionário de sinônimos é um arquivo codificado em UTF-8 contendo uma lista de sinônimos no formato de lista de sinônimos Solr. O arquivo .zip deve ter menos de 5 MB. Há duas maneiras de especificar mapeamentos de sinônimos: + Os *sinônimos bidirecionais* são especificados como uma lista de termos separados por vírgulas. Se o usuário consultar qualquer um dos termos, todos os termos da lista serão usados para pesquisar documentos, o que inclui o termo original consultado. + *Sinônimos unidirecionais* são especificados como termos separados pelo símbolo “=>” entre eles para mapear termos para seus sinônimos. Se o usuário consultar um termo à esquerda do símbolo “=>”, ele será mapeado para um termo à direita para pesquisar documentos usando o sinônimo. Não é mapeado vice-versa, o que o torna unidirecional. Os sinônimos em si diferenciam maiúsculas de minúsculas, mas os termos para os quais eles são mapeados não fazem distinção entre maiúsculas e minúsculas. Por exemplo, `ML => Machine Learning` significa que se so usuário consultar “ML”, “ml” ou usar algum outro caso, ele será mapeado para “Machine Learning”. Se você mapeasse isso vice-versa, `Machine Learning => ML`, “Machine Learning”, “machine learning” ou algum outro caso seria mapeado para “ML”. Um sinônimo não busca uma correspondência exata de caracteres especiais. Por exemplo, se você pesquisar por "dead-letter-queue“, Amazon Kendra poderá retornar documentos que correspondam à “fila de letras mortas” (sem hífen). Se seus documentos contiverem hífens, como "dead-letter-queue“, Amazon Kendra processará os documentos durante a pesquisa para remover hífens. Para termos de sinônimos genéricos em inglês que estão incorporados Amazon Kendra e não devem ser incluídos em um arquivo de dicionário de sinônimos, Amazon Kendra pode pesquisar tanto a versão com hífen do termo quanto a versão sem hífen do termo. Por exemplo, se você pesquisar “terceiros” e “terceiros”, Amazon Kendra retornará documentos que correspondam a qualquer uma das versões desses termos. Para sinônimos que contêm palavras irrelevantes ou palavras comumente usadas, Amazon Kendra retorna documentos que correspondem a termos, incluindo palavras irrelevantes. Por exemplo, você pode criar uma regra de sinônimo para mapear “on boarding” e “onboarding” (integração). Não é possível usar apenas palavras irrelevantes para sinônimos. Por exemplo, se você pesquisar por “ativado”, Amazon Kendra não poderá retornar todos os documentos que contenham “ativado”. Algumas regras de sinônimos são ignoradas. Por exemplo, `a => b` é uma regra, mas `a => a` é ignorada e não conta como regra. A contagem de termos é o número de termos exclusivos no arquivo de sinônimos. O arquivo de exemplo abaixo inclui os termos`AWS CodeStar`, `ML`, `Machine Learning`, `autoscaling group`, `ASG` e muito mais. Há uma quantidade máxima de regras de sinônimos por dicionário de sinônimos e uma quantidade máxima de sinônimos por termo. Para obter mais informações, consulte [Cotas para Amazon Kendra](quotas.md). O exemplo a seguir mostra um arquivo do dicionário de sinônimos com regras de sinônimos. Cada linha contém uma única regra de sinônimo. Linhas em branco e comentários são ignorados. ``` # 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. ``` # Adicionar um dicionário de sinônimos a um índice Os procedimentos a seguir mostram como adicionar um arquivo de dicionário de sinônimos a um índice. Pode levar até 30 minutos para ver os efeitos do arquivo de sinônimos atualizado. Para obter mais informações sobre o arquivo de sinônimos, consulte [Criando um arquivo de dicionário de sinônimos](index-synonyms-creating-thesaurus-file.md): ------ #### [ Console ] **Para adicionar um dicionário de sinônimos** 1. No painel de navegação esquerdo, abaixo do índice em que você deseja adicionar uma lista de sinônimos, o dicionário de sinônimos, escolha **Sinônimos**. 1. Na página **Sinônimo**, escolha **Adicionar dicionário** de sinônimos. 1. Em **Definir dicionário de sinônimos**, dê um nome ao seu dicionário de sinônimos e uma descrição opcional. 1. Nas **configurações do dicionário de sinônimos**, forneça o Amazon S3 caminho para o arquivo do dicionário de sinônimos. O arquivo deve ter menos de 5 MB. 1. Para a **função do IAM**, selecione uma função ou selecione **Criar uma nova função** e especifique um nome de função para criar uma nova função. Amazon Kendra usa essa função para acessar o Amazon S3 recurso em seu nome. A função do IAM tem o prefixo "AmazonKendra-”. 1. Escolha **Salvar** para salvar a configuração e adicionar o dicionário de sinônimos. Depois que o dicionário de sinônimos é ingerido, ele fica ativo e os sinônimos são destacados nos resultados. Pode levar até 30 minutos para ver os efeitos do arquivo de sinônimos atualizado. ------ #### [ CLI ] Para adicionar um dicionário de títulos a um índice com o AWS CLI, chame`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 ``` Chame `list-thesauri` para ver uma lista de dicionários de sinônimos: ``` aws kendra list-thesauri \ --index-id index-id ``` Para ver os detalhes de um dicionário de sinônimos, chame `describe-thesaurus`: ``` aws kendra describe-thesaurus \ --index-id index-id \ --index-id thesaurus-id ``` Pode levar até 30 minutos para ver os efeitos do arquivo de sinônimos atualizado. ------ #### [ 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."); } } ``` ------ # Atualizando um dicionário de sinônimos Não é possível alterar a configuração de um dicionário de sinônimos depois que ele é criado. Você pode alterar detalhes como nome do dicionário de sinônimos e informações do IAM. Você também pode alterar a localização do caminho do arquivo de dicionário de sinônimos no Amazon S3. Se você alterar o caminho para o arquivo do dicionário de sinônimos, Amazon Kendra substituirá o dicionário de sinônimos existente pelo dicionário de sinônimos especificado no caminho atualizado. Pode levar até 30 minutos para ver os efeitos do arquivo de sinônimos atualizado. **nota** Se houver erros de validação ou de sintaxe no arquivo de dicionário de sinônimos, o arquivo de dicionário de sinônimos carregado anteriormente será retido. Os procedimentos a seguir mostram como modificar os detalhes do dicionário de sinônimos. ------ #### [ Console ] **Como modificar detalhes do dicionário de sinônimos** 1. No painel de navegação à esquerda, no índice que deseja modificar, escolha **Sinônimos**. 1. Na página **Sinônimo**, selecione o dicionário de sinônimos que você deseja modificar e escolha **Editar**. 1. Na página **Atualizar dicionário de sinônimos**, atualize os detalhes do dicionário de sinônimos. 1. (Opcional) Escolha **Alterar o caminho do arquivo do dicionário** de sinônimos e, em seguida, especifique um Amazon S3 caminho para o novo arquivo do dicionário de sinônimos. O arquivo de dicionário de sinônimos existente é substituído pelo arquivo que você especificar. Se você não alterar o caminho, Amazon Kendra recarrega o dicionário de sinônimos a partir do caminho existente. Se você selecionar **Manter o arquivo de dicionário de sinônimos atual, Amazon Kendra não recarregará o arquivo** de dicionário de sinônimos. 1. Escolha **Salvar** para salvar a nova configuração. Você também pode recarregar o dicionário de sinônimos a partir do caminho do dicionário de sinônimos existente. **Para recarregar um dicionário de sinônimos a partir de um caminho existente** 1. No painel de navegação à esquerda, no índice que deseja modificar, escolha **Sinônimos**. 1. Na página **Sinônimo**, selecione o dicionário de sinônimos que você deseja recarregar e escolha **Atualizar**. 1. Na página **Recarregar arquivo de dicionário de sinônimos**, confirme que você deseja atualizar o arquivo do dicionário de sinônimos. ------ #### [ CLI ] Para atualizar um dicionário de sinônimos, chame `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."); } } ``` ------ # Atualizando um dicionário de sinônimos Os procedimentos a seguir mostram como excluir um dicionário de sinônimos. ------ #### [ Console ] 1. No painel de navegação à esquerda, no índice que deseja modificar, escolha **Sinônimos**. 1. Na página **Sinônimo**, selecione o dicionário de sinônimos que deseja excluir. 1. Na página de **Detalhes do dicionário de sinônimos**, selecione **Excluir** e, em seguida, confirme para excluir. ------ #### [ CLI ] Para excluir um dicionário de sinônimos de um índice com o AWS CLI, chame`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); } } ``` ------ # Destaques nos resultados da pesquisa O destaque de sinônimos está ativado por padrão. As informações de destaque estão incluídas nos resultados da consulta do Amazon Kendra SDK e da CLI. Se você interagir Amazon Kendra usando o SDK ou a CLI, determinará como exibir os resultados. Os destaques de sinônimos terão o tipo de destaque `THESAURUS_SYNONYM`. Para obter mais informações sobre destaques, consulte o objeto [Destaque](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Highlight.html).