Method: projects.locations.rankingConfigs.rank

Menempatkan daftar rekaman teks berdasarkan kueri input yang diberikan.

Permintaan HTTP

POST https://discoveryengine.googleapis.com/v1alpha/{rankingConfig=projects/*/locations/*/rankingConfigs/*}:rank

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
rankingConfig

string

Wajib. Nama resource konfigurasi layanan peringkat, seperti projects/{projectNum}/locations/{location}/rankingConfigs/default_ranking_config.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "model": string,
  "topN": integer,
  "query": string,
  "records": [
    {
      object (RankingRecord)
    }
  ],
  "ignoreRecordDetailsInResponse": boolean,
  "userLabels": {
    string: string,
    ...
  }
}
Kolom
model

string

ID model yang akan digunakan. Nilainya adalah salah satu dari:

  • semantic-ranker-512@latest: Model peringkat semantik dengan ukuran token input maksimum 512.

Nilai default-nya adalah semantic-ranker-512@latest jika tidak ditentukan.
topN

integer

Jumlah hasil yang akan ditampilkan. Jika tidak disetel atau tidak lebih besar dari nol, akan menampilkan semua hasil.
query

string

Kueri yang akan digunakan.
records[]

object (RankingRecord)

Wajib. Daftar rekaman untuk diberi peringkat.
ignoreRecordDetailsInResponse

boolean

Jika benar, respons hanya akan berisi ID dan skor rekaman. Secara default, nilainya adalah salah (false), dan respons akan berisi detail rekaman.
userLabels

map (key: string, value: string)

Label pengguna yang diterapkan ke resource harus memenuhi persyaratan berikut:

  • Setiap resource dapat memiliki beberapa label, hingga maksimum 64 label.
  • Setiap label harus berupa pasangan nilai kunci.
  • Kunci memiliki panjang minimum 1 karakter dan panjang maksimum 63 karakter, serta tidak boleh kosong. Nilai boleh kosong dan memiliki panjang maksimum 63 karakter.
  • Kunci dan nilai hanya boleh berisi huruf kecil, karakter numerik, garis bawah, dan tanda hubung. Semua karakter harus menggunakan encoding UTF-8, dan karakter internasional boleh digunakan.
  • Bagian kunci label harus unik. Namun, Anda dapat menggunakan kunci yang sama dengan beberapa resource.
  • Kunci harus diawali dengan huruf kecil atau karakter internasional.

Lihat Dokumen Google Cloud untuk mengetahui detail selengkapnya.

Isi respons

Pesan respons untuk metode RankService.Rank.

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "records": [
    {
      object (RankingRecord)
    }
  ]
}
Kolom
records[]

object (RankingRecord)

Daftar rekaman yang diurutkan berdasarkan skor menurun.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/discoveryengine.readwrite

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

Izin IAM

Memerlukan izin IAM berikut pada resource rankingConfig:

  • discoveryengine.rankingConfigs.rank

Untuk mengetahui informasi selengkapnya, lihat dokumentasi IAM.

RankingRecord

Rekam pesan untuk metode RankService.Rank.

Representasi JSON 
{
  "id": string,
  "title": string,
  "content": string,
  "score": number
}
Kolom
id

string

ID unik untuk merepresentasikan data.
title

string

Judul rekaman. Kosong secara default. Setidaknya salah satu dari title atau content harus ditetapkan, jika tidak, error INVALID_ARGUMENT akan ditampilkan.
content

string

Konten data. Kosong secara default. Setidaknya salah satu dari title atau content harus ditetapkan, jika tidak, error INVALID_ARGUMENT akan ditampilkan.
score

number

Skor rekaman ini berdasarkan kueri yang diberikan dan model yang dipilih. Skor akan dibulatkan menjadi 2 tempat desimal. Jika skor mendekati 0, skor akan dibulatkan menjadi 0,0001 untuk menghindari nilai yang tidak ditetapkan.