Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Mempersonalisasi hasil dari Open Search open source dengan Amazon Personalize
Untuk mempersonalisasi hasil open source OpenSearch, Anda melakukan hal berikut:
1. **Siapkan Amazon Personalize** — Jika Anda belum melakukannya, selesaikan langkah-langkah [Menyiapkan Amazon Personalisasi](setup.md) untuk menyiapkan kredensi dan menyiapkan izin untuk Amazon Personalize. Anda tidak perlu mengatur untuk AWS SDKs mempersonalisasi OpenSearch hasil.
1. **Selesaikan alur kerja Amazon Personalize** — Lengkapi alur kerja Amazon Personalize untuk mengimpor data, membuat solusi dengan resep resep Personalized-Ranking-v 2 atau Personalisasi Peringkat, latih versi solusi kustom, dan terapkan dalam kampanye. Anda harus membuat kumpulan data interaksi Item. Dataset Pengguna dan kumpulan data Item bersifat opsional. Untuk informasi selengkapnya, lihat [Amazon Personalisasi detail alur kerja](personalize-workflow.md).
1. **Siapkan izin** — Siapkan izin agar Anda dapat mengakses sumber daya Amazon Personalisasi dari klaster. OpenSearch Untuk informasi selengkapnya, lihat [Menyiapkan izin](opensearch-granting-access.md).
1. **Instal plugin Amazon Personalize Search Ranking - Plugin** Amazon Personalize Search Ranking menangani komunikasi dengan Amazon Personalisasi dan peringkat ulang hasil.
+ Jika Anda sudah menjalankan OpenSearch cluster, Anda dapat menginstal plugin secara manual. Untuk informasi selengkapnya, lihat [Menginstal plugin secara manual pada OpenSearch cluster yang ada](opensearch-manual-install.md).
+ Jika Anda belum membuat OpenSearch cluster, Anda dapat menggunakan skrip bash quickstart untuk membuatnya. Untuk informasi selengkapnya, lihat [Membuat cluster baru dan menginstal plugin dengan skrip](opensearch-install-with-script.md).
1. **Konfigurasikan plugin Amazon Personalize Search Ranking** — Untuk mengonfigurasi plugin, Anda membuat pipeline pencarian. *Saluran pipa pencarian* adalah kumpulan prosesor permintaan dan respons. Saat membuat pipeline untuk plugin, Anda menentukan sumber daya Amazon Personalisasi dalam prosesor `personalized_search_ranking` respons. Anda juga mengonfigurasi berapa berat plugin yang diberikan hasil dari Amazon Personalisasi saat peringkat ulang hasilnya. Untuk informasi selengkapnya, lihat [Membuat pipa](opensearch-plugin-pipeline-example.md).
1. **Terapkan plugin Amazon Personalize Search Ranking ke OpenSearch kueri — Anda dapat menerapkan plugin** Amazon Personalize Search Ranking ke semua kueri dan tanggapan untuk indeks. OpenSearch Anda juga dapat menerapkan plugin untuk OpenSearch pertanyaan dan tanggapan individual. Untuk informasi tentang menerapkan plugin ke kueri di open source OpenSearch, lihat[Menerapkan plugin](opensource-apply-plugin.md).
1. **Bandingkan hasil** - Plugin Amazon Personalize Search Ranking memberi peringkat ulang hasil pencarian dalam respons kueri. OpenSearch Ini mempertimbangkan peringkat dari Amazon Personalize dan peringkat dari. OpenSearch Untuk memahami bagaimana hasil diberi peringkat ulang, Anda dapat membandingkan hasil dari kueri yang menggunakan personalisasi dan yang tidak. Untuk informasi tentang membandingkan hasil dengan open source OpenSearch, lihat[Membandingkan hasil](opensource-comparing-results.md).
1. **Pantau plugin Amazon Personalize Search Ranking — Saat Anda menerapkan plugin** Amazon Personalize Search Ranking ke kueri penelusuran, Anda dapat memantau plugin dengan mendapatkan metrik untuk pipeline pencarian Anda. Untuk informasi tentang pemantauan plugin pada OpenSearch cluster open source, lihat[Memantau plugin dengan open source OpenSearch](opensource-monitor.md). Untuk kutipan metrik pipeline yang dikembalikan, lihat. OpenSearch [Contoh metrik pipa](monitor-response.md)
**Topics**
+ [Menyiapkan OpenSearch izin sumber terbuka](opensearch-granting-access.md)
+ [Menginstal plugin Amazon Personalize Search Ranking secara manual di cluster yang ada OpenSearch](opensearch-manual-install.md)
+ [Membuat cluster baru dan menginstal plugin dengan skrip](opensearch-install-with-script.md)
+ [Membuat pipeline di open source OpenSearch](opensearch-plugin-pipeline-example.md)
+ [Menerapkan plugin Amazon Personalize Search Ranking ke kueri di open source OpenSearch](opensource-apply-plugin.md)
+ [Membandingkan OpenSearch hasil yang dipersonalisasi dengan hasil tanpa personalisasi](opensource-comparing-results.md)
+ [Memantau plugin dengan open source OpenSearch](opensource-monitor.md)
# Menyiapkan OpenSearch izin sumber terbuka
Jika Anda menggunakan open source OpenSearch, Anda harus dapat mengakses sumber daya Amazon Personalize dari kluster penelusuran terbuka Anda. Untuk memberikan akses, lakukan hal berikut:
+ Jika Anda menyiapkan OpenSearch dari awal, Anda dapat menggunakan [skrip bash mulai cepat](https://github.com/opensearch-project/search-processor/blob/main/helpers/personalized_search_ranking_quickstart.sh) untuk menjalankan OpenSearch cluster di wadah Docker. Skrip menggunakan kredensi default di profil Anda AWS . Anda dapat menentukan profil alternatif saat menjalankan skrip.
Kredensi ini harus dikaitkan dengan pengguna atau peran yang memiliki izin untuk melakukan GetPersonalizedRanking tindakan untuk kampanye Amazon Personalize Anda. Untuk contoh kebijakan IAM, lihat[Contoh kebijakan IAM](#opensearch-role-policy-example). Atau, kredensional harus memiliki izin untuk mengambil peran yang memiliki izin ini. Anda dapat memberikan Amazon Resource Name (ARN) untuk peran ini saat membuat pipeline untuk plugin Amazon Personalize Search Ranking.
+ Jika Anda tidak menggunakan [skrip bash mulai cepat](https://github.com/opensearch-project/search-processor/blob/main/helpers/personalized_search_ranking_quickstart.sh), Anda dapat menambahkan kredensional Anda secara manual ke keystore Anda. OpenSearch Kredensi ini harus sesuai dengan pengguna atau peran yang memiliki izin untuk melakukan GetPersonalizedRanking tindakan untuk kampanye Amazon Personalize Anda.
Untuk menambahkan AWS kredenal Anda secara manual ke OpenSearch keystore Anda, jalankan perintah berikut di mana OpenSearch cluster Anda berjalan (seperti wadah Docker). Kemudian berikan setiap kredensi. Jika Anda tidak menggunakan token sesi, Anda dapat menghilangkan baris terakhir dalam perintah.
```
opensearch-keystore add \
personalized_search_ranking.aws.access_key \
personalized_search_ranking.aws.secret_key \
personalized_search_ranking.aws.session_token
```
+ Jika menjalankan OpenSearch klaster di instans Amazon EC2, Anda dapat memberikan izin dengan profil instans IAM. Kebijakan yang dilampirkan pada peran harus memberinya izin untuk melakukan GetPersonalizedRanking tindakan untuk kampanye Amazon Personalisasi Anda. Itu juga harus memberikan izin Amazon EC2 untuk mengambil peran.
Untuk informasi tentang profil instans Amazon EC2, lihat [Menggunakan profil instans](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html). Untuk contoh kebijakan, lihat[Contoh kebijakan IAM](#opensearch-role-policy-example).
## Contoh kebijakan IAM
Contoh kebijakan berikut memberi pengguna atau peran izin minimum untuk mendapatkan peringkat yang dipersonalisasi dari kampanye Amazon Personalize Anda. Untuk`Campaign ARN`, tentukan Nama Sumber Daya Amazon (ARN) dari kampanye Amazon Personalize Anda.
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"personalize:GetPersonalizedRanking"
],
"Resource": "arn:aws:personalize:us-east-1:111122223333:campaign/YourResourceId"
}
]
}
```
------
Selain itu, jika Anda menjalankan OpenSearch klaster di instans Amazon EC2 dan memberikan izin dengan profil instans IAM, kebijakan kepercayaan untuk peran tersebut harus memberikan izin Amazon EC2 sebagai berikut. `AssumeRole` Untuk informasi tentang profil instans Amazon EC2, lihat [Menggunakan profil instans](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_switch-role-ec2_instance-profiles.html).
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "ec2.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
# Menginstal plugin Amazon Personalize Search Ranking secara manual di cluster yang ada OpenSearch
Jika Anda sudah memiliki OpenSearch cluster, Anda dapat menginstal plugin secara manual di cluster Anda langsung dari OpenSearch GitHub repositori.
**Untuk menginstal plugin secara manual**
1. Gunakan perintah berikut untuk memulai OpenSearch cluster Anda:
```
bin/opensearch
```
1. Jika Anda belum melakukannya, unggah data katalog Anda ke OpenSearch klaster Anda. Saat mengunggah data, Anda membuat OpenSearch indeks dan menentukan pemetaan bidang Anda. Kemudian Anda mengunggah data Anda ke indeks itu. Sebagai contoh, lihat [Membuat indeks dan pemetaan bidang menggunakan data sampel](https://opensearch.org/docs/latest/quickstart/#create-an-index-and-field-mappings-using-sample-data).
1. Gunakan perintah berikut untuk menginstal plugin:
```
bin/opensearch-plugin install https://github.com/opensearch-project/search-processor/releases/download/2.9.0/opensearch-search-processor-2.9.0.0.zip
```
Untuk informasi selengkapnya tentang menginstal plugin, lihat [Menginstal plugin](https://opensearch.org/docs/latest/install-and-configure/plugins/).
Setelah Anda menginstal plugin Amazon Personalize Search Ranking, Anda siap untuk mengonfigurasinya. Anda mengonfigurasi plugin dengan membuat pipeline pencarian dan menentukan prosesor `personalized_search_ranking` respons. Lihat informasi yang lebih lengkap di [Membuat pipa](opensearch-plugin-pipeline-example.md).
# Membuat cluster baru dan menginstal plugin dengan skrip
Jika Anda belum membuat OpenSearch cluster, Anda dapat menggunakan skrip bash quickstart untuk membuatnya. Skrip ini menyiapkan OpenSearch cluster dalam wadah Docker, menyiapkan kredensyal menggunakan AWS profil default Anda, dan menginstal plugin Amazon Personalize Search Ranking.
Untuk informasi tentang membuat OpenSearch cluster secara manual, lihat petunjuk [Mulai Cepat](https://opensearch.org/docs/quickstart) di OpenSearch dokumentasi.
**Untuk menginstal plugin dengan skrip bash quickstart**
1. Sebelum Anda menjalankan skrip, unduh dan instal [Docker Desktop](https://docs.docker.com/get-docker/) untuk sistem operasi Anda.
1. Unduh [skrip bash mulai cepat](https://github.com/opensearch-project/search-processor/blob/main/helpers/personalized_search_ranking_quickstart.sh) dari GitHub.
1. Di direktori kerja Anda, jalankan skrip dengan perintah berikut.
```
sh personalized_search_ranking_quickstart.sh
```
Dengan perintah ini, skrip menggunakan kredensyal di profil default AWS Anda. Untuk memberikan profil alternatif, gunakan `--profile` argumen.
```
sh personalized_search_ranking_quickstart.sh --profile profile-name
```
Setelah Anda menjalankan skrip, Anda dapat menemukan informasi lebih lanjut tentang skrip dalam file README yang terletak di direktori unik yang dibuat oleh skrip. Direktori ini menyimpan file Dockerfile dan docker-compose.yl yang digunakan skrip. Sebagai contoh: `../opensearch-personalize-intelligent-ranking-docker.1234/README`.
1. Unggah data katalog Anda ke OpenSearch klaster Anda. Saat mengunggah data, Anda membuat OpenSearch indeks dan menentukan pemetaan bidang Anda. Kemudian Anda mengunggah data Anda ke indeks itu. Sebagai contoh, lihat [Membuat indeks dan pemetaan bidang menggunakan data sampel](https://opensearch.org/docs/latest/quickstart/#create-an-index-and-field-mappings-using-sample-data).
Setelah menyiapkan OpenSearch dan menginstal plugin Amazon Personalize Search Ranking, Anda siap mengonfigurasinya. Anda mengonfigurasi plugin dengan membuat pipeline pencarian dan menentukan prosesor `personalized_search_ranking` respons. Lihat informasi yang lebih lengkap di [Membuat pipa](opensearch-plugin-pipeline-example.md).
# Membuat pipeline di open source OpenSearch
Setelah Anda menginstal plugin di cluster Anda, Anda siap untuk mengkonfigurasinya dengan membuat pipeline OpenSearch pencarian.
*Pipeline pencarian* adalah sekumpulan prosesor permintaan dan respons yang berjalan secara berurutan sesuai urutan yang Anda buat. Saat Anda membuat pipeline pencarian untuk plugin, Anda menentukan prosesor `personalized_search_ranking` respons. Untuk informasi tentang saluran pipa pencarian, lihat [Cari saluran pipa](https://opensearch.org/docs/latest/search-plugins/search-pipelines/index/).
Setelah Anda membuat pipeline dengan prosesor `personalized_search_ranking` respons, Anda siap untuk mulai menerapkan plugin ke kueri. Untuk informasi selengkapnya, lihat [Menerapkan plugin](opensource-apply-plugin.md).
Anda dapat menggunakan perintah curl berikut untuk membuat pipeline pencarian dengan prosesor `personalized_search_ranking` respons pada OpenSearch cluster open source. Untuk penjelasan lengkap dari setiap `personalized_search_ranking` parameter, lihat[Bidang untuk prosesor `personalized_search_ranking` respons](opensearch-plugin-pipeline-fields.md).
```
curl -X PUT "http://localhost:9200/_search/pipeline/pipeline-name" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
{
"description": "A pipeline to apply custom re-ranking from Amazon Personalize",
"response_processors" : [
{
"personalized_search_ranking" : {
"campaign_arn" : "Amazon Personalize Campaign ARN",
"item_id_field" : "productId",
"recipe" : "aws-personalized-ranking-v2",
"weight" : "0.3",
"tag" : "personalize-processor",
"iam_role_arn": "Role ARN",
"aws_region": "AWS region",
"ignore_failure": true
}
}
]
}'
```
Setelah membuat pipeline pencarian dengan prosesor `personalized_search_ranking` respons, Anda siap untuk mulai menerapkan plugin ke OpenSearch kueri. Anda dapat menerapkannya ke OpenSearch indeks atau OpenSearch kueri individual. Lihat informasi yang lebih lengkap di [Menerapkan plugin Amazon Personalize Search Ranking ke kueri di open source OpenSearch](opensource-apply-plugin.md).
# Menerapkan plugin Amazon Personalize Search Ranking ke kueri di open source OpenSearch
Anda dapat menerapkan plugin Amazon Personalize Search Ranking ke semua kueri dan tanggapan untuk indeks. OpenSearch Anda juga dapat menerapkan plugin untuk OpenSearch pertanyaan dan tanggapan individual.
+ Perintah curl berikut menerapkan pipeline pencarian ke OpenSearch indeks di OpenSearch cluster open source yang berjalan secara lokal. Dengan pendekatan ini, semua pencarian di indeks ini menggunakan plugin untuk menerapkan personalisasi ke hasil pencarian.
```
curl -XGET "https://localhost:9200/index/_settings" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
{
"index.search.default_pipeline": "pipeline-name"
}
'
```
+ Perintah curl berikut menerapkan pipeline pencarian ke kueri individu untuk mobil merek Toyota pada indeks di OpenSearch cluster open source yang berjalan secara lokal.
Untuk`user_id`, tentukan ID pengguna tempat Anda mendapatkan hasil penelusuran. Pengguna ini harus berada dalam data yang Anda gunakan untuk membuat versi solusi Amazon Personalize Anda. Jika pengguna tidak hadir, Amazon Personalize memberi peringkat item berdasarkan popularitasnya. Untuk`context`, jika Anda menggunakan metadata kontekstual, berikan metadata kontekstual pengguna, seperti jenis perangkat mereka. `context`Bidang ini opsional. Untuk informasi selengkapnya, lihat [Meningkatkan relevansi rekomendasi dengan metadata kontekstual](contextual-metadata.md).
```
curl -XGET "http://localhost:9200/index/_search?search_pipeline=pipeline-name" -ku 'admin:admin' --insecure -H 'Content-Type: application/json' -d'
{
"query": {
"multi_match": {
"query": "Toyota",
"fields": ["BRAND"]
}
},
"ext": {
"personalize_request_parameters": {
"user_id": "USER ID",
"context": { "DEVICE": "mobile phone" }
}
}
}
'
```
Untuk memahami bagaimana hasil diberi peringkat ulang, Anda dapat menggunakan OpenSearch Dasbor untuk membandingkan OpenSearch hasil dengan hasil yang diberi peringkat ulang dengan plugin. Untuk informasi selengkapnya, lihat [Membandingkan OpenSearch hasil yang dipersonalisasi dengan hasil tanpa personalisasi](opensource-comparing-results.md).
Saat Anda menerapkan plugin ke OpenSearch kueri, Anda dapat memantau plugin dengan mendapatkan metrik untuk pipeline Anda OpenSearch. Lihat informasi yang lebih lengkap di [Memantau plugin dengan open source OpenSearch](opensource-monitor.md).
# Membandingkan OpenSearch hasil yang dipersonalisasi dengan hasil tanpa personalisasi
Untuk memahami bagaimana hasil diberi peringkat ulang, Anda dapat menjalankan kueri dengan [konsol Alat Dev](https://opensearch.org/docs/latest/dashboards/dev-tools/run-queries) di dua jendela browser terpisah. Kemudian Anda dapat membandingkan hasil untuk kueri dengan dan tanpa personalisasi.
**Untuk membandingkan hasil dengan konsol Dev Tools**
1. Pastikan OpenSearch Dashboard sudah terpasang. Skrip bash quickstart menginstal OpenSearch Dasbor. Jika Anda tidak menggunakan skrip atau sudah menjalankan cluster, Anda harus menginstal OpenSearch Dasbor. Untuk informasi selengkapnya, lihat [Menginstal OpenSearch Dasbor](https://opensearch.org/docs/latest/install-and-configure/install-dashboards/index/).
1. Luncurkan OpenSearch Dasbor. Buka `http://localhost:5601` dari browser dan masuk ke OpenSearch Dasbor. Kredensi default adalah nama pengguna 'admin' dan kata sandi 'admin'.
1. Pilih **Alat Pengembang** di bawah menu Manajemen di halaman beranda OpenSearch Dasbor.
1. Buka jendela browser terpisah dan buka konsol Dev Tools lagi. Anda dapat menggunakan URL dari jendela sebelumnya.
1. Dalam satu jendela, masukkan kueri yang tidak menggunakan peringkat ulang apa pun untuk personalisasi. Di jendela lain, masukkan perintah curl yang menggunakan pipeline dengan prosesor `personalized_search_ranking` respons. Jika Anda menempelkan perintah curl langsung ke konsol, perintah tersebut secara otomatis diubah menjadi format yang digunakan konsol. Untuk contoh perintah, lihat[Menerapkan plugin Amazon Personalize Search Ranking ke kueri di open source OpenSearch](opensource-apply-plugin.md).
1. Jalankan kedua kueri dan bandingkan hasilnya.
# Memantau plugin dengan open source OpenSearch
Saat Anda menerapkan plugin Amazon Personalize Search Ranking ke OpenSearch kueri, Anda dapat memantau plugin dengan mendapatkan metrik untuk pipeline pencarian Anda. Metrik pipeline mencakup statistik seperti jumlah permintaan gagal untuk prosesor `personalized_search_ranking` respons.
Anda dapat menggunakan kode berikut untuk mendapatkan metrik untuk semua pipeline Anda. Respons berisi statistik untuk semua pipeline pencarian. Untuk contoh metrik pipeline, lihat[Contoh metrik pipa](monitor-response.md).
```
curl -XGET "https://localhost:9200/_nodes/stats/search_pipeline?pretty" -ku 'admin:admin'
```