Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Menambahkan sinonim khusus ke indeks Untuk menambahkan sinonim khusus ke indeks, Anda menentukannya dalam file tesaurus. Anda dapat memasukkan istilah khusus bisnis atau khusus dalam Amazon Kendra menggunakan sinonim. Sinonim bahasa Inggris generik, seperti`leader, head`, dibangun ke dalam Amazon Kendra dan tidak boleh dimasukkan dalam file tesaurus, termasuk sinonim generik yang menggunakan tanda hubung. Amazon Kendra mendukung sinonim untuk semua jenis respons, yang mencakup jenis `DOCUMENT` respons dan `QUESTION_ANSWER` atau jenis `ANSWER` respons. Amazon Kendra saat ini tidak mendukung penambahan sinonim yang ditandai sebagai stopwords. Ini harus dimasukkan dalam rilis future. Amazon Kendra membuat korelasi antara sinonim. Misalnya, menggunakan pasangan sinonim`Dynamo, Amazon DynamoDB`, Amazon Kendra berkorelasi Dynamo dengan. Amazon DynamoDB Kuerinya “Apa itu dynamo?” kemudian mengembalikan dokumen seperti “Apa itu Amazon DynamoDB?”. Dengan sinonim, Amazon Kendra dapat lebih mudah mengambil korelasi. File tesaurus adalah file teks yang disimpan dalam ember. Amazon S3 Lihat [Menambahkan tesaurus ke indeks](index-synonyms-adding-thesaurus-file.md). File tesaurus menggunakan format sinonim [Solr](https://lucene.apache.org/solr/guide/6_6/filter-descriptions.html#FilterDescriptions-SynonymGraphFilter). Amazon Kendra memiliki batas jumlah tesauri per indeks. Lihat [Kuota](https://docs.aws.amazon.com/kendra/latest/dg/quotas.html). Sinonim dapat berguna dalam skenario berikut: + Istilah khusus yang bukan sinonim bahasa Inggris tradisional seperti `NLP, Natural Language Processing`. + Kata benda yang tepat dengan asosiasi semantik yang kompleks. Ini adalah kata benda yang jarang dimengerti masyarakat umum, misalnya, dalam machine learning, `cost, loss, model performance`. + Berbagai bentuk nama produk, misalnya, `Elastic Compute Cloud, EC2`. + Istilah khusus domain atau bisnis tertentu, seperti nama produk. Misalnya, `Route53, DNS`. Jangan menggunakan sinonim dalam skenario berikut: + Sinonim bahasa Inggris generik seperti `leader, head`. Sinonim ini tidak khusus domain, dan menggunakan sinonim dalam skenario ini mungkin memiliki efek yang tidak diinginkan. + Kesalahan tipografi seperti `teh => the`. + Varian morfologi seperti jamak dan memiliki kata benda, bentuk kata sifat komparatif dan superlatif, dan bentuk lampau, partisip masa lalu dan bentuk kata kerja progresif. Salah satu contoh kata sifat komparatif dan superlatif adalah `good, better, best`. + Kata berhenti unigram (satu kata) seperti `WHO`. Kata berhenti unigram tidak diperbolehkan dalam tesaurus dan dikecualikan dari pencarian. Misalnya, `WHO => World Health Organization` ditolak. Anda dapat menggunakan `W.H.O.` hanya sebagai istilah sinonim, dan Anda dapat menggunakan kata henti sebagai bagian dari sinonim multi-kata. Misalnya, `of` diperbolehkan, tapi `United States of America` tidak. Sinonim khusus memudahkan untuk meningkatkan pemahaman Amazon Kendra tentang terminologi spesifik bisnis Anda dengan memperluas pertanyaan Anda untuk mencakup sinonim khusus bisnis Anda. Meskipun sinonim dapat meningkatkan akurasi pencarian, penting untuk memahami bagaimana sinonim mempengaruhi latensi sehingga Anda dapat mengoptimalkannya untuk ini. Aturan umum untuk sinonim adalah: semakin banyak istilah dalam kueri Anda yang dicocokkan dan diperluas dengan sinonim, semakin besar potensi dampak pada latensi. Faktor lain yang memengaruhi latensi termasuk ukuran rata-rata dokumen yang diindeks, ukuran indeks Anda, pemfilteran apa pun pada hasil penelusuran, dan beban keseluruhan pada indeks Anda. Amazon Kendra Kueri yang tidak cocok dengan sinonim apa pun tidak akan terpengaruh. Panduan umum tentang bagaimana sinonim memengaruhi latensi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/kendra/latest/dg/index-synonyms.html) \$1*Performa bervariasi berdasarkan penggunaan spesifik Anda atas sinonim dan konfigurasi pada indeks Anda. Sebaiknya uji performa penelusuran untuk mendapatkan tolok ukur yang lebih akurat untuk kasus penggunaan spesifik Anda.* Jika tesaurus Anda besar, memiliki rasio ekspansi jangka tinggi, dan peningkatan latensi Anda tidak dalam batas yang dapat diterima, Anda dapat mencoba salah satu atau kedua hal berikut: + Potong tesaurus Anda untuk mengurangi rasio ekspansi (jumlah sinonim per istilah). + Potong cakupan keseluruhan istilah (jumlah baris dalam tesaurus Anda). Atau, Anda dapat meningkatkan kapasitas penyediaan (unit penyimpanan virtual) untuk mengimbangi peningkatan latensi. **Topics** + [Membuat file tesaurus](index-synonyms-creating-thesaurus-file.md) + [Menambahkan tesaurus ke indeks](index-synonyms-adding-thesaurus-file.md) + [Memperbarui tesaurus](index-synonyms-update.md) + [Menghapus tesaurus](index-synonyms-delete.md) + [Sorotan dalam hasil pencarian](index-synonyms-enabling-synonyms-in-results.md) # Membuat file tesaurus File Amazon Kendra TESAURUS adalah file yang dikodekan UTF-8 yang berisi daftar sinonim dalam format daftar sinonim Solr. File tesaurus harus kurang dari 5 MB. Ada dua cara untuk menentukan pemetaan sinonim: + *Sinonim dua arah* ditetapkan sebagai daftar istilah yang dipisahkan koma. Jika pengguna Anda menanyakan salah satu istilah, maka semua istilah dalam daftar digunakan untuk mencari dokumen, yang mencakup istilah kueri asli. + *Sinonim searah* ditentukan sebagai istilah yang dipisahkan oleh simbol “=>” di antara mereka untuk memetakan istilah ke sinonimnya. Jika pengguna Anda menanyakan istilah di sebelah kiri simbol “=>”, maka itu dipetakan ke istilah di sebelah kanan untuk mencari dokumen menggunakan sinonim. Itu tidak dipetakan sebaliknya, membuat ini searah. Sinonim itu sendiri peka huruf besar/kecil, tetapi istilah yang mereka petakan tidak peka huruf besar/kecil. Misalnya, `ML => Machine Learning` jika pengguna Anda menanyakan “ML” atau “mL” atau menggunakan beberapa kasus lain, itu akan dipetakan ke “Machine Learning”. Jika Anda memetakan ini sebaliknya`Machine Learning => ML`, maka “Machine Learning” atau “machine learning” atau kasus lain akan dipetakan ke “ML”. Sinonim tidak mencari kecocokan persis pada karakter khusus. Misalnya, jika Anda mencari "dead-letter-queue“, Amazon Kendra dapat mengembalikan dokumen yang cocok dengan “antrian surat mati” (tidak ada tanda hubung). Jika dokumen Anda berisi tanda hubung, seperti "dead-letter-queue“, Amazon Kendra proses dokumen selama pencarian untuk menghapus tanda hubung. Untuk istilah sinonim bahasa Inggris generik yang dibangun ke dalam Amazon Kendra dan tidak boleh dimasukkan dalam file tesaurus, Amazon Kendra dapat mencari versi tanda hubung dari istilah dan versi non-tanda hubung dari istilah tersebut. Misalnya, jika Anda mencari “pihak ketiga” dan “pihak ketiga”, Amazon Kendra mengembalikan dokumen yang cocok dengan salah satu versi istilah tersebut. Untuk sinonim yang berisi stopword atau kata yang umum digunakan, Amazon Kendra mengembalikan dokumen yang cocok dengan istilah termasuk stopword. Misalnya, Anda dapat membuat aturan sinonim untuk memetakan “saat naik pesawat” dan “orientasi”. Anda tidak dapat menggunakan stopwords sendirian untuk sinonim. Misalnya, jika Anda mencari “on”, Amazon Kendra tidak dapat mengembalikan semua dokumen yang berisi “on”. Beberapa aturan sinonim diabaikan. Misalnya, `a => b` adalah aturan, tetapi `a => a` diabaikan dan tidak dihitung sebagai aturan. Jumlah istilah adalah jumlah istilah unik dalam file theaurus. Contoh file di bawah ini mencakup istilah`AWS CodeStar`,`ML`,`Machine Learning`,`autoscaling group`,`ASG`, dan banyak lagi. Ada jumlah maksimum aturan sinonim per tesaurus dan jumlah maksimum sinonim per istilah. Untuk informasi selengkapnya, lihat [Kuota untuk Amazon Kendra](quotas.md). Contoh berikut menunjukkan file tesaurus dengan aturan sinonim. Setiap baris berisi aturan sinonim tunggal. Baris kosong dan komentar diabaikan. ``` # 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. ``` # Menambahkan tesaurus ke indeks Prosedur berikut menunjukkan cara menambahkan file tesaurus yang berisi sinonim indeks. Diperlukan waktu hingga 30 menit untuk melihat efek dari file tesaurus Anda yang diperbarui. Untuk informasi selengkapnya tentang file tesaurus, lihat [Membuat file tesaurus](index-synonyms-creating-thesaurus-file.md). ------ #### [ Console ] **Untuk menambahkan tesaurus** 1. Di panel navigasi kiri, di bawah indeks tempat Anda ingin menambahkan daftar sinonim, tesaurus Anda, pilih **Sinonim**. 1. Pada halaman **Sinonim**, pilih **Tambahkan Thesaurus**. 1. Dalam **Tentukan tesaurus**, berikan nama tesaurus Anda dan deskripsi opsional. 1. Dalam **pengaturan Tesaurus**, berikan Amazon S3 jalur ke file tesaurus Anda. File harus lebih kecil dari 5 MB. 1. Untuk **Peran IAM**, pilih peran atau pilih **Buat peran baru** dan tentukan nama peran untuk membuat peran baru. Amazon Kendra menggunakan peran ini untuk mengakses Amazon S3 sumber daya atas nama Anda. Peran IAM memiliki awalan "AmazonKendra-”. 1. Pilih **Simpan** untuk menyimpan konfigurasi dan menambahkan tesaurus. Setelah tesaurus diserap, ia aktif dan sinonim disorot dalam hasil. Diperlukan waktu hingga 30 menit untuk melihat efek file tesaurus Anda. ------ #### [ CLI ] Untuk menambahkan thesarus ke indeks dengan AWS CLI, panggil: `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 ``` Panggil `list-thesauri` untuk melihat daftar tesaurus: ``` aws kendra list-thesauri \ --index-id index-id ``` Untuk melihat detail tesaurus, panggil `describe-thesaurus`: ``` aws kendra describe-thesaurus \ --index-id index-id \ --index-id thesaurus-id ``` Diperlukan waktu hingga 30 menit untuk melihat efek file tesaurus Anda. ------ #### [ 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."); } } ``` ------ # Memperbarui tesaurus Anda dapat mengubah konfigurasi tesaurus setelah dibuat. Anda dapat mengubah detail seperti nama tesaurus dan informasi IAM. Anda juga dapat mengubah lokasi path file tesaurus Amazon S3. Jika Anda mengubah jalur ke file tesaurus, Amazon Kendra ganti tesaurus yang ada dengan tesaurus yang ditentukan di jalur yang diperbarui. Diperlukan waktu hingga 30 menit untuk melihat efek dari file tesaurus Anda yang diperbarui. **catatan** Jika ada kesalahan validasi atau sintaks dalam file tesaurus, file tesaurus yang diunggah sebelumnya akan dipertahankan. Prosedur berikut menunjukkan cara mengubah detail tesaurus. ------ #### [ Console ] **Untuk mengubah detail tesaurus** 1. Di panel navigasi kiri, di bawah indeks yang ingin Anda ubah, pilih **Sinonim**. 1. Pada halaman **Sinonim**, pilih tesaurus yang ingin Anda ubah dan kemudian pilih **Edit**. 1. Pada halaman **Memperbarui tesaurus**, perbarui detail tesaurus. 1. (Opsional) Pilih **Ubah jalur file tesaurus dan kemudian tentukan Amazon S3 jalur** ke file tesaurus baru. File tesaurus yang ada digantikan oleh file yang Anda tentukan. Jika Anda tidak mengubah jalur, Amazon Kendra muat ulang tesaurus dari jalur yang ada. Jika Anda memilih **Simpan file tesaurus saat ini, Amazon Kendra tidak memuat ulang file** tesaurus. 1. Pilih **Simpan** untuk menyimpan konfigurasi. Anda juga dapat memuat ulang tesaurus dari path tesaurus yang ada. **Untuk memuat ulang tesaurus dari path yang ada** 1. Di panel navigasi kiri, di bawah indeks yang ingin Anda ubah, pilih **Sinonim**. 1. **Pada halaman **Sinonim**, pilih tesaurus yang ingin dimuat ulang dan kemudian pilih Refresh.** 1. Pada halaman **Reload thesaurus file**, konfirmasikan bahwa Anda ingin me-refresh file tesaurus. ------ #### [ CLI ] Untuk memperbarui tesaurus, panggil `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."); } } ``` ------ # Menghapus tesaurus Prosedur berikut menunjukkan cara menghapus tesaurus. ------ #### [ Console ] 1. Di panel navigasi kiri, di bawah indeks yang ingin Anda ubah, pilih **Sinonim**. 1. Pada halaman **Sinonim**, pilih tesaurus yang ingin Anda hapus. 1. Pada halaman **Detail tesaurus**, pilih **Hapus** dan kemudian konfirmasikan untuk menghapus. ------ #### [ CLI ] Untuk menghapus thesarus ke indeks dengan AWS CLI, panggil: `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); } } ``` ------ # Sorotan dalam hasil pencarian Penyorotan sinonim aktif secara default. Informasi sorotan disertakan dalam hasil Amazon Kendra kueri SDK dan CLI. Jika Anda berinteraksi dengan Amazon Kendra menggunakan SDK atau CLI, Anda menentukan cara menampilkan hasil. Sorotan sinonim akan mempunyai jenis sorotan `THESAURUS_SYNONYM`. Untuk informasi selengkapnya tentang sorotan, lihat objek [Sorotan](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Highlight.html).