Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Membangun pengalaman pencarian tanpa kode
Anda dapat membangun dan menyebarkan aplikasi Amazon Kendra pencarian tanpa perlu kode front-end apa pun. Amazon Kendra *Experience Builder* membantu Anda membangun dan menerapkan aplikasi pencarian yang berfungsi penuh dalam beberapa klik sehingga Anda dapat segera mulai mencari. Anda dapat mendesain halaman pencarian Anda dan menyesuaikan pencarian Anda untuk menyesuaikan pengalaman dengan kebutuhan pengguna Anda. Amazon Kendra menghasilkan URL titik akhir yang unik dan sepenuhnya dihosting dari halaman pencarian Anda untuk mulai mencari dokumen Anda dan FAQs. Anda dapat dengan cepat membangun bukti konsep pengalaman pencarian Anda dan membagikannya dengan orang lain.
Anda menggunakan template pengalaman pencarian yang tersedia di builder untuk menyesuaikan pencarian Anda. Anda dapat mengundang orang lain untuk berkolaborasi dalam membangun pengalaman penelusuran Anda, atau mengevaluasi hasil penelusuran untuk tujuan penyetelan. Setelah pengalaman pencarian Anda siap bagi pengguna Anda untuk mulai mencari, Anda cukup membagikan URL endpoint yang aman.
## Cara kerja Experience Builder pencarian
Proses keseluruhan membangun pengalaman pencarian adalah sebagai berikut:
1. Anda membuat pengalaman pencarian dengan memberinya nama, deskripsi, dan memilih sumber data yang ingin Anda gunakan untuk pengalaman pencarian Anda.
1. Anda mengonfigurasi daftar pengguna dan grup Anda AWS IAM Identity Center dan kemudian menetapkan hak akses ke pengalaman penelusuran Anda. Anda termasuk diri Anda sebagai pemilik pengalaman. Untuk informasi selengkapnya, lihat [Menyediakan akses ke halaman pencarian Anda](#access-search-experience).
1. Anda membuka Amazon Kendra Experience Builder untuk merancang dan menyetel halaman pencarian Anda. Anda dapat membagikan URL titik akhir pengalaman penelusuran Anda dengan orang lain yang Anda tetapkan sendiri hak akses edit atau hak akses lihat-penelusuran.
Anda memanggil [CreateExperience](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CreateExperience.html)API untuk membuat dan mengonfigurasi pengalaman penelusuran Anda. Jika Anda menggunakan konsol, Anda memilih indeks Anda dan kemudian pilih **Pengalaman** di menu navigasi untuk mengonfigurasi pengalaman Anda.
## Rancang dan sesuaikan pengalaman pencarian Anda
Setelah membuat dan mengonfigurasi pengalaman penelusuran, Anda membuka pengalaman penelusuran menggunakan URL titik akhir untuk mulai menyesuaikan pencarian Anda sebagai pemilik dengan hak akses editor. Anda mengetik kueri Anda ke dalam kotak pencarian, lalu menyesuaikan pencarian Anda menggunakan opsi pengeditan di panel samping untuk melihat bagaimana penerapannya ke halaman Anda. Ketika Anda siap untuk mempublikasikan, pilih **Publish**. Anda juga dapat **beralih antara Beralih ke tampilan langsung**, untuk melihat versi terbaru yang diterbitkan dari halaman pencarian Anda, dan **Beralih ke mode build**, untuk mengedit atau menyesuaikan halaman pencarian Anda.
Berikut ini adalah cara Anda dapat menyesuaikan pengalaman pencarian Anda.
### Filter
Tambahkan pencarian segi atau filter berdasarkan atribut dokumen. Ini termasuk atribut khusus. Anda dapat menambahkan filter menggunakan bidang metadata yang dikonfigurasi sendiri. Misalnya, untuk pencarian segi menurut setiap kategori kota, gunakan atribut dokumen `_category` kustom yang berisi semua kategori kota.
### Jawaban yang disarankan
Tambahkan jawaban yang dihasilkan pembelajaran mesin ke kueri pengguna Anda. Misalnya, *'Seberapa sulit kursus ini?* ' . Amazon Kendra dapat mengambil teks yang paling relevan di semua dokumen yang mengacu pada kesulitan kursus dan menyarankan jawaban yang paling relevan.
### Pertanyaan yang Sering Diajukan
Tambahkan dokumen FAQ untuk memberikan jawaban atas pertanyaan yang sering diajukan. Misalnya, *'Berapa jam untuk menyelesaikan kursus ini?* ' . Amazon Kendra dapat menggunakan dokumen FAQ yang berisi jawaban atas pertanyaan ini dan memberikan jawaban yang benar.
### Urutkan
Tambahkan pengurutan hasil pencarian sehingga pengguna Anda dapat mengatur hasil berdasarkan relevansi, waktu yang dibuat, waktu terakhir diperbarui, dan kriteria penyortiran lainnya.
### Dokumen
Konfigurasikan bagaimana dokumen atau hasil pencarian ditampilkan di halaman pencarian Anda. Anda dapat mengonfigurasi berapa banyak hasil yang ditampilkan pada halaman, menyertakan pagination seperti nomor halaman, mengaktifkan tombol umpan balik pengguna, dan mengatur bagaimana bidang metadata dokumen ditampilkan dalam hasil pencarian.
### Bahasa
Pilih bahasa untuk memfilter hasil pencarian atau dokumen dalam bahasa yang dipilih.
### Kotak pencarian
Konfigurasikan ukuran dan teks placeholder kotak pencarian Anda, serta izinkan saran kueri.
### Penyetelan relevansi
Tambahkan boosting ke bidang metadata dokumen untuk memberi bobot lebih pada bidang ini saat pengguna Anda mencari dokumen. Anda dapat menambahkan bobot yang dimulai dari 1 dan secara bertahap meningkat menjadi 10. Anda dapat meningkatkan teks, tanggal, dan jenis bidang numerik. Misalnya, untuk memberi `_last_updated_at` dan `_created_at` lebih banyak bobot atau kepentingan daripada bidang lain, berikan bidang ini bobot 1 hingga 10, tergantung pada kepentingannya. Anda dapat menerapkan konfigurasi penyetelan relevansi yang berbeda untuk setiap aplikasi atau pengalaman pencarian.
## Menyediakan akses ke halaman pencarian Anda
Akses ke pengalaman pencarian Anda adalah melalui IAM Identity Center. Saat mengonfigurasi pengalaman penelusuran, Anda memberi orang lain yang terdaftar di direktori Pusat Identitas Anda akses ke halaman Amazon Kendra pencarian Anda. Mereka menerima email yang mengarahkan mereka untuk masuk menggunakan kredensialnya di IAM Identity Center untuk mengakses halaman pencarian. Anda harus menyiapkan Pusat Identitas IAM di tingkat organisasi atau tingkat pemegang akun di AWS Organizations. Untuk informasi selengkapnya tentang menyiapkan Pusat Identitas IAM, lihat [Memulai Pusat Identitas IAM](https://docs.aws.amazon.com/kendra/latest/dg/getting-started-aws-sso.html).
Anda mengaktifkan identitas pengguna di Pusat Identitas IAM dengan pengalaman pencarian Anda dan menetapkan izin akses *Penampil* atau *Pemilik* menggunakan API atau konsol.
+ **Penampil**: Diizinkan untuk mengeluarkan kueri, menerima jawaban yang disarankan yang relevan dengan pencarian mereka, dan menyumbangkan umpan balik mereka Amazon Kendra sehingga terus meningkatkan pencarian.
+ **Pemilik**: Diizinkan untuk menyesuaikan desain halaman pencarian, menyetel pencarian, dan menggunakan aplikasi pencarian sebagai *Penampil*. Menonaktifkan akses ke pemirsa di konsol saat ini tidak didukung.
Untuk menetapkan akses orang lain ke pengalaman pencarian Anda, pertama-tama Anda mengaktifkan identitas pengguna di Pusat Identitas IAM dengan Amazon Kendra pengalaman Anda dengan menggunakan objek. [ExperienceConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ExperienceConfiguration.html) Anda menentukan nama bidang yang berisi pengidentifikasi pengguna Anda seperti nama pengguna atau alamat email. Anda kemudian memberikan daftar pengguna akses ke pengalaman penelusuran Anda menggunakan [AssociateEntitiesToExperience](https://docs.aws.amazon.com/kendra/latest/APIReference/API_AssociateEntitiesToExperience.html)API dan menentukan izin mereka sebagai *Penampil* atau *Pemilik* menggunakan [AssociatePersonasToEntities](https://docs.aws.amazon.com/kendra/latest/APIReference/API_AssociatePersonasToEntities.html)API. Anda menentukan setiap pengguna atau grup menggunakan [EntityConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_EntityConfiguration.html)objek dan apakah pengguna atau grup tersebut adalah *Penampil* atau *Pemilik* yang menggunakan [EntityPersonaConfiguraton](https://docs.aws.amazon.com/kendra/latest/APIReference/API_EntityPersonaConfiguration.html)objek tersebut.
Untuk menetapkan akses orang lain ke pengalaman pencarian Anda menggunakan konsol, Anda harus terlebih dahulu membuat pengalaman dan mengonfirmasi identitas Anda dan bahwa Anda adalah pemilik. Kemudian Anda dapat menetapkan pengguna atau grup lain sebagai pemirsa atau pemilik. Di konsol, pilih indeks Anda dan kemudian pilih **Pengalaman** di menu navigasi. Setelah Anda membuat pengalaman Anda, Anda dapat memilih pengalaman Anda dari daftar. Buka **Manajemen akses** untuk menetapkan pengguna atau grup sebagai pemirsa atau pemilik.
## Mengkonfigurasi pengalaman pencarian
Berikut ini adalah contoh mengonfigurasi atau membuat pengalaman pencarian.
------
#### [ Console ]
**Untuk membuat pengalaman Amazon Kendra pencarian**
1. Di panel navigasi kiri, di bawah **Indeks**, pilih **Pengalaman**, lalu pilih **Buat** pengalaman.
1. Pada halaman **Konfigurasi pengalaman**, masukkan nama dan deskripsi untuk pengalaman Anda, pilih sumber konten Anda, dan pilih peran IAM untuk pengalaman Anda. Untuk informasi selengkapnya tentang peran IAM, lihat peran [IAM untuk Amazon Kendra pengalaman](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html).
1. Pada halaman **Konfirmasi identitas Anda dari Pusat Identitas**, pilih ID pengguna Anda seperti email Anda. Jika Anda tidak memiliki direktori Pusat Identitas, cukup masukkan nama lengkap dan email Anda untuk membuat direktori Pusat Identitas. Ini termasuk Anda sebagai pengguna pengalaman dan secara otomatis memberi Anda hak akses pemilik.
1. Pada halaman **Review to open Experience Builder**, tinjau detail konfigurasi Anda dan pilih **Buat pengalaman dan buka Experience Builder** untuk mulai mengedit halaman pencarian Anda.
------
#### [ CLI ]
**Untuk menciptakan Amazon Kendra pengalaman**
```
aws kendra create-experience \
--name {{experience-name}} \
--description {{"experience description"}} \
--index-id {{index-id}} \
--role-arn {{arn:aws:iam::account-id:role/role-name}} \
--configuration '{"ExperienceConfiguration":[{"ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]}, "UserIdentityConfiguration":"identity attribute name"}]}'
aws kendra describe-experience \
--endpoints {{experience-endpoint-URL(s)}}
```
------
#### [ Python ]
**Untuk menciptakan Amazon Kendra pengalaman**
```
import boto3
from botocore.exceptions import ClientError
import pprint
import time
kendra = boto3.client("kendra")
print("Create an experience.")
# Provide a name for the experience
name = "experience-name"
# Provide an optional description for the experience
description = "experience description"
# Provide the index ID for the experience
index_id = "index-id"
# Provide the IAM role ARN required for Amazon Kendra experiences
role_arn = "arn:aws:iam::${account-id}:role/${role-name}"
# Configure the experience
configuration = {"ExperienceConfiguration":
[{
"ContentSourceConfiguration":{"DataSourceIds":["data-source-1","data-source-2"]},
"UserIdentityConfiguration":"identity attribute name"
}]
}
try:
experience_response = kendra.create_experience(
Name = name,
Description = description,
IndexId = index_id,
RoleArn = role_arn,
Configuration = configuration
)
pprint.pprint(experience_response)
experience_endpoints = experience_response["Endpoints"]
print("Wait for Amazon Kendra to create the experience.")
while True:
# Get the details of the experience, such as the status
experience_description = kendra.describe_experience(
Endpoints = experience_endpoints
)
status = experience_description["Status"]
print(" Creating experience. Status: "+status)
time.sleep(60)
if status != "CREATING":
break
except ClientError as e:
print("%s" % e)
print("Program ends.")
```
------
#### [ Java ]
**Untuk membuat sebuah Amazon Kendra**
```
package com.amazonaws.kendra;
import java.util.concurrent.TimeUnit;
import software.amazon.awssdk.services.kendra.KendraClient;
import software.amazon.awssdk.services.kendra.model.CreateExperienceRequest;
import software.amazon.awssdk.services.kendra.model.CreateExperienceResponse;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceRequest;
import software.amazon.awssdk.services.kendra.model.DescribeExperienceResponse;
import software.amazon.awssdk.services.kendra.model.ExperienceStatus;
public class CreateExperienceExample {
public static void main(String[] args) throws InterruptedException {
System.out.println("Create an experience");
String experienceName = "experience-name";
String experienceDescription = "experience description";
String indexId = "index-id";
String experienceRoleArn = "arn:aws:iam::account-id:role/role-name";
KendraClient kendra = KendraClient.builder().build();
CreateExperienceRequest createExperienceRequest = CreateExperienceRequest
.builder()
.name(experienceName)
.description(experienceDescription)
.roleArn(experienceRoleArn)
.configuration(
ExperienceConfiguration
.builder()
.contentSourceConfiguration(
ContentSourceConfiguration(
.builder()
.dataSourceIds("data-source-1","data-source-2")
.build()
)
)
.userIdentityConfiguration(
UserIdentityConfiguration(
.builder()
.identityAttributeName("identity-attribute-name")
.build()
)
).build()
).build();
CreateExperienceResponse createExperienceResponse = kendra.createExperience(createExperienceRequest);
System.out.println(String.format("Experience response %s", createExperienceResponse));
String experienceEndpoints = createExperienceResponse.endpoints();
System.out.println(String.format("Wait for Kendra to create the experience.", experienceEndpoints));
while (true) {
DescribeExperienceRequest describeExperienceRequest = DescribeExperienceRequest.builder().endpoints(experienceEndpoints).build();
DescribeExperienceResponse describeEpxerienceResponse = kendra.describeExperience(describeExperienceRequest);
ExperienceStatus status = describeExperienceResponse.status();
TimeUnit.SECONDS.sleep(60);
if (status != ExperienceStatus.CREATING) {
break;
}
}
System.out.println("Experience creation is complete.");
}
}
```
------