Meningkatkan dan menyembunyikan rekomendasi media

Catatan: Fitur ini adalah penawaran Pratinjau, yang tunduk pada "Persyaratan Penawaran Pra-GA" dari Persyaratan Khusus Layanan GCP. Produk dan fitur pra-GA mungkin memiliki dukungan terbatas, dan perubahan pada produk serta fitur pra-GA mungkin tidak kompatibel dengan versi pra-GA lainnya. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran. Selain itu, dengan menggunakan fitur ini, Anda menyetujui persyaratan dan ketentuan Pratinjau AI Generatif ("Persyaratan Pratinjau"). Untuk fitur ini, Anda dapat memproses data pribadi sebagaimana diuraikan dalam Adendum Pemrosesan Data Cloud, dengan tunduk pada batasan dan kewajiban yang berlaku dalam Perjanjian (sebagaimana didefinisikan dalam Persyaratan Pratinjau).

Halaman ini menjelaskan cara mengubah posisi peringkat rekomendasi media yang ditampilkan oleh model menggunakan kontrol penayangan boost/bury.

Kontrol boost/bury mengubah urutan rekomendasi setelah rekomendasi tersebut ditampilkan oleh model. Anda menerapkan ekspresi filter ke hasil untuk mengidentifikasi rekomendasi yang ingin Anda tingkatkan atau sembunyikan, lalu menerapkan nilai peningkatan antara -1 dan +1. Nilai peningkatan sebesar +1 memberikan peningkatan terbesar pada rekomendasi, menempatkannya di bagian atas rekomendasi yang ditampilkan. Nilai -1 menyembunyikan rekomendasi di bagian bawah daftar rekomendasi yang ditampilkan.

Meningkatkan/menyembunyikan adalah kontrol pasca-model. Pertama, model rekomendasi menampilkan daftar rekomendasi. Dengan menggunakan konfigurasi penayangan, kontrol boost/bury kemudian diterapkan ke daftar tersebut untuk menyesuaikan peringkat rekomendasi. Kontrol dorong/sembunyikan tidak menambahkan atau menghapus rekomendasi, tetapi mengontrol urutan rekomendasi yang ditampilkan kepada pengguna.

Rekomendasi meningkatkan/menyembunyikan versus memfilter

Tingkatkan/sembunyikan adalah filter lunak. Sedangkan, filter reguler untuk rekomendasi, yang dijelaskan dalam Memfilter rekomendasi adalah filter keras.

Jika menerapkan filter keras ke rekomendasi, Anda tidak akan pernah melihat dokumen yang difilter. Namun, dengan filter lembut, Anda tidak menghapus dokumen dari daftar rekomendasi. Sebagai gantinya, filter digunakan untuk menentukan dokumen mana yang harus lebih tinggi atau lebih rendah dalam daftar rekomendasi yang ditampilkan.

Hindari membebani model rekomendasi Anda

Saat menerapkan filter dorong atau sembunyikan, sebaiknya gunakan nilai kecil yang mendekati nol. Nilai yang mendekati +1 atau -1 cenderung akan membebani model rekomendasi, sehingga peringkat rekomendasi yang diterapkan oleh model tidak tercermin dalam urutan yang dilihat pengguna.

Misalnya, jika Anda meningkatkan film animasi dengan +1, pengguna hanya akan melihat film animasi di bagian atas daftar rekomendasi; hal ini akan mendorong film non-animasi yang sangat direkomendasikan oleh model ke bagian bawah daftar tempat pengguna mungkin tidak melihatnya.

Mendemosikan versus mengubur

Mendemosikan dan menyembunyikan rekomendasi akan memindahkan rekomendasi ke posisi yang lebih rendah dalam daftar rekomendasi yang ditampilkan.

Namun, penurunan didasarkan pada usia konten atau apakah pengguna telah menonton beberapa konten. Untuk mengetahui informasi selengkapnya tentang penurunan, lihat Menurunkan rekomendasi media.

Penyamaran berlaku untuk konten yang diidentifikasi oleh filter. Filter dapat berupa kolom data apa pun yang ditandai sebagai dapat difilter dalam skema. Untuk informasi umum tentang filter rekomendasi, termasuk cara menandai kolom sebagai dapat difilter, lihat Rekomendasi filter.

Tentang kontrol dorong/sembunyikan dan konfigurasi penayangan

Setiap kontrol penayangan boost/bury terdiri dari filter dan nilai boost. Misalnya, satu kontrol peningkatan akan meningkatkan film dengan judul Natal dengan nilai 0.1 dan kontrol lainnya akan menyembunyikan film horor dengan nilai-0.2.

Setelah membuat satu atau beberapa kontrol boost/bury, Anda dapat menambahkan kontrol tersebut ke konfigurasi penayangan. Saat aplikasi Vertex AI Search dibuat, konfigurasi penayangan default juga akan otomatis dibuat. Konfigurasi penayangan direferensikan pada waktu penayangan untuk menentukan hasil yang dihasilkan aplikasi. Selain kontrol boost/bury, konfigurasi penayangan dapat berisi jenis kontrol lainnya, seperti kontrol diversify dan demote.

Konfigurasi penayangan dapat diterapkan saat Anda memanggil metode rekomendasi. Semua kontrol dalam konfigurasi penayangan kemudian diterapkan ke rekomendasi yang ditampilkan oleh panggilan metode.

Selain itu, Anda dapat memiliki beberapa konfigurasi penayangan yang terkait dengan aplikasi. Hal ini memungkinkan Anda menerapkan kumpulan kontrol yang berbeda dalam berbagai situasi. Misalnya, jika permintaan rekomendasi berasal dari akun anak, tingkatkan video dalam kategori yang sesuai untuk anak-anak dan sembunyikan video yang tidak sesuai. Demikian pula, jika permintaan berasal dari akun yang ditandai sebagai dewasa, tingkatkan judul atau kategori yang populer di kalangan orang dewasa. Atau, Anda dapat memilih untuk memiliki konfigurasi penayangan yang berbeda untuk lokasi geografis yang berbeda dan meningkatkan/menyembunyikan konten sesuai dengan konten yang populer secara regional. Untuk mengetahui informasi selengkapnya tentang konfigurasi penayangan, lihat Membuat dan mengelola konfigurasi penayangan media.

Nilai pengoptimalan bersifat menambahkan

Jika Anda telah mengaitkan beberapa kontrol penayangan ke konfigurasi penayangan, peningkatan dan penyamaran akan menjadi tambahan.

Misalnya, jika Anda meningkatkan film animasi anak-anak sebesar 0,3 dan film animasi petualangan sebesar 0,4, maka film yang dikategorikan sebagai animasi petualangan anak-anak akan ditingkatkan sebesar 0,7.

Demikian pula, jika film horor didorong sebesar 0,2 oleh satu kontrol dan dikubur sebesar -0,3 oleh kontrol lain dalam konfigurasi penayangan yang sama, hasil bersihnya adalah mengubur film sebesar -0,1.

Jumlah peningkatan dapat melebihi +1. Misalnya, jika kontrol meningkatkan film animasi anak-anak sebesar 0,6 dan film animasi petualangan sebesar 0,5, maka film animasi petualangan anak-anak akan ditingkatkan sebesar +1,1.

Contoh filter

Berikut adalah beberapa contoh filter yang dapat Anda gunakan untuk meningkatkan atau menyembunyikan rekomendasi media:

• Dorong film dengan judul Natal.

  filter: "title: ANY(\"Christmas\")"

• Meningkatkan kualitas film animasi untuk anak-anak:

  filter: "categories: ANY(\"animation\") AND categories: ANY(\"children\")"

• Mengubur film seram:

  filter: "categories: ANY(\"horror\", \"thriller\", \"crime\")

Nama ini harus sama persis. Misalnya, film dengan "Natal" dalam judulnya tidak akan dioptimalkan.

Batasan pada kolom yang dapat difilter

Batasan berikut berlaku untuk kontrol penayangan tingkatkan/sembunyikan:

• Hanya kolom properti dari jenis string dan boolean yang dapat digunakan dalam ekspresi filter untuk meningkatkan/menutupi.

• Anda tidak dapat memfilter kolom yang bertingkat lebih dari satu tingkat. Misalnya, Anda dapat memfilter pada persons.name, tetapi tidak dapat memfilter pada kolom persons.name.stage (jika kolom tersebut ada).

Sebelum memulai

• Pastikan Anda telah membuat aplikasi rekomendasi media dan penyimpanan data. Untuk informasi selengkapnya, lihat Membuat aplikasi rekomendasi media dan penyimpanan data.

• Opsional: Jika Anda tidak ingin menggunakan konfigurasi penayangan default, buat konfigurasi penayangan baru dengan mengikuti langkah 1-5 dan 7 di Membuat konfigurasi penayangan. Jika aplikasi Anda dalam produksi, Google menyarankan agar Anda membuat konfigurasi penayangan terpisah untuk pengujian peningkatan/penurunan sebelum menerapkan kontrol penayangan ke konfigurasi penayangan produksi.

• Pastikan kolom yang ingin Anda gunakan dalam kontrol boost/bury ditandai sebagai Dapat difilter dalam skema. Untuk informasi selengkapnya, lihat Mengonfigurasi setelan kolom. Lihat juga Batas pemfilteran.

Meningkatkan atau menyembunyikan rekomendasi

Prosedur ini menjelaskan cara membuat kontrol penayangan boost/bury dan mengaitkan kontrol tersebut dengan konfigurasi penayangan.

Setelah kontrol ditambahkan ke konfigurasi penayangan, Anda dapat menentukan konfigurasi penayangan saat memanggil metode servingConfigs.recommend dan kontrol boost/bury akan digunakan untuk memengaruhi urutan rekomendasi yang ditampilkan.

REST

Untuk membuat kontrol penayangan boost/bury dan menambahkannya ke konfigurasi penayangan, ikuti langkah-langkah berikut:

1. Temukan ID aplikasi Anda. Jika Anda sudah memiliki ID aplikasi, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud, buka halaman Agent Builder.

      Buka Aplikasi

   2. Di halaman Aplikasi, temukan nama aplikasi Anda dan dapatkan ID aplikasi dari kolom ID.

2. Temukan ID penyimpanan data Anda. Jika Anda sudah memiliki ID penyimpanan data, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud, buka halaman Agent Builder dan di menu navigasi, klik Data Stores.

      Buka halaman Data Store

   2. Klik nama penyimpanan data Anda.

   3. Di halaman Data untuk penyimpanan data Anda, dapatkan ID penyimpanan data.

3. Buat kontrol peningkatan:

   curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/controls?controlId=CONTROL_ID" \
   -d '{
         "displayName": "CONTROL_DISPLAY_NAME",
             "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
             "boostAction": {
                  "dataStore": "projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID",
                  "boost" :  BOOST_VALUE,
                  "filter": "FILTER"
             }
       }'
   

   • PROJECT_ID: ID project Google Cloud Anda.

   • CONTROL_DISPLAY_NAME: nama yang dapat dibaca manusia untuk mengidentifikasi kontrol. Harus berupa string UTF-8 dengan panjang maksimum 128 karakter.

   • CONTROL_ID: ID unik (dalam penyimpanan data) untuk kontrol. ID dapat berisi huruf kecil, angka, tanda hubung, dan garis bawah.

   • APP_ID: ID aplikasi Vertex AI Search.

   • DATA_STORE_ID: ID penyimpanan data Vertex AI Search.

   • BOOST_VALUE: bilangan floating point antara -1 dan 1. Jika nilainya negatif, rekomendasi akan diturunkan (muncul di bagian bawah hasil). Jika nilainya positif, rekomendasi akan dipromosikan (muncul lebih tinggi di hasil).

   • FILTER: ekspresi filter yang menjelaskan dokumen yang akan dioptimalkan atau disembunyikan. Untuk informasi mendetail tentang cara merumuskan ekspresi filter, lihat Ekspresi filter.

   Contoh perintah

   curl -X POST \
    -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
    -H "Content-Type: application/json; charset=utf-8" \
    -H "X-Goog-User-Project: my-project-123" \
    "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/engines/my-app/controls?controlId=boost-kids" \
    -d '{
         "displayName": "Boost children's category by 0.6",
         "solutionType": "SOLUTION_TYPE_RECOMMENDATION",
         "boostAction": {
              "dataStore": "projects/123456/locations/global/dataStores/my-data-store",
              "boost" :  0.3,
              "filter": "categories: ANY(\"Children\")"
         }
   }'
   
   

   Peningkatan perintah ini mendokumentasikan konten yang dikategorikan untuk anak-anak.

4. Ulangi langkah 3 untuk setiap kontrol dorong/sembunyikan yang ingin Anda terapkan ke rekomendasi. Misalnya, Anda mungkin menginginkan satu kontrol peningkatan yang meningkatkan film untuk anak-anak, boost-kids, dan kontrol kedua yang menyembunyikan film horor, bury-horror.

5. Temukan ID konfigurasi penayangan. Jika Anda sudah memiliki ID konfigurasi penayangan, lanjutkan ke langkah berikutnya.

   1. Di konsol Google Cloud, buka halaman Agent Builder.

      Buka Aplikasi

   2. Di halaman Aplikasi, klik nama aplikasi Anda.

   3. Buka halaman Konfigurasi, lalu klik tab Penayangan.

   4. Dapatkan ID konfigurasi penayangan dari kolom ID.

6. Tambahkan kontrol penayangan boost baru ke konfigurasi penayangan dengan permintaan update:

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/global/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/CONFIG_ID?update_mask=boost_control_ids"}}" \
   -d '{
     "boostControlIds": ["CONTROL_ID"]
   }'
   

   • CONFIG_ID: ID konfigurasi penayangan yang ingin Anda tambahkan kontrol dorong/sembunyikan. Lihat langkah sebelumnya.
   Penting: Jika sudah ada kontrol boost/bury yang terkait dengan konfigurasi penayangan ini, kontrol tersebut akan dihapus oleh perintah patch ini.

   Contoh perintah

   curl -X PATCH -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   -H "X-Goog-User-Project: my-project-123" \
   "https://discoveryengine.googleapis.com/v1alpha/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/servingConfigs/my_app-1234567_id?update_mask=boost_control_ids" \
   -d '{
    "boostControlIds": ["boost-kids", "bury-horror"]
   }'
   
   

   Perintah ini menambahkan dua kontrol peningkatan ke konfigurasi penayangan default aplikasi my-app.

7. Tunggu 5 menit hingga hasilnya diterapkan.

8. Lihat pratinjau efek kontrol dorong/sembunyikan. Lihat Mendapatkan rekomendasi media.