REST Resource: projects.locations.collections.engines.servingConfigs

Resource: ServingConfig

Mengonfigurasi metadata yang digunakan untuk menghasilkan hasil waktu penayangan (misalnya, hasil penelusuran atau prediksi rekomendasi). ServingConfig diteruskan dalam permintaan penelusuran dan prediksi serta menghasilkan hasil.

Representasi JSON 
{
  "name": string,
  "displayName": string,
  "solutionType": enum (SolutionType),
  "modelId": string,
  "diversityLevel": string,
  "embeddingConfig": {
    object (EmbeddingConfig)
  },
  "rankingExpression": string,
  "createTime": string,
  "updateTime": string,
  "filterControlIds": [
    string
  ],
  "boostControlIds": [
    string
  ],
  "redirectControlIds": [
    string
  ],
  "synonymsControlIds": [
    string
  ],
  "onewaySynonymsControlIds": [
    string
  ],
  "dissociateControlIds": [
    string
  ],
  "replacementControlIds": [
    string
  ],
  "ignoreControlIds": [
    string
  ],
  "promoteControlIds": [
    string
  ],
  "personalizationSpec": {
    object (PersonalizationSpec)
  },
  "answerGenerationSpec": {
    object (AnswerGenerationSpec)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "mediaConfig": {
    object (MediaConfig)
  },
  "genericConfig": {
    object (GenericConfig)
  }
  // End of mutually exclusive fields.
}
Kolom
name

string

Tidak dapat diubah. Nama yang sepenuhnya memenuhi syarat projects/{project}/locations/{location}/collections/{collectionId}/engines/{engineId}/servingConfigs/{servingConfigId}
displayName

string

Wajib. Nama tampilan konfigurasi penayangan yang dapat dibaca manusia. Digunakan di UI Discovery.

Kolom ini harus berupa string berenkode UTF-8 dengan batas panjang 128 karakter. Jika tidak, error INVALID_ARGUMENT akan ditampilkan.
solutionType

enum (SolutionType)

Wajib. Tidak dapat diubah. Menentukan jenis solusi yang dapat dikaitkan dengan konfigurasi penayangan.
modelId

string

ID model yang akan digunakan pada waktu penyaluran. Saat ini, hanya RecommendationModel yang didukung. Dapat diubah, tetapi hanya ke model yang kompatibel (misalnya, CTR "mungkin Anda suka" ke CVR "mungkin Anda suka").

Wajib jika SolutionType adalah SOLUTION_TYPE_RECOMMENDATION.
diversityLevel

string

Seberapa banyak keragaman yang akan digunakan dalam hasil model rekomendasi, misalnya medium-diversity atau high-diversity. Nilai yang saat ini didukung:

  • no-diversity
  • low-diversity
  • medium-diversity
  • high-diversity
  • auto-diversity

Jika tidak ditentukan, kami akan memilih default berdasarkan jenis model rekomendasi. Nilai default: no-diversity.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_RECOMMENDATION.
embeddingConfig

object (EmbeddingConfig)

Gunakan konfigurasi penyematan Anda sendiri. Konfigurasi ini digunakan untuk pengambilan semantik penelusuran. Pengambilan didasarkan pada perkalian titik SearchRequest.EmbeddingSpec.EmbeddingVector.vector dan embedding dokumen yang disediakan oleh EmbeddingConfig ini. Jika SearchRequest.EmbeddingSpec.EmbeddingVector.vector diberikan, akan menggantikan ServingConfig.embedding_config ini.
rankingExpression

string

Ekspresi peringkat mengontrol peringkat yang disesuaikan pada dokumen pengambilan. Untuk memanfaatkannya, penyematan dokumen diperlukan. Setelan ekspresi peringkat di ServingConfig berlaku untuk semua permintaan penelusuran yang ditayangkan oleh konfigurasi penayangan. Namun, jika SearchRequest.ranking_expression ditentukan, ekspresi peringkat ServingConfig akan digantikan.

Ekspresi peringkat adalah satu fungsi atau beberapa fungsi yang digabungkan dengan "+".

  • rankingExpression = function, { " + ", function };

Fungsi yang didukung:

  • double * relevanceScore
  • double * dotProduct(embedding_field_path)

Variabel fungsi:

  • relevanceScore: kata kunci yang telah ditentukan sebelumnya, digunakan untuk mengukur relevansi antara kueri dan dokumen.
  • embedding_field_path: kolom embedding dokumen yang digunakan dengan vektor embedding kueri.
  • dotProduct: fungsi embedding antara embedding_field_path dan vektor embedding kueri.

Contoh ekspresi peringkat:

Jika dokumen memiliki kolom penyematan doc_embedding, ekspresi peringkatnya bisa berupa 0.5 * relevanceScore + 0.3 * dotProduct(doc_embedding).
createTime

string (Timestamp format)

Hanya output. Stempel waktu pembuatan ServingConfig.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Hanya output. Stempel waktu ServingConfig diperbarui.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
filterControlIds[]

string

Kontrol filter untuk digunakan di jalur penayangan. Semua kontrol filter yang dipicu akan diterapkan. Kontrol filter harus berada di penyimpanan data yang sama dengan konfigurasi penayangan. Maksimum 20 kontrol filter.
boostControlIds[]

string

Kontrol peningkatan untuk digunakan di jalur penayangan. Semua kontrol peningkat yang dipicu akan diterapkan. Kontrol peningkat harus berada di penyimpanan data yang sama dengan konfigurasi penayangan. Maksimum 20 kontrol peningkat.
redirectControlIds[]

string

ID kontrol pengalihan. Hanya tindakan pengalihan yang dipicu pertama yang diterapkan, meskipun ada beberapa tindakan. Jumlah maksimum spesifikasi adalah 100.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_SEARCH.
synonymsControlIds[]

string

Spesifikasi sinonim kondisi. Jika beberapa kondisi sinonim cocok, semua kontrol sinonim yang cocok dalam daftar akan dieksekusi. Jumlah maksimum spesifikasi adalah 100.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_SEARCH.
onewaySynonymsControlIds[]

string

Kondisi spesifikasi sinonim satu arah. Jika beberapa kondisi sinonim satu arah cocok, semua kontrol sinonim satu arah yang cocok dalam daftar akan dieksekusi. Jumlah maksimum spesifikasi adalah 100.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_SEARCH.
dissociateControlIds[]

string

Kondisi tidak mengaitkan spesifikasi. Jika beberapa kondisi tidak mengaitkan cocok, semua kontrol tidak mengaitkan yang cocok dalam daftar akan dijalankan. Urutan tidak menjadi masalah. Jumlah maksimum spesifikasi adalah 100.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_SEARCH.
replacementControlIds[]

string

Spesifikasi penggantian kondisi. Diterapkan sesuai urutan dalam daftar. Istilah yang sebelumnya diganti tidak dapat diganti lagi. Jumlah maksimum spesifikasi adalah 100.

Hanya dapat disetel jika SolutionType adalah SOLUTION_TYPE_SEARCH.
ignoreControlIds[]

string

Kondisi mengabaikan spesifikasi. Jika beberapa kondisi pengabaian cocok, semua kontrol pengabaian yang cocok dalam daftar akan dijalankan. Urutan tidak menjadi masalah. Jumlah maksimum spesifikasi adalah 100.
promoteControlIds[]

string

Spesifikasi promosi kondisi.

Jumlah maksimum spesifikasi adalah 100.
personalizationSpec

object (PersonalizationSpec)

Spesifikasi untuk spesifikasi personalisasi.

Perhatikan bahwa jika ServingConfig.personalization_spec dan SearchRequest.personalization_spec ditetapkan, SearchRequest.personalization_spec akan menggantikan ServingConfig.personalization_spec.
answerGenerationSpec

object (AnswerGenerationSpec)

Opsional. Spesifikasi untuk pembuatan jawaban.
Konfigurasi khusus vertical industri. Berikut adalah daftar kolom yang bersifat eksklusif satu sama lain. Maksimal satu kolom akan ditetapkan dalam respons:
mediaConfig

object (MediaConfig)

MediaConfig dari konfigurasi penayangan.
genericConfig

object (GenericConfig)

GenericConfig dari konfigurasi inferensi.
Akhir kolom yang saling eksklusif.

Metode

answer

 Metode kueri jawaban.

create

 Membuat ServingConfig.

delete

 Menghapus ServingConfig.

get

 Mendapatkan ServingConfig.

list

 Mencantumkan semua ServingConfig yang ditautkan ke dataStore ini.

patch

 Mengupdate ServingConfig.

recommend

 Membuat rekomendasi, yang memerlukan peristiwa pengguna kontekstual.
Melakukan penelusuran.

searchLite

 Melakukan penelusuran.

streamAnswer

 Metode kueri jawaban (streaming).