Membuat konfigurasi inferensi

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

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 ingin 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 model tersebut memiliki jenis model yang sama.

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

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

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

Membuat konfigurasi penayangan

Anda dapat membuat konfigurasi penayangan menggunakan:

Maksimal 100 konfigurasi penayangan diizinkan per katalog.

Penelusuran berfungsi dengan konfigurasi penayangan yang tidak dikonfigurasi. Setiap serving_config_id dapat ditempatkan sebagai bagian dari permintaan penelusuran, dan default_search ini akan menelusuri katalog dengan kemampuan penelusuran default AI Commerce Search.

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

Membuat konfigurasi penayangan di konsol

Tambahkan konfigurasi penayangan baru di halaman Konfigurasi Penayangan di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.

Untuk membuat konfigurasi penayangan baru:

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

    Buka halaman Konfigurasi penayangan

  2. Klik Buat konfigurasi penayangan.

    Rekomendasi

    1. Pilih Rekomendasi sebagai produk yang akan digunakan untuk konfigurasi penayangan.

    2. Berikan nama untuk konfigurasi penayangan Anda.

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

    3. Opsional: Jika diperlukan, perbarui ID.

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

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

      Pelajari lebih lanjut cara membuat model baru.

    5. Pilih seberapa besar pengurutan 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 berdasarkan harga, dengan item berharga paling tinggi terlebih dahulu. Relevansi juga masih digunakan untuk mengurutkan item, sehingga mengaktifkan pengurutan ulang harga tidak sama dengan mengurutkan berdasarkan 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 dalam katalog produk Anda.

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

      Untuk mengetahui informasi selengkapnya, lihat Diversifikasi hasil.

    7. Pilih seberapa besar diversifikasi hasil rekomendasi.

    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 dengan produk konteks. Pencocokan kategori dapat digunakan bersama dengan opsi pemfilteran lainnya, seperti harga, ketersediaan, dan tag filter.

    1. Di halaman Buat Konfigurasi Penayangan, pilih Penelusuran sebagai produk yang akan digunakan untuk konfigurasi penayangan.
    2. Berikan nama untuk konfigurasi penayangan Anda.

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

      ID dibuat dari nama yang Anda berikan, dan harus unik di seluruh project Anda. ID harus terdiri dari 50 karakter atau kurang, dan tidak boleh berisi spasi.
    4. Klik Lanjutkan.
    5. Pilih apakah akan mengaktifkan aspek dinamis untuk konfigurasi penayangan ini.
    6. Pilih atau buat kontrol penayangan 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. Konfigurasi ini akan langsung tersedia untuk rekomendasi.

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

    Pratinjau evaluasi dapat membantu Anda mengonfirmasi bahwa konfigurasi Anda berperforma seperti yang diharapkan.

Membuat konfigurasi penayangan dengan ServingConfig.create

Anda dapat membuat konfigurasi penayangan dengan metode API ServingConfig.create. 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 terdapat 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 mudah dibaca dan ditampilkan di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.
  • modelID: Wajib diisi. ID model yang akan digunakan pada waktu penayangan.
  • priceRerankingLevel: Opsional. Menetapkan seberapa besar pengurutan ulang 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 besar diversifikasi hasil rekomendasi. Nilai yang diizinkan adalah no-diversity (default), low-diversity, medium-diversity, high-diversity, dan auto-diversity. Jika diversityLevel tidak ditetapkan, diversifikasi akan dinonaktifkan.
  • diversityType: Opsional. Tetapkan ke RULE_BASED_DIVERSITY untuk mendiversifikasi hasil rekomendasi berdasarkan kategori produk. Tetapkan ke DATA_DRIVEN_DIVERSITY untuk mendiversifikasi rekomendasi berdasarkan pembelajaran dari metadata produk guna menyeimbangkan relevansi dan keragaman kategori. Jika diversityLevel ditetapkan, tetapi diversityType tidak ditetapkan, 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 ditetapkan) dan no-category-match.
  • solutionTypes: Wajib diisi. Tetapkan ke SOLUTION_TYPE_RECOMMENDATION untuk konfigurasi penayangan 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"

Penelusuran

Buat permintaan ServingConfig.create dengan ID konfigurasi penayangan dan instance ServingConfig yang terdapat 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 mudah dibaca dan ditampilkan di konsol AI Commerce Search di Gemini Enterprise for Customer Experience.
  • facetControlIds: Opsional. ID kontrol yang hanya memiliki FacetSpec yang ditetapkan.
  • dynamicFacetSpec.mode: Opsional. Mode fitur DynamicFacet. Nilai yang diizinkan adalah DISABLED (default jika tidak ditetapkan) dan ENABLED.
  • boostControlIds: Opsional. ID kontrol penayangan promosi.
  • filterControlIds: Opsional. ID kontrol penayangan filter.
  • redirectControlIds: Opsional. ID kontrol penayangan pengalihan.
  • twowaySynonymsControlIds: Opsional. ID kontrol penayangan sinonim dua arah.
  • onewaySynonymsControlIds: Opsional. ID kontrol penayangan sinonim satu arah.
  • doNotAssociateControlIds: Opsional. ID kontrol penayangan jangan-kaitkan.
  • replacementControlIds: Opsional. ID kontrol penayangan penggantian.
  • ignoreControlIds: Opsional. ID kontrol penayangan abaikan.
  • solutionTypes: Wajib diisi. Tetapkan 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