Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Menggunakan Amazon Kendra JavaScript perpustakaan untuk mengirimkan umpan balik

Amazon Kendra menyediakan JavaScript pustaka yang dapat Anda gunakan untuk menambahkan umpan balik klik ke halaman hasil pencarian Anda. Untuk menggunakan pustaka, Anda menyisipkan tanda skrip dalam kode klien Anda yang menampilkan hasil pencarian, lalu menambahkan informasi ke setiap tautan dokumen di daftar hasil Anda. Saat pengguna memilih tautan untuk melihat dokumen, klik informasi dikirim ke Amazon Kendra.

Pustaka bekerja dengan browser yang mendukung JavaScript versiES6/ES2015.

Langkah 1: Masukkan tag skrip ke dalam aplikasi Amazon Kendra pencarian Anda

Dalam kode klien Anda yang merender hasil Amazon Kendra pencarian, masukkan <script>tag dan tambahkan referensi ke JavaScript pustaka:

<script>
 (function(w, d, s, c, g, n) {
   if(!w[n]) {
     w[n] = w[n] || function () {
           (w[n].q = w[n].q || []).push(arguments);
     }
     w[n].st = new Date().getTime();
     w[n].ep = g;
     var e = document.createElement(s),
         j = document.getElementsByTagName(s)[0];
     e.async = 1;
     e.src = c;
     e.type = 'module';
     j.parentNode.insertBefore(e, j);
   }
 })(window, document, 'script', 
 'library download URL', 
 'feedback endpoint',
 'kendraFeedback');
</script>

Skrip secara asinkron mengunduh JavaScript pustaka dari Amazon Kendra host CDN dan menginisialisasi variabel global yang disebut kendraFeedback yang memungkinkan Anda mengatur parameter opsional.

Ganti library download URL and feedback endpoint dengan pengenal dari tabel berikut berdasarkan wilayah yang menghosting Amazon Kendra indeks Anda.

Misalnya, jika indeks Anda berada di AS Timur (Virginia Utara), library download URL adalah https://d2zm0lpns956f8.cloudfront.net/ksf-v1.js dan feedback endpoint adalahhttps://ujxwp5s92h.execute-api.us-east-1.amazonaws.com/prod/submit.

Ada dua pengaturan opsional yang dapat Anda buat untuk Amazon Kendra JavaScript perpustakaan:

Langkah 2: Tambahkan token umpan balik ke hasil pencarian

Pada halaman hasil Anda, tambahkan HTML atribut yang dipanggil data-kendra-token ke tag anchor atau tag div induk langsung yang berisi tautan ke dokumen dari respons kueri. Sebagai contoh:

<a href="document location" data-kendra-token="feedback token value"></a>
OR
<div data-url="document location" data-kendra-token="feedback token value"></div>

Sebuah respons kueri berisi token di bidang feedbackToken. Token unik mengidentifikasi respons jika pengguna memilihnya. Menetapkan nilai token ke atribut data-kendra-token. Amazon Kendra JavaScript Pustaka mencari token ini ketika pengguna memilih hasil dan mengirimkannya ke Amazon Kendra titik akhir sebagai umpan balik.

Amazon Kendra JavaScript Pustaka hanya mengirimkan token umpan balik dan metadata lainnya seperti waktu hasil dipilih dan ID pengunjung unik.

Langkah 3: Menguji umpan balik

Untuk memastikan bahwa JavaScript pustaka dikonfigurasi dengan benar dan mengirimkan umpan balik ke titik akhir yang tepat, lakukan hal berikut. Contoh ini menggunakan peramban Chrome.