Agent Retrieval (sebelumnya Penelusuran Vektor 2.0) menyediakan VertexRanker untuk pemeringkatan ulang semantik, yang didukung oleh Ranking API.
Setelah Agent Retrieval mengambil dan menggabungkan hasil kandidat
(menggunakan Reciprocal Rank Fusion (RRF)), VertexRanker akan memberi skor ulang pada kandidat
yang digabungkan berdasarkan kueri bahasa alami Anda menggunakan model semantik khusus.
Hal ini meningkatkan relevansi hasil top-k, terutama untuk kueri yang
penelusurannya saja tidak memiliki nuansa. Pemeringkatan ulang terjadi di sisi server dengan panggilan ke
BatchSearchDataObjects. Tidak diperlukan pengkabelan sisi klien tambahan atau perjalanan pulang pergi tambahan.
VertexRanker
VertexRanker dikonfigurasi sebagai reranker untuk kolom combine.ranker dari objek BatchSearchDataObjectsRequest. Anda harus mengonfigurasi pemeringkat utama
(hanya RRF yang didukung). Reranker berjalan setelah langkah penggabungan RRF dan
mengganti output dengan daftar yang diberi skor ulang secara semantik.
Tabel berikut mencantumkan kolom konfigurasi pemberi peringkat.
| Kolom | Diperlukan | Deskripsi |
|---|---|---|
combine.ranker.rrf.weights |
Ya | Bobot untuk penggabungan RRF dari hasil penelusuran yang mendasarinya. |
combine.ranker.vertex_ranker.model |
Ya | Nama model peringkat. Nilai yang didukung: semantic-ranker-fast@latest, semantic-ranker-default@latest, semantic-ranker-fast-004, semantic-ranker-default-004. Lihat Model Ranking API untuk mengetahui detail masing-masing model. |
combine.ranker.vertex_ranker.top_n |
Ya | Jumlah maksimum kandidat dari daftar gabungan yang akan dikirim ke pemberi peringkat. Nilai yang valid adalah dari 1 hingga 1000. |
combine.ranker.vertex_ranker.text_record_spec.query |
Ya | Kueri bahasa alami yang digunakan oleh pemberi peringkat untuk memberi skor pada data. |
combine.ranker.vertex_ranker.text_record_spec.title_template |
Ya | String template, misalnya, {title}, yang menentukan cara mengekstrak (membuat) judul untuk setiap data. Gunakan jalur titik untuk menentukan kolom data. |
combine.ranker.vertex_ranker.text_record_spec.content_template |
Ya | String template, misalnya, {body.text}, yang menentukan cara mengekstrak (membuat) konten utama untuk setiap data. Gunakan jalur titik untuk menentukan kolom data. |
combine.top_k |
Opsional | Jumlah akhir hasil yang akan ditampilkan setelah pengurutan ulang. Nilai ini harus kurang dari atau sama dengan vertex_ranker.top_n dan kurang dari atau sama dengan 1.000. |
Contoh berikut menunjukkan isi permintaan.
{
"searches": [
{ "semantic_search": { "search_text": "running shoes", "search_field": "embedding", "task_type": "RETRIEVAL_QUERY", "top_k": 50 } },
{ "text_search": { "search_text": "running shoes", "data_field_names": ["title"], "top_k": 50 } }
],
"combine": {
"top_k": 10,
"ranker": {
"rrf": { "weights": [1.0, 1.0] },
"vertex_ranker": {
"model": "semantic-ranker-fast@latest",
"top_n": 50,
"text_record_spec": {
"query": "running shoes",
"title_template": "{title}",
"content_template": "{body.text}"
}
}
}
}
}
Template menggunakan jalur titik ke kolom data Objek Data, misalnya, {title}
atau {nested.field}. Kolom ini harus ada dalam skema Koleksi, jika tidak, permintaan akan ditolak selama validasi. Jika Objek Data tidak memiliki kolom yang disediakan, server akan mengambil ulang data lengkap dari penyimpanan secara transparan sehingga template masih dapat diisi.
Kuota dan harga
VertexRanker di Agent Retrieval menggunakan kuota paket gratis dengan penagihan kelebihan penggunaan berbasis penggunaan. Setiap project menerima kuota gratis penggunaan peringkat per periode 30 hari. Penggunaan dalam kuota ini tidak dikenai biaya. Harga Ranking API standar berlaku untuk project konsumen untuk penggunaan apa pun di luar kuota ini.
Tabel berikut mencantumkan nilai kuota.
| Item | Nilai |
|---|---|
| Kuota paket gratis | 80.000 unit peringkat per project konsumen per periode 30 hari. |
| Kelebihan | Ditagih dengan harga Ranking API standar pada project konsumen. |
| Data maksimum per panggilan rerank | 1000 (top_n harus berada dalam rentang [1, 1000] dan top_k <= top_n). |
Mencapai kuota paket gratis tidak akan menggagalkan permintaan Anda. Setelah kuota 80.000 unit peringkat habis, penggunaan VertexRanker berikutnya akan terus berhasil dan ditagih sebagai kelebihan penggunaan. Kuota akan direset 30 hari sejak penggunaan pertama Anda.
Unit peringkat dihitung dari jumlah data yang dikirim ke pemberi peringkat dan ukuran template judul dan kontennya, menggunakan penghitungan yang sama dengan Ranking API mandiri. Lihat Harga Ranking API untuk mengetahui detail selengkapnya.
Sebelum Anda dapat menggunakan VertexRanker, Discovery Engine harus diaktifkan di project konsumen. Untuk mengetahui informasi selengkapnya, lihat Kondisi kegagalan.
Penanganan kegagalan dan peringatan
VertexRanker adalah reranker dengan upaya terbaik. Jika panggilan peringkat gagal, RPC BatchSearchDataObjects akan tetap berhasil dan menampilkan hasil gabungan RRF yang dipotong menjadi top_k. Kegagalan dilaporkan di kolom search_response_metadata.warnings dalam respons. Kode status lengkap dari Ranking API dipertahankan. Kode peringatan untuk status yang tidak terduga adalah
UNAVAILABLE dengan pesan peringatan:
"Reranking is temporarily unavailable. Returning fused (RRF) results without
semantic reranking."
Kondisi kegagalan
Seluruh RPC BatchSearchDataObjects gagal dengan FAILED_PRECONDITION
(tidak ada penggantian ke RRF) dalam kasus berikut.
- Discovery Engine API tidak diaktifkan — Ranking API menampilkan
FAILED_PRECONDITIONdengan pesanDiscovery Engine API is not enabled for the consumer project /<N/>. Please enable the API and try again."Perbaikan: aktifkan Discovery Engine API di project konsumen.
Pelanggan harus mengaktifkan Discovery Engine untuk project konsumen agar pemeringkatan ulang dapat dilakukan.
Tabel berikut mencantumkan kode peringatan, penyebab umum yang menghasilkan peringatan, dan pesan yang menjelaskan peringatan tersebut.
| Kode Peringatan | Penyebab Umum | Pesan Peringatan |
|---|---|---|
RESOURCE_EXHAUSTED |
Melebihi kuota Ranking API di project konsumen. Catatan: melebihi kuota 80.000 unit peringkat tidak akan menyebabkan peringatan ini; sebagai gantinya,kelebihan penggunaan akan ditagih. | <Quota exceeded message>; RankService.Rank call failed for consumer project <N> with request query: <query> and <model>: semantic-ranker-fast@latest number of records: <N> |
DEADLINE_EXCEEDED |
Ranker.Rank tidak selesai dalam batas waktu permintaan. |
<deadline-exceeded message from Ranker.Rank>; RankService.Rank call failed for consumer project <N> with request query: <query> and <model>: semantic-ranker-fast@latest number of records: <N> |
UNAVAILABLE |
Ranker.Rank menampilkan UNAVAILABLE, atau menampilkan kode yang tidak dipertahankan (misalnya, INTERNAL) yang diciutkan menjadi UNAVAILABLE. |
Jika kode yang mendasarinya adalah UNAVAILABLE: "RankService.Rank call failed for consumer project... Jika tidak: "Reranking is temporarily unavailable. Returning fused (RRF) results without semantic reranking." |
FAILED_PRECONDITION |
FAILED_PRECONDITION apa pun yang ditampilkan oleh Ranking API. |
RankService.Rank call failed for consumer project <N> with request query: <query> and <model>: semantic-ranker-fast@latest number of records: <N> |
CANCELLED |
Pemanggil membatalkan RPC BatchSearchDataObjects sebelum pemeringkatan ulang selesai. |
<cancellation message from the cancelled RankService.Rank RPC>; RankService.Rank call failed for consumer project <N> with request query: <query> and <model>: semantic-ranker-fast@latest number of records: <N> |