CompletionConfig

Konfigurasi untuk menyesuaikan respons Autocomplete API untuk mesin dan penyimpanan data. Beberapa kolom hanya berlaku untuk salah satunya.

Representasi JSON
{
  "name": string,
  "matchingOrder": string,
  "maxSuggestions": integer,
  "minPrefixLength": integer,
  "queryModel": string,
  "queryFrequencyThreshold": integer,
  "numUniqueUsersThreshold": integer,
  "shouldServeContentSuggestions": boolean,
  "filterPiiSuggestionsUsingDlp": boolean,
  "enableMode": enum (EnableMode)
}
Kolom
name

string

Wajib diisi. Tidak dapat diubah. Nama yang memenuhi syarat sepenuhnya projects/*/locations/*/dataStores/*/completionConfig projects/*/locations/*/collections/*/dataStores/*/completionConfig projects/*/locations/*/collections/*/engines/*/completionConfig

matchingOrder

string

Urutan yang cocok untuk saran pelengkapan otomatis, misalnya, kueri yang terdiri dari sh dengan out-of-order yang ditentukan akan menyarankan women's shoes, sedangkan kueri red s dengan exact-prefix yang ditentukan akan menyarankan red shoes. Nilai yang saat ini didukung:

  • out-of-order
  • exact-prefix

Nilai default: exact-prefix.

maxSuggestions

integer

Jumlah maksimum saran pelengkapan otomatis yang ditampilkan per istilah.

maxSuggestions harus berada dalam rentang [1, 20]. Jika tidak ditetapkan atau ditetapkan ke 0, nilai defaultnya adalah 20 saran.

minPrefixLength

integer

Jumlah minimum karakter yang harus diketik untuk mendapatkan saran.

minPrefixLength harus berada dalam rentang [1, 20]. Jika tidak ditetapkan atau ditetapkan ke 0, nilai defaultnya adalah 1 karakter.

queryModel

string

Model data saran kueri untuk penayangan.

Nilai yang saat ini didukung:

  • automatic - backend pelengkapan otomatis memilih atau menggabungkan saran dari berbagai model secara otomatis.
  • document - Menggunakan saran yang dibuat dari dokumen yang diimpor pengguna.
  • search-history - Menggunakan saran yang dibuat dari histori panggilan API SearchService.Search sebelumnya. Jangan gunakan jika tidak ada traffic untuk Search API.
  • user-event - Menggunakan saran yang dibuat dari peristiwa penelusuran yang diimpor pengguna.
  • document-completable - Menggunakan saran yang diambil langsung dari kolom dokumen yang diimpor pengguna dan ditandai sebagai dapat dilengkapkan.

Jika model kueri kosong, penayangan akan menerapkan model "otomatis" secara default.

queryFrequencyThreshold

integer

Kolom ini hanya bermakna untuk saran yang dibuat dari peristiwa pengguna atau histori penelusuran. Jika kueri muncul kurang dari nilai minimum ini, kueri tersebut mungkin jarang ditelusuri sehingga tidak akan dibuat sebagai saran. Kolom ini dapat membantu mencegah kueri PII menjadi saran, karena kueri tersebut biasanya ditelusuri secara unik. Jika tidak ditetapkan, nilai defaultnya adalah 3 yang digunakan dalam pipeline pembuatan.

numUniqueUsersThreshold

integer

Kolom ini hanya bermakna untuk saran yang dibuat dari peristiwa pengguna atau histori penelusuran, yang mungkin memiliki ID pengguna terlampir. Jika jumlah pengguna unik yang telah menelusuri kueri kurang dari nilai minimum ini, kueri tersebut tidak akan dibuat sebagai saran. Kolom ini dapat membantu mencegah kueri PII menjadi saran, karena kueri tersebut biasanya ditelusuri secara unik. Jika tidak ditetapkan, nilai defaultnya adalah 3 yang digunakan dalam pipeline pembuatan.

shouldServeContentSuggestions

boolean

Apakah akan membuat dan menayangkan saran konten. Hal ini memungkinkan saran konten ditayangkan selain saran kueri.

filterPiiSuggestionsUsingDlp

boolean

Jika benar (true), dengan upaya terbaik, coba deteksi dan hapus saran yang berisi jenis informasi PII tertentu. Deteksi ini dilakukan oleh DLP di balik layar.

enableMode

enum (EnableMode)

Mode pengaktifan pipeline pembuatan pelengkapan otomatis. Jika kolom ini tidak ditetapkan, perilaku server akan ditetapkan secara default ke CompletionConfig.EnableMode.AUTOMATIC. Hanya berlaku untuk DataStore. Diabaikan untuk Engine.

EnableMode

Menentukan mode pengaktifan pipeline pembuatan pelengkapan otomatis.

Enum
ENABLE_MODE_UNSPECIFIED Jika mode pengaktifan AutoComplete tidak ditentukan, mode tersebut akan ditetapkan secara default ke mode AUTOMATIC.
AUTOMATIC AutoComplete akan diaktifkan jika penyimpanan data memenuhi kriteria.
MANUAL AutoComplete akan diaktifkan terlepas dari persyaratan data UCS.