Retail diganti namanya menjadi Vertex AI Search untuk retail. Kami sedang dalam proses memperbarui konten untuk mencerminkan branding baru ini.

Halaman ini diterjemahkan oleh Cloud Translation API.

Mengelola kontrol inferensi

Halaman ini menjelaskan cara melihat, mengedit, menghapus, mengekspor, dan mengimpor kontrol penayangan.

Untuk informasi umum tentang kontrol penayangan dan petunjuk tentang cara membuat kontrol penayangan, lihat Tentang kontrol penayangan dan Membuat kontrol penayangan.

Melihat dan mengedit kontrol penayangan

Anda dapat melihat kontrol penayangan untuk Vertex AI Search untuk retail menggunakan konsol dan API.

Melihat dan mengedit kontrol penayangan di konsol

Tab Kontrol Penayangan di halaman Kontrol mencantumkan semua kontrol penayangan dan konfigurasi penayangan terkait. Klik ikon Edit control untuk kontrol guna mengubah setelannya dan konfigurasi penayangan terkait di panel Edit control. Klik ikon Hapus kontrol untuk menghapus kontrol, yang juga akan menghapusnya dari semua konfigurasi penayangan.

Anda juga dapat melihat dan mengedit kontrol untuk konfigurasi penayangan tertentu di halaman Konfigurasi Penayangan. Klik konfigurasi penayangan untuk melihat halaman Details, yang mencantumkan semua kontrol penayangan untuk konfigurasi tersebut. Klik ikon Edit control untuk kontrol guna mengubah setelannya di panel Edit control. Klik ikon Hapus kontrol untuk memisahkan kontrol dari konfigurasi penayangan (tindakan ini tidak menghapus kontrol).

Perlu waktu beberapa menit hingga kontrol yang baru dibuat atau diperbarui siap untuk menayangkan traffic live. Anda dapat menguji apakah perubahan telah diterapkan di halaman Evaluasi konsol.

Melihat kontrol inferensi secara inline

Untuk melihat satu kontrol penayangan secara inline, gunakan Control.get.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API Control.get.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Untuk mencantumkan beberapa kontrol penayangan secara inline, gunakan Controls.list.

Secara opsional, Anda dapat menggunakan parameter pageSize untuk menetapkan jumlah maksimum hasil yang akan ditampilkan. Jika ada lebih banyak hasil yang tersedia, respons list akan menyertakan token halaman. Anda dapat meneruskan token halaman di parameter pageToken dari permintaan list untuk mengambil halaman hasil berikutnya.

Untuk mencantumkan kontrol yang terkait dengan konfigurasi penayangan tertentu saja, gunakan parameter kueri filter untuk menentukan ID konfigurasi penayangan.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API Control.list.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Melakukan patch pada kontrol penayangan secara inline

Untuk memperbarui kolom dalam kontrol penayangan, gunakan Controls.patch dan sertakan instance Control dalam isi permintaan. Tentukan kolom yang akan diperbarui dengan parameter updateMask, atau biarkan tidak ditetapkan untuk memperbarui semua kolom yang didukung.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API Controls.patch.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Menambahkan kontrol ke konfigurasi penayangan secara inline

Untuk menambahkan kontrol ke konfigurasi penayangan, gunakan ServingConfig.addControl.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.addControl.

Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Menghapus kontrol dari konfigurasi penayangan secara inline

Untuk menghapus kontrol dari konfigurasi penayangan, gunakan ServingConfig.removeControl.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API ServingConfig.addControl.

Untuk contoh metode ini, lihat Mengelola konfigurasi penayangan.

Menghapus kontrol penayangan

Anda dapat menghapus kontrol penayangan dari konsol atau inline menggunakan metode Controls.delete.

Menghapus kontrol penayangan di konsol

Menghapus kontrol penayangan untuk menghapus kontrol tersebut dari semua konfigurasi penayangan yang menggunakannya.

Buka halaman Kontrol di konsol Penelusuran untuk Retail.

Buka halaman Kontrol
Di baris tabel kontrol yang ingin Anda hapus, klik Hapus.
Di jendela konfirmasi, klik Delete untuk menyelesaikan penghapusan.

Menghapus kontrol penayangan secara inline

Untuk menghapus kontrol penayangan secara inline, gunakan Controls.delete.

Untuk mengetahui informasi selengkapnya tentang metode ini, lihat referensi API Controls.delete.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Mengekspor kontrol inferensi

Anda dapat mengekspor kontrol penayangan ke file di bucket Cloud Storage.

Ada dua alasan Anda mungkin ingin mengekspor dan mengimpor kontrol penayangan:

Untuk memindahkan kontrol penayangan dari satu project ke project lain.
Untuk melakukan pengeditan massal pada semua atau beberapa kontrol penayangan. Ekspor kontrol penayangan, edit file yang diekspor, lalu impor file untuk mengubah atau menambahkan kontrol penayangan.

Anda dapat mengekspor dan mengimpor melalui konsol Penelusuran untuk Retail. Saat mengekspor kontrol penayangan, Anda mengekspor semua kontrol penayangan dalam project.

Untuk mengekspor kontrol penayangan, lakukan hal berikut:

Buka halaman Kontrol di konsol Penelusuran untuk Retail.

Buka halaman Kontrol
Di tab Kontrol penayangan, klik Ekspor kontrol.
Di jendela Export Serving Controls, pilih bucket Cloud Storage tempat Anda ingin mengekspor file kontrol.
Klik Ekspor.

Kontrol yang diekspor disimpan ke file NDJSON di bucket yang dipilih dengan nama dalam format berikut:
```
projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson
```
Setelah operasi ekspor selesai, Anda dapat melihat status operasi di daftar Aktivitas impor, ekspor, hapus massal di jendela Aktivitas ekspor. Buka jendela Ekspor aktivitas dengan mengklik Tampilkan di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.

Mengimpor kontrol inferensi

Untuk menambahkan kontrol penayangan atau mengubah kontrol yang ada secara massal, Anda dapat membuat perubahan dalam file kontrol yang diekspor. Kemudian, Anda dapat mengimpornya ke project asli atau ke project yang berbeda.

Hal-hal yang perlu diketahui tentang mengimpor kontrol penayangan:

Anda tidak dapat mengimpor file kontrol penayangan jika file tersebut berisi kontrol penayangan penelusuran dan rekomendasi.
Saat Anda mengimpor kontrol penayangan, semua kontrol penayangan dalam file akan dikaitkan dengan konfigurasi penayangan yang Anda tentukan saat impor. Jika kontrol penayangan sudah dikaitkan dengan konfigurasi penayangan lain dalam project, pengaitan tersebut juga akan dipertahankan.

Untuk mengimpor kontrol penayangan, lakukan hal berikut:

Edit dan tinjau file kontrol penayangan yang diekspor, lalu tempatkan file tersebut di bucket Cloud Storage. (Untuk mengekspor kontrol penayangan, lihat tugas sebelumnya Mengekspor kontrol penayangan.)

Pastikan file hanya berisi kontrol penayangan penelusuran atau hanya kontrol penayangan rekomendasi. Anda tidak dapat mengimpor file yang berisi kedua jenis tersebut.
Buka halaman Kontrol di konsol Penelusuran untuk Retail.

Buka halaman Kontrol
Di tab Kontrol penayangan, klik Impor kontrol.
Di jendela Import Serving Controls:
1. Jelajahi dan pilih bucket Cloud Storage dan file NDJSON yang berisi kontrol yang ingin Anda impor.
2. Pilih konfigurasi penayangan yang ingin Anda kaitkan dengan kontrol penayangan yang diimpor.
3. Tinjau rencana Pratinjau Impor. Kontrol yang akan dibuat ditampilkan di tab New dan kontrol yang akan diubah ditampilkan di tab Modified.
Klik Import.

Operasi yang berjalan lama dimulai untuk mengimpor kontrol baru dan yang diubah.
Setelah operasi impor selesai, Anda dapat melihat status operasi di tab Kontrol pada jendela Status aktivitas. Buka jendela Status aktivitas dengan mengklik Tampilkan di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.