Mengelola kontrol inferensi

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

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

Melihat dan mengedit kontrol inferensi

Anda dapat melihat kontrol inferensi untuk AI Commerce Search menggunakan konsol dan API.

Melihat dan mengedit kontrol inferensi di konsol

Tab Serving Controls di halaman Controls mencantumkan semua kontrol inferensi Anda dan konfigurasi inferensi terkait. Klik ikon Edit control untuk kontrol guna mengubah setelan dan konfigurasi inferensi terkait di panel Edit control. Klik ikon Delete control untuk kontrol guna menghapusnya, yang juga akan menghapusnya dari semua konfigurasi inferensi.

Anda juga dapat melihat dan mengedit kontrol untuk konfigurasi inferensi tertentu di halaman Serving Configs. Klik konfigurasi inferensi untuk melihat halaman Details yang mencantumkan semua kontrol inferensi untuk konfigurasi tersebut. Klik ikon Edit control untuk kontrol guna mengubah setelannya di panel Edit control. Klik ikon Remove control untuk memisahkan kontrol dari konfigurasi inferensi (tindakan ini tidak akan menghapus kontrol).

Kontrol yang baru dibuat atau diperbarui memerlukan waktu beberapa menit agar siap menayangkan traffic langsung. Anda dapat menguji apakah perubahan telah diterapkan di halaman konsol Evaluate.

Melihat kontrol inferensi secara inline

Untuk melihat satu kontrol inferensi 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 inferensi 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 dalam parameter pageToken dari permintaan list untuk mengambil hasil halaman berikutnya.

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

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

Menggabungkan kontrol inferensi secara inline

Untuk memperbarui kolom dalam kontrol inferensi, gunakan Controls.patch dan sertakan instance Control di 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 Controls.patch referensi API.

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 inferensi secara inline

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

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

Untuk mengetahui contoh metode ini, lihat Mengelola konfigurasi inferensi.

Menghapus kontrol dari konfigurasi inferensi secara inline

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

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

Untuk mengetahui contoh metode ini, lihat Mengelola konfigurasi inferensi.

Menghapus kontrol inferensi

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

Menghapus kontrol inferensi di konsol

Hapus kontrol inferensi untuk menghapus kontrol tersebut dari semua konfigurasi inferensi yang menggunakannya.

  1. Buka halaman Controls di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Controls

  2. Di baris tabel kontrol yang akan dihapus, klik Delete.

  3. Di jendela konfirmasi, klik Delete untuk menyelesaikan penghapusan.

Menghapus kontrol inferensi secara inline

Untuk menghapus kontrol inferensi 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 inferensi ke file di bucket Cloud Storage.

Ada dua alasan mengapa Anda mungkin ingin mengekspor dan mengimpor kontrol inferensi:

  • Untuk memindahkan kontrol inferensi dari satu project ke project lain.

  • Untuk melakukan pengeditan massal pada semua atau beberapa kontrol inferensi. Ekspor kontrol inferensi, edit file yang diekspor, lalu impor file untuk mengubah atau menambahkan kontrol inferensi.

Anda dapat mengekspor dan mengimpor melalui konsol AI Commerce Search di Gemini Enterprise for Customer Experience. Saat mengekspor kontrol inferensi, Anda mengekspor semua kontrol inferensi dalam project.

Untuk mengekspor kontrol inferensi, lakukan hal berikut:

  1. Buka halaman Controls di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Controls

  2. Di tab Serving controls, klik Export controls.

  3. Di jendela Export Serving Controls, pilih bucket Cloud Storage tempat Anda ingin mengekspor file kontrol.

  4. Klik Export.

    Kontrol yang diekspor disimpan ke file NDJSON di bucket yang dipilih dengan nama dalam format berikut:

    projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

  5. Setelah operasi ekspor selesai, Anda dapat melihat status operasi di daftar Bulk import, export, delete activities di jendela Export activity. Buka jendela Export activity dengan mengklik Show di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.

Mengimpor kontrol inferensi

Untuk menambahkan kontrol inferensi 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 lain.

Hal-hal yang perlu diketahui tentang mengimpor kontrol inferensi:

  • Anda tidak dapat mengimpor file kontrol inferensi jika berisi kontrol inferensi penelusuran dan rekomendasi.

  • Saat Anda mengimpor kontrol inferensi, semua kontrol inferensi dalam file akan dikaitkan dengan konfigurasi inferensi yang Anda tentukan saat impor. Jika kontrol inferensi sudah dikaitkan dengan konfigurasi inferensi lain dalam project, kaitan tersebut juga akan dipertahankan.

Untuk mengimpor kontrol inferensi, lakukan hal berikut:

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

    Pastikan file hanya berisi kontrol inferensi penelusuran atau hanya kontrol inferensi rekomendasi. Anda tidak dapat mengimpor file yang berisi kedua jenis tersebut.

  2. Buka halaman Controls di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

    Buka halaman Controls

  3. Di tab Serving controls, klik Import controls.

  4. Di jendela Import Serving Controls:

    1. Telusuri dan pilih bucket Cloud Storage dan file NDJSON yang berisi kontrol yang ingin Anda impor.

    2. Pilih konfigurasi inferensi yang ingin Anda kaitkan dengan kontrol inferensi yang diimpor.

    3. Tinjau rencana Pratinjau Impor. Kontrol yang akan dibuat ditampilkan di tab New dan kontrol yang akan diubah ditampilkan di tab Modified.

  5. Klik Import.

    Operasi yang berjalan lama akan dimulai untuk mengimpor kontrol baru dan yang diubah.

  6. Setelah operasi impor selesai, Anda dapat melihat status operasi di tab Controls pada jendela Activity status. Buka jendela Activity status dengan mengklik Show di jendela pesan atau dengan mengikuti petunjuk di Melihat status untuk operasi integrasi tertentu.