Mengelola model

Halaman ini menjelaskan cara menyesuaikan, menjeda, melanjutkan, menghapus, dan mencantumkan model rekomendasi. Untuk mendapatkan bantuan dalam membuat model rekomendasi baru, lihat Membuat model rekomendasi.

Menyesuaikan model

Vertex AI Search untuk retail menggunakan data input yang Anda berikan ke model Anda guna menyesuaikan hyperparameter untuk pelatihan.

Penyesuaian memerlukan waktu 2-4 hari, dan selama model tersebut terus berfungsi seperti biasa. Untuk mengetahui detail biaya penyesuaian, lihat Harga.

Menetapkan frekuensi penyesuaian model

Sebaiknya sesuaikan model secara berkala. Hal ini membuat pelatihan model tetap optimal karena perubahan data dan perilaku pelanggan berbeda sepanjang tahun. Selain itu, beberapa upgrade model utama internal hanya dapat diterapkan setelah model tersebut disesuaikan.

Saat membuat model, Anda dapat menyetelnya agar otomatis melakukan penyesuaian setiap tiga bulan, atau memilih untuk hanya men-tuningnya secara manual. Terlepas dari setelan yang Anda pilih, model akan otomatis disesuaikan satu kali setelah dibuat.

Anda dapat mengubah setelan status penyesuaian kapan saja. Mengubah setelan ini tidak akan memengaruhi proses penyesuaian yang sedang berjalan.

Untuk mengedit setelan status penyesuaian model:

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

    Anda dapat melihat status penyesuaian setiap model di bagian Status penyesuaian.

  2. Klik nama model untuk melihat halaman detailnya.

  3. Klik Edit di samping Tuning status.

  4. Dari menu drop-down, pilih salah satu setelan:

    • Setiap tiga bulan. Otomatis melakukan penyesuaian saat nada terakhir 90 hari yang lalu.
    • Khusus penyesuaian manual. Hanya disesuaikan jika Anda melakukan penyesuaian secara manual.
  5. Klik Selesai untuk menyimpan setelan Anda.

curl

Buat permintaan Models.patch menggunakan API. Lihat referensi API Models.patch.

Untuk mengetahui detail tentang semua kolom Models, lihat referensi API Models.

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/models/MODEL_ID",
  "PeriodicTuningState": "NEW_TUNING_STATE_VALUE"
}' \
'https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID?updateMask=PeriodicTuningState'

Men-tuning model secara manual

Penyesuaian manual memicu penyesuaian satu kali untuk model Anda. Anda dapat menyesuaikan model secara manual jika ada perubahan signifikan dalam katalog (seperti peningkatan ukuran atau perubahan dalam hierarki katalog) atau peristiwa (seperti mengisi ulang peristiwa historis atau perubahan distribusi data setelah mempromosikan kelompok item tertentu).

Untuk men-tuning model secara manual:

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

  2. Klik nama model untuk melihat halaman detailnya.

  3. Klik Penyesuaian Manual di panel tombol.

    Penyesuaian memerlukan waktu 2-4 hari, dan selama model tersebut terus berfungsi seperti biasa.

curl

Buat permintaan Models.tune menggunakan API. Lihat referensi API Models.tune.

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

Menjeda dan melanjutkan pelatihan untuk model

Jika model Anda aktif (tidak dijeda), model dilatih ulang minimal sekali seminggu, tetapi tidak lebih dari sekali sehari. Agar pelatihan ulang konsisten, pastikan Anda mengupload data peristiwa pengguna tidak lebih dari 24 jam setelah peristiwa terjadi.

Anda dapat menjeda model untuk menghentikan pelatihan ulang. Anda mungkin ingin melakukannya jika telah mengimpor data buruk atau agar tidak melebihi batas 10 model aktif per project. Jika memiliki kurang dari 10 model aktif, Anda dapat memulai ulang model yang dijeda kapan saja.

Untuk mengetahui detail biaya pelatihan, lihat Harga.

Anda dapat memulai hingga lima operasi model per menit. Operasi model terbatas meliputi pembuatan, penghapusan, jeda, dan lanjutkan.

Untuk menjeda atau memulai ulang model:

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

    Anda dapat melihat status pelatihan setiap model di bagian Status pelatihan.

  2. Untuk menjeda model aktif (Status pelatihan PELATIHAN), klik Pause .

  3. Untuk memulai model yang dijeda (Status pelatihan DIJEDA), klik Resume .

curl

Untuk menjeda model aktif, buat permintaan Models.pause menggunakan API. Lihat referensi Models.pause API.

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

Untuk memulai model yang dijeda, buat permintaan Models.resume menggunakan API.

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

Lihat detail model

Lihat detail model di konsol atau menggunakan metode API Models.get.

Untuk melihat konfigurasi penayangan yang terkait dengan model tertentu, gunakan prosedur konsol di bawah ini. Semua detail model lainnya tersedia di konsol dan respons API.

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

  2. Halaman Model mencantumkan semua model Anda, beserta pelatihan dan status kuerinya.

  3. Klik nama model untuk melihat halaman Detail-nya.

curl

Untuk mendapatkan informasi model tunggal, buat permintaan Models.get menggunakan API. Lihat referensi Models.get API.

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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'

Mencantumkan model

Lihat daftar model Anda di konsol atau menggunakan metode API Models.list.

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

  2. Halaman Model mencantumkan semua model Anda, beserta pelatihan dan status kuerinya.

curl

Untuk mencantumkan semua model dan detailnya secara inline, buat permintaan Models.list menggunakan API. Lihat referensi Models.list API.

Anda juga dapat menggunakan parameter pageSize untuk menetapkan jumlah hasil maksimum yang akan ditampilkan. Jika lebih banyak hasil tersedia, respons list akan menyertakan token halaman. Anda dapat meneruskan token halaman dalam parameter pageToken dari permintaan list untuk mengambil halaman hasil berikutnya. Contoh di bawah ini menggunakan kedua parameter tersebut.

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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN'

Menghapus model

Anda dapat memulai hingga lima operasi model per menit. Operasi model terbatas meliputi pembuatan, penghapusan, jeda, dan lanjutkan.

Hapus model di konsol atau menggunakan metode API Models.delete.

Konsol

  1. Buka halaman Model di konsol Search for Retail.

    Buka halaman Model

  2. Klik nama model yang ingin Anda hapus untuk membuka halaman detailnya.

  3. Klik Delete di panel tombol.

  4. Masukkan kembali nama model dan klik Konfirmasi.

curl

Buat permintaan Models.delete menggunakan API. Lihat referensi API Models.delete.

Untuk mengetahui detail tentang semua kolom Models, lihat referensi API Models.

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/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/models/MODEL_ID'