Membuat konfigurasi inferensi

Halaman ini menjelaskan cara membuat konfigurasi penayangan. Konfigurasi penayangan adalah entitas penayangan yang mengaitkan model atau sekumpulan kontrol yang digunakan untuk menghasilkan hasil penelusuran atau rekomendasi Anda. Untuk mengetahui informasi selengkapnya tentang konfigurasi inferensi, lihat Tentang konfigurasi inferensi.

Sebelum memulai

Konfigurasi penayangan rekomendasi dan penelusuran memiliki persyaratan dan opsi yang berbeda:

  • Konfigurasi penayangan rekomendasi memerlukan model. Jika Anda berencana melampirkan model yang ada ke konfigurasi penayangan baru, dapatkan ID model yang akan Anda gunakan (wajib saat menggunakan metode ServingConfig.create).

    Jika membuat konfigurasi penayangan menggunakan konsol, Anda dapat membuat model baru selama proses pembuatan, bukan melampirkan model yang ada.

    Anda dapat mengganti model nanti, asalkan jenis modelnya sama.

  • Penelusuran dapat menggunakan kontrol penayangan, tetapi tidak wajib. Jika Anda berencana melampirkan kontrol yang ada ke konfigurasi penayangan baru, dapatkan ID kontrol yang akan Anda gunakan.

    Jika membuat konfigurasi penayangan menggunakan konsol, Anda juga dapat membuat kontrol baru selama proses pembuatan.

    Anda dapat beralih atau menambahkan kontrol penayangan ke konfigurasi penayangan setelah Anda membuatnya.

Membuat konfigurasi inferensi

Anda dapat membuat konfigurasi penayangan menggunakan:

Maksimal 100 konfigurasi penayangan diizinkan per katalog.

Penelusuran berfungsi dengan konfigurasi inferensi yang tidak dikonfigurasi. serving_config_id dapat ditempatkan sebagai bagian dari permintaan penelusuran, dan default_search ini akan menelusuri katalog dengan kemampuan penelusuran default Vertex AI Search untuk commerce.

Jika Anda memiliki penempatan yang sudah ada, atau membuat penempatan baru, konfigurasi penayangan yang terkait dengan setiap penempatan akan dibuat secara otomatis. Membuat konfigurasi penayangan tidak akan membuat penempatan yang sesuai. Menghapus konfigurasi penayangan akan menghapus penempatannya yang sesuai, dan menghapus penempatan akan menghapus konfigurasi penayangan yang sesuai.

Membuat konfigurasi inferensi di konsol

Tambahkan konfigurasi penayangan baru di halaman Konfigurasi Penayangan di konsol Penelusuran untuk e-commerce.

Untuk membuat konfigurasi inferensi baru:

  1. Buka halaman Serving Configs di konsol Penelusuran untuk e-commerce.

    Buka halaman Konfigurasi penayangan

  2. Klik Create serving config.

    Rekomendasi

    1. Pilih Rekomendasi sebagai produk yang akan menggunakan konfigurasi penayangan.

    2. Berikan nama untuk konfigurasi penayangan Anda.

      Nama harus terdiri dari 1024 karakter atau kurang, dan hanya boleh berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi.

    3. Opsional: Jika perlu, perbarui ID.

      ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project Anda. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.

    4. Pilih atau buat model yang Anda inginkan untuk konfigurasi penayangan ini guna memberikan rekomendasi.

      Pelajari lebih lanjut cara membuat model baru.

    5. Pilih seberapa besar peringkat ulang harga akan memengaruhi hasil rekomendasi, jika tersedia untuk model yang Anda pilih.

      Pengurutan ulang harga akan membuat produk yang direkomendasikan dengan probabilitas rekomendasi serupa diurutkan menurut harga, dengan item berharga paling tinggi di urutan pertama. Relevansi juga masih digunakan untuk mengurutkan item, sehingga mengaktifkan pengurutan ulang harga tidak sama dengan mengurutkan menurut harga.

    6. Pilih apakah akan menggunakan diversifikasi hasil berbasis aturan atau berbasis data:

      • Berbasis aturan: Diversifikasi hasil berbasis aturan memengaruhi apakah hasil yang ditampilkan dari satu permintaan prediksi berasal dari kategori yang berbeda pada katalog produk Anda.

      • Didorong data: Diversifikasi hasil berbasis data menggunakan machine learning untuk menyeimbangkan keragaman dan relevansi kategori dalam hasil prediksi Anda.

      Untuk mengetahui informasi selengkapnya, lihat Diversifikasi hasil.

    7. Pilih seberapa banyak hasil rekomendasi akan didiversifikasi.

    8. Jika Anda memilih model Item Serupa untuk konfigurasi penayangan ini, pilih apakah akan mengaktifkan pencocokan kategori.

      Jika pencocokan kategori diaktifkan, satu-satunya hasil produk yang ditampilkan adalah produk yang memiliki setidaknya satu kategori yang sama dengan produk konteks. Pencocokan kategori dapat digunakan bersama dengan opsi pemfilteran lain, seperti harga, ketersediaan, dan tag filter.

    1. Di halaman Create Serving Config, pilih Search sebagai produk yang akan menggunakan konfigurasi penayangan.
    2. Berikan nama untuk konfigurasi penayangan Anda.

      Nama harus terdiri dari 1024 karakter atau kurang, dan hanya dapat berisi karakter alfanumerik, garis bawah, tanda hubung, dan spasi.
    3. Opsional: Jika perlu, perbarui ID.

      ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project Anda. Panjangnya harus 50 karakter atau kurang, dan tidak boleh berisi spasi.
    4. Klik Lanjutkan.
    5. Pilih apakah akan mengaktifkan penyesuaian dinamis untuk konfigurasi penayangan ini.
    6. Pilih atau buat kontrol inferensi untuk mengoptimalkan penelusuran Anda.

      Untuk mengetahui informasi selengkapnya tentang kontrol, lihat Membuat dan mengelola kontrol.

  3. Klik Buat untuk membuat konfigurasi baru.

    Konfigurasi baru akan muncul di halaman Konfigurasi Penayangan.

    Mungkin perlu waktu beberapa menit hingga konfigurasi tersedia untuk digunakan dalam permintaan penelusuran. Fitur ini langsung tersedia untuk rekomendasi.

  4. Opsional: Di halaman Konfigurasi Penayangan, klik nama konfigurasi penayangan dan buka tab Evaluasi untuk melihat pratinjau produk yang akan ditampilkan untuk konfigurasi ini.

    Pratinjau evaluasi dapat membantu Anda mengonfirmasi bahwa konfigurasi Anda berfungsi seperti yang Anda harapkan.

Buat konfigurasi inferensi dengan ServingConfig.create

Anda dapat membuat konfigurasi penayangan dengan metode ServingConfig.create API. Untuk dokumentasi referensi API untuk metode ini, lihat ServingConfig.create.

Kolom yang Anda gunakan bergantung pada apakah Anda membuat konfigurasi penayangan untuk rekomendasi atau penelusuran.

Untuk mengetahui detail selengkapnya tentang kolom ServingConfig, lihat referensi API ServingConfigs.

Rekomendasi

Buat permintaan ServingConfig.create dengan ID konfigurasi penayangan dan instance ServingConfig yang ada dalam isi permintaan.

  • servingConfigId: Wajib diisi. Membuat ID untuk ServingConfig Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah /[a-z][0-9]-_/.
  • displayName: Wajib diisi. Nama ServingConfig yang dapat dibaca manusia ditampilkan di konsol Search for Commerce.
  • modelID: Wajib diisi. ID model yang akan digunakan pada waktu penyaluran.
  • priceRerankingLevel: Opsional. Menetapkan seberapa besar perubahan peringkat harga akan memengaruhi hasil rekomendasi. Nilai yang diizinkan adalah no-price-reranking (nilai default jika tidak ditetapkan), low-price-raranking, medium-price-reranking, dan high-price-reranking.
  • diversityLevel: Opsional. Menetapkan seberapa banyak hasil rekomendasi yang akan didiversifikasi. Nilai yang diizinkan adalah no-diversity (default), low-diversity, medium-diversity, high-diversity, dan auto-diversity. Jika diversityLevel tidak disetel, keragaman akan dinonaktifkan.
  • diversityType: Opsional. Setel ke RULE_BASED_DIVERSITY untuk mendiversifikasi hasil rekomendasi berdasarkan kategori produk. Disetel ke DATA_DRIVEN_DIVERSITY untuk mendiversifikasi rekomendasi berdasarkan pembelajaran dari metadata produk untuk menyeimbangkan relevansi dan keragaman kategori. Jika diversityLevel ditetapkan, tetapi diversityType tidak ditetapkan, maka diversityType akan ditetapkan secara default ke berbasis aturan. Untuk mengetahui informasi selengkapnya, lihat diversifikasi hasil.
  • enableCategoryFilterLevel: Opsional. Menetapkan apakah akan menambahkan filter kategori tambahan pada model Item Serupa. Nilai yang diizinkan adalah relaxed-category-match (nilai default jika tidak disetel) dan no-category-match.
  • solutionTypes: Wajib diisi. Setel ke SOLUTION_TYPE_RECOMMENDATION untuk konfigurasi inferensi rekomendasi.
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": "DISPLAY_NAME",
              "modelId": "MODEL_ID",
              "priceRerankingLevel": "PRICE_RERANKING_LEVEL",
              "diversityType": "DIVERSITY_TYPE",
              "diversityLevel": "DIVERSITY_LEVEL",
              "enableCategoryFilterLevel": "CATEGORY_FILTER_LEVEL",
              "solutionTypes": [ "SOLUTION_TYPE_RECOMMENDATION" ]
            }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Telusuri

Buat permintaan ServingConfig.create dengan ID konfigurasi penayangan dan instance ServingConfig yang ada dalam isi permintaan.

  • servingConfigId: Wajib diisi. Membuat ID untuk ServingConfig Anda. Nilai ini harus terdiri dari 4-63 karakter. Karakter yang valid adalah /[a-z][0-9]-_/.
  • displayName: Wajib diisi. Nama ServingConfig yang dapat dibaca manusia ditampilkan di konsol Search for Commerce.
  • facetControlIds: Opsional. ID kontrol yang hanya memiliki FacetSpec yang ditetapkan.
  • dynamicFacetSpec.mode: Opsional. Mode fitur DynamicFacet. Nilai yang diizinkan adalah DISABLED (default jika tidak disetel) dan ENABLED.
  • boostControlIds: Opsional. ID kontrol inferensi peningkat.
  • filterControlIds: Opsional. ID kontrol penayangan filter.
  • redirectControlIds: Opsional. ID kontrol penayangan pengalihan.
  • twowaySynonymsControlIds: Opsional. ID kontrol penayangan sinonim dua arah.
  • onewaySynonymsControlIds: Opsional. ID penayangan sinonim satu arah kontrol.
  • doNotAssociateControlIds: Opsional. ID kontrol penayangan yang tidak boleh dikaitkan.
  • replacementControlIds: Opsional. ID kontrol penayangan pengganti.
  • ignoreControlIds: Opsional. ID kontrol penayangan yang diabaikan.
  • solutionTypes: Wajib diisi. Setel ke SOLUTION_TYPE_SEARCH untuk konfigurasi penayangan penelusuran.
curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     --data '{
              "displayName": DISPLAY_NAME,
              "facetControlIds": [
                "FACET_CONTROL_ID_1",
                "FACET_CONTROL_ID_2"
              ],
              "dynamicFacetSpec": {
                "mode": "DYNAMIC_FACET_MODE"
              },
              "boostControlIds": [
                "BOOST_CONTROL_ID_1",
                "BOOST_CONTROL_ID_2"
              ],
              "filterControlIds": [
                "FILTER_CONTROL_ID_1",
                "FILTER_CONTROL_ID_2"
              ],
              "redirectControlIds": [
                "REDIRECT_CONTROL_ID_1",
                "REDIRECT_CONTROL_ID_2"
              ],
              "twowaySynonymsControlIds": [
                "TWO_WAY_SYNONYM_CONTROL_ID_1",
                "TWO_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "onewaySynonymsControlIds": [
                "ONE_WAY_SYNONYM_CONTROL_ID_1",
                "ONE_WAY_SYNONYM_CONTROL_ID_2"
              ],
              "doNotAssociateControlIds": [
                "DO_NOT_ASSOCIATE_CONTROL_ID_1",
                "DO_NOT_ASSOCIATE_CONTROL_ID_2"
              ],
              "replacementControlIds": [
                "REPLACEMENT_CONTROL_ID_1",
                "REPLACEMENT_CONTROL_ID_2"
              ],
              "ignoreControlIds": [
                "IGNORE_CONTROL_ID_1",
                "IGNORE_CONTROL_ID_2"
              ],
              "solutionTypes": [ "SOLUTION_TYPE_SEARCH" ]
    }' \
    "https://retail.googleapis.com/v2/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/servingConfigs?servingConfigId=SERVING_CONFIG_ID"

Langkah berikutnya