Mengonfigurasi setelan kolom

Halaman ini menunjukkan cara mengonfigurasi kolom skema untuk menyiapkan aplikasi bagi data terstruktur, data tidak terstruktur dengan metadata, atau data situs dengan atribut terstruktur kustom.

Setelan kolom membantu menentukan cara Penelusuran Agen menggunakan kolom dalam hasilnya. Anda dapat menggunakan tab Schema di Google Cloud konsol untuk mengonfigurasi setelan kolom.

Konfigurasi setelan kolom hanya tersedia untuk aplikasi dengan penyimpanan data yang berisi data terstruktur atau data tidak terstruktur dengan metadata.

Setelan kolom

Setelan kolom berikut tersedia untuk banyak jenis kolom dalam data penelusuran atau rekomendasi Anda, tetapi tidak untuk semua jenis data. Skema berisi beberapa setelan kolom untuk setiap kolom, dan tabel berikutnya berisi setelan yang dapat diterapkan ke kolom dalam skema. Penggunaan data terstruktur sangat direkomendasikan untuk setelan kolom berikut:

Setelan	Definisi	Tujuan	Contoh kasus penggunaan
Dapat diindeks	Menetapkan kolom agar dapat diindeks memungkinkan operasi seperti pemfilteran, peningkatan, dan faseting pada kolom terstruktur dalam dokumen. Kolom berjenis Object tidak dapat disetel ke Indexable.	Menandai kolom sebagai Indexable memungkinkan pencarian yang lebih cepat. Perhatikan bahwa menandai kolom sebagai Indexable akan meningkatkan ukuran indeks penelusuran dan dapat memperlambat pengindeksan.	Di penyimpanan data hotel, Anda dapat menetapkan kolom, seperti hotel_chain, sebagai dapat diindeks. Dengan begitu, Anda dapat menerapkan operasi pemberian peringkat, pemfilteran, dan peningkatan pada hotel_chain. Misalnya, Anda dapat menerapkan filter sehingga penelusuran hanya akan menampilkan hasil penelusuran yang berisi jaringan hotel yang difilter.
Dapat ditelusuri	Kolom yang kemungkinan besar terkait dengan penelusuran ditetapkan sebagai Searchable. Kolom dapat ditelusuri tanpa dapat diindeks atau diambil. Hanya kolom dengan nilai teks yang dapat ditandai dapat ditelusuri. Dengan demikian, kolom harga numerik dapat diindeks (untuk pemfilteran atau pengelompokan) tetapi tidak dapat ditelusuri sebagai teks lengkap.	Menyetel kolom ke Dapat Ditelusuri akan meningkatkan kemampuan mengingat kembali untuk kolom tersebut dalam kueri penelusuran, sehingga pengguna dapat menemukan konten, seperti halaman web, dengan membuat kueri teks dalam kolom ini. Menandai kolom sebagai dapat ditelusuri memungkinkan penerapan peringkat. Akibatnya, menandai terlalu banyak kolom sebagai dapat ditelusuri dapat berdampak negatif pada presisi penelusuran dengan membuat algoritma peringkat menjadi terlalu jenuh dan menampilkan terlalu banyak hasil. Hal ini dapat menyebabkan hasil penelusuran yang tidak relevan. Anda dapat menerapkan pembobotan relatif ke kolom yang dapat ditelusuri; namun, karena default yang andal, hal ini jarang diperlukan. Lihat Kolom yang dapat ditelusuri bobot di bawah.	Sistem tiket dukungan penyedia layanan internet menyimpan setiap tiket sebagai dokumen terstruktur. Jika dokumen ini berisi kolom teks yang Dapat ditelusuri, seperti issue_description atau resolution_notes, agen dukungan dapat menjalankan kueri yang terkait dengan konten di kolom tersebut, seperti cara memperbaiki kecepatan internet yang lambat setelah modem direset. Sistem akan menampilkan dokumen yang berisi salah satu istilah penelusuran tersebut, termasuk modem, internet, kecepatan, di salah satu atau kedua kolom issue_description atau resolution_notes.
Facet dinamis	Menyediakan filter yang sadar konteks untuk menargetkan penelusuran pengguna dengan lebih baik. Menetapkan kolom sebagai Dynamic Facetable memungkinkan sistem otomatis membuat filter interaktif (aspek) berdasarkan nilai unik yang ada di kolom.	Menetapkan kolom ke Dynamic facetable memungkinkan pengguna menyempurnakan hasil penelusuran secara dinamis dengan memilih kategori atau atribut yang berasal langsung dari data yang Anda masukkan, tanpa harus menentukan setiap opsi filter yang mungkin secara manual. Hal ini memungkinkan pengguna mempersempit penelusuran mereka ke konten web yang sangat spesifik. Gunakan Facet Dinamis dengan Dapat Ditelusuri untuk mendapatkan hasil yang lebih baik, yang meningkatkan recall penelusuran Anda dan kualitas facet yang ditawarkan kepada pengguna.	Halaman di pusat informasi perusahaan internal, seperti kebijakan HR, akan diproses dengan data seperti department, document_type, atau last_modified_date. Jika kolom ini diberi tag dynamic facetable, penelusuran karyawan untuk istilah seperti penggantian biaya akan menghasilkan filter interaktif secara dinamis berdasarkan hasil yang relevan yang ditemukan. Dalam kasus tersebut, antarmuka web dapat menampilkan aspek untuk Departemen: Keuangan, Perjalanan, Jenis Dokumen: Kebijakan, FAQ, atau Tanggal Terakhir Diubah: Kuartal Ini, Tahun Lalu.
Dapat diambil	Saat kueri penelusuran menemukan konten yang cocok, mesin telusur dapat menarik nilai kolom yang dapat diambil untuk ditampilkan atau digunakan dalam aplikasi, yang berarti informasi dari dokumen asli ditampilkan sebagai bagian dari hasil penelusuran. Kolom kunci (ID unik untuk dokumen) disiapkan agar dapat diambil.	Kolom yang dapat diambil memberikan konteks penelusuran dengan membedakan kolom yang nilainya dapat ditampilkan dari kolom yang hanya digunakan dalam logika penelusuran, tetapi nilai mentahnya tidak dimaksudkan untuk ditampilkan kepada pengguna akhir.	Untuk penelusuran produk di situs penjual, product_id, name, price, dan image_url adalah kolom umum yang ingin Anda tetapkan sebagai dapat diambil. Di sisi lain, internal_tracking_code dapat diindeks dan dapat difilter hanya untuk tujuan administratif, tetapi tidak dapat diambil di hasil penelusuran publik.
Dapat diselesaikan	Mengizinkan konten kolom digunakan untuk saran kueri penelusuran. Untuk informasi selengkapnya, lihat Mengonfigurasi pelengkapan otomatis.	Setelan ini memungkinkan nilai dalam kolom tersebut digunakan untuk memberikan saran kueri real-time saat pengguna mengetik. Fitur ini membantu mengarahkan pengguna ke konten yang relevan dan mempercepat proses penelusuran. Faktor tertentu seperti penggunaan pemfilteran bahasa natural dapat memengaruhi performa ini.	Jika kolom completable disetel untuk product_name, brand, dan category, saat pengguna mengetik Teknologi, saran pelengkapan otomatis dapat menampilkan: TechCo (dari kolom brand) TechCo UltraBook X1 (dari kolom product_name ) Technology GameMaster Pro (produk lain dari kolom category)
Dapat difilter	Memungkinkan rekomendasi menggunakan kolom untuk memfilter hasil yang direkomendasikan, menentukan hasil penelusuran yang dilihat pengguna Anda. Untuk informasi tentang memfilter rekomendasi, lihat Memfilter rekomendasi.	Menetapkan kolom ke Filterable akan membantu menyesuaikan rekomendasi untuk pengguna. Perhatikan bahwa batas pemfilteran berlaku.	Setelan filter menurut bahasa dan drama dapat terlihat seperti: language_code: ANY("en", "fr") OR categories: ANY("drama").

Perbedaan antara setelan yang umum digunakan

Ada perbedaan utama antara setelan kolom yang dapat diindeks, dapat ditelusuri, dan dapat diambil. Tabel ini merangkum perbedaan tersebut.

Fitur	Indexable	Dapat ditelusuri	Dapat diambil
Peran Utama	Membuat konten kolom tersedia untuk mesin telusur	Memungkinkan kueri teks lengkap terhadap konten kolom	Memungkinkan nilai kolom ditampilkan dalam hasil penelusuran
Analisis	Konten diproses dan dimasukkan ke dalam indeks.	Biasanya menjalani analisis leksikal yang ekstensif.	Nilai disimpan apa adanya untuk ditampilkan.
Mungkinkah...
...Dapat ditelusuri?	Ya (sering kali merupakan prasyarat)	T/A	Tidak harus (dapat diambil tanpa dapat ditelusuri)
...Dapat diambil?	Belum tentu	Belum tentu	T/A
...Dapat Difilter/Diurutkan/Dikelompokkan?	Ya (biasanya juga merupakan prasyarat untuk hal ini)	Tidak secara langsung; ini adalah atribut terpisah yang sering kali dibuat di kolom yang dapat diindeks.	Tidak secara langsung; atribut ini berkaitan dengan cara kolom diindeks dan dikueri, bukan hanya ditampilkan.

Dalam praktiknya, banyak kolom yang penting untuk pengalaman pengguna (seperti judul, deskripsi, dan informasi identifikasi) sering disetel menjadi indexable, searchable, dan retrievable.

Catatan: Terminologi dan perilaku yang tepat terkadang dapat sedikit bervariasi di antara teknologi mesin telusur yang berbeda (seperti Elasticsearch, Apache Solr, Azure AI Search, Google Cloud Search), tetapi konsep intinya sebagian besar tetap sama.

Batasan

Setelan kolom memiliki batasan berikut:

• Anda dapat mengonfigurasi hingga 50 kolom sebagai kolom yang dapat diindeks, dapat ditelusuri, dapat diambil, atau dapat difasilitasi secara dinamis.
• Untuk mengonfigurasi kolom sebagai aspek dinamis, kolom tersebut harus dikonfigurasi sebagai dapat diindeks terlebih dahulu.
• Mengubah setelan yang dapat diindeks memerlukan pengindeksan ulang data, yang dapat memakan waktu berjam-jam, terutama untuk penyimpanan data yang besar.

Jika Anda mengonfigurasi kolom untuk aplikasi penelusuran media dan menginginkan informasi mendetail tentang kolom dalam skema, lihat Tentang dokumen media dan penyimpanan data.

Memperbarui setelan kolom

Untuk memperbarui setelan kolom:

1. Di konsol Google Cloud , buka halaman AI Applications.

   AI Applications

2. Klik nama aplikasi yang ingin Anda edit.

3. Klik Data.

4. Klik tab Schema. Tab ini menampilkan setelan kolom saat ini.

   Anda tidak akan melihat tab Skema jika penyimpanan data Anda berisi data situs dasar atau data tidak terstruktur tanpa metadata.

5. Klik Edit.

6. Pilih atau hapus setelan kolom yang perlu Anda perbarui. Beberapa setelan kolom tidak didukung. Misalnya, kolom numerik tidak dapat disetel ke Dapat ditelusuri.

7. Klik Simpan untuk menerapkan perubahan.

Menimbang kolom yang dapat ditelusuri (Pratinjau)

Pratinjau

Fitur ini tunduk pada "Persyaratan Penawaran Pra-GA" di bagian Persyaratan Layanan Umum dari Persyaratan Khusus Layanan. Fitur pra-GA tersedia "sebagaimana adanya" dan mungkin memiliki dukungan terbatas. Untuk mengetahui informasi selengkapnya, lihat deskripsi tahap peluncuran.

Jika menandai kolom dapat ditelusuri, Anda dapat menentukan bobot untuk menunjukkan tingkat kepentingan relatifnya dalam hasil penelusuran. Dalam sebagian besar situasi, Anda tidak perlu menentukan bobot untuk setiap kolom karena bobot default berfungsi dengan baik.

Namun, menyesuaikan bobot mungkin diperlukan dalam beberapa situasi, misalnya:

• Anda memigrasikan data dari platform penelusuran yang sudah menggunakan kolom berbobot.

• Saat bobot default tidak memberikan hasil penelusuran yang memuaskan. Secara khusus, hal ini dapat terjadi saat Anda memiliki banyak kolom yang dapat ditelusuri dan beberapa di antaranya jauh lebih penting daripada yang lain.

  Mungkin, ringkasan adalah kolom yang paling penting untuk penelusuran, jadi Anda ingin memprioritaskan teks tersebut.

  Atau, skema memiliki kolom yang berisi kata kunci yang sangat relevan yang merupakan prediktor yang sangat baik untuk hasil penelusuran, tetapi, karena kolom ini jauh lebih pendek daripada yang lain, pengaruhnya sering kali dibayangi oleh kolom yang lebih panjang. Meningkatkan bobotnya memastikan bahwa input tersebut memiliki dampak yang diinginkan.

Tingkat berat

Bobot dikelompokkan ke dalam tingkat berikut:

Tingkat kepentingan kolom	Penjelasan
Sangat rendah	Nilai rendah yang masih dipertimbangkan sistem saat menggabungkan skor dari semua kolom. Jika Anda menginginkan bobot yang lebih kecil sehingga efeknya dapat diabaikan, jangan tandai kolom dapat ditelusuri.
Rendah	Bobot yang lebih rendah dari default.
Default	Bobot standar untuk kolom yang dapat ditelusuri. Bobot ini memberikan performa yang cukup baik untuk sebagian besar kasus.
Tinggi	Bobot yang jauh lebih tinggi daripada default.
Sangat tinggi	Bobot yang mendominasi. Biasanya, Anda mencadangkan ini untuk paling banyak satu kolom.

Pembaruan skema dan pengindeksan ulang

Menambahkan bobot ke kolom yang dapat ditelusuri memerlukan pembaruan skema dan pengindeksan ulang data berikutnya di penyimpanan data. Memperbarui skema memerlukan waktu berjam-jam, dan tidak ada indikator yang dapat diandalkan untuk memberi tahu Anda kapan pengindeksan selesai, jadi Anda perlu memperkirakan waktu pengindeksan secara berlebihan.

Menetapkan tingkat bobot pada kolom

Tugas menetapkan tingkat bobot untuk kolom bisa jadi membosankan karena Anda hanya boleh membuat sedikit perubahan dan meninjau hasil penelusuran dengan cermat setelahnya untuk memeriksa konsekuensi yang tidak diinginkan. Setelah setiap perubahan, Anda harus menunggu pengindeksan ulang selesai sebelum dapat mengevaluasi dampak perubahan tersebut.

Catatan: Anda tidak dapat menerapkan bobot ke kolom yang merupakan properti utama, seperti title atau description. Agent Search sudah menerapkan pembobotan yang lebih tinggi untuk kolom yang ditandai sebagai properti utama.

Anda hanya dapat mengonfigurasi bobot kolom penelusuran melalui API. Fitur ini tidak tersedia di konsol Google Cloud .

Untuk menetapkan bobot, Anda perlu memperbarui skema untuk penyimpanan data melalui metode API projects.locations.dataStores.schemas.patch.

1. Jika Anda belum memiliki skema, ikuti petunjuk untuk mendapatkan skema di Melihat definisi skema.

2. Ikuti petunjuk untuk mengupdate skema secara terprogram. Tambahkan bobot ke satu atau beberapa kolom yang dapat ditelusuri, seperti dalam contoh berikut:

   "summary": {
      "type": "string",
      "searchable": true,
      "weight": "high"
    },
    "uri": {
      "type": "string",
      "searchable": true,
      "weight": "low"
    },
   

   Dalam contoh ini, kolom summary ditetapkan ke bobot yang lebih tinggi daripada normal dan kolom uri ke bobot yang lebih rendah. Jika Anda ingin mengembalikan bobot ke nilai default, tetapkan ke default.

   Nilai yang diizinkan untuk parameter bobot adalah:

   • very_low
   • low
   • default
   • high
   • very_high

   Contoh perintah dan hasil

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema" \
   -d '{
   "structSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "amenities": { "items": { "completable": true, "dynamicFacetable": true, "indexable": true, "retrievable": true, "searchable": true, "type": "string", "weight": "high" }, "type": "array" }, "available_date": { "indexable": true, "retrievable": true, "type": "datetime" }, "id": { "dynamicFacetable": false, "indexable": true, "retrievable": true, "type": "number" }, "location": { "indexable": true, "retrievable": true, "type": "geolocation" }, "non_smoking": { "dynamicFacetable": true, "indexable": true, "type": "boolean" }, "price_per_night": { "indexable": true, "retrievable": true, "type": "number" }, "rating": { "dynamicFacetable": true, "indexable": true, "retrievable": true, "type": "number" }, "room_types": { "items": { "dynamicFacetable": true, "indexable": true, "retrievable": true, "searchable": true, "type": "string", "weight": "low" }, "type": "array" }, "title": { "keyPropertyMapping": "title", "retrievable": true, "type": "string" } }, "type": "object" }
   }'
   
   {
   "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema/operations/update-schema-123456",
   "metadata": {
   "@type": "type.googleapis.com/google.cloud.discoveryengine.v1beta.UpdateSchemaMetadata"
   }
   }
   

   Dalam contoh ini, kolom amentities diberi bobot yang lebih tinggi daripada bobot normal dan kolom room_types diberi bobot yang lebih rendah.

3. Tunggu hingga pengindeksan ulang selesai dan uji perilaku penelusuran.

Langkah berikutnya

• Memperbarui skema untuk data terstruktur
• Mengonfigurasi hasil penelusuran
• Melihat pratinjau hasil penelusuran