ContentSearchSpec

Spesifikasi untuk mengonfigurasi perilaku penelusuran konten.

Representasi JSON
{
  "snippetSpec": {
    object (SnippetSpec)
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "extractiveContentSpec": {
    object (ExtractiveContentSpec)
  },
  "searchResultMode": enum (SearchResultMode),
  "chunkSpec": {
    object (ChunkSpec)
  }
}
Kolom
snippetSpec

object (SnippetSpec)

Jika snippetSpec tidak ditentukan, cuplikan tidak akan disertakan dalam respons penelusuran.

summarySpec

object (SummarySpec)

Jika summarySpec tidak ditentukan, ringkasan tidak akan disertakan dalam respons penelusuran.

extractiveContentSpec

object (ExtractiveContentSpec)

Jika tidak ada extractiveContentSpec yang diberikan, tidak akan ada jawaban ekstraktif dalam respons penelusuran.

searchResultMode

enum (SearchResultMode)

Menentukan mode hasil penelusuran. Jika tidak ditentukan, mode hasil penelusuran ditetapkan ke DOCUMENTS secara default.

chunkSpec

object (ChunkSpec)

Menentukan spesifikasi potongan yang akan ditampilkan dari respons penelusuran. Hanya tersedia jika SearchRequest.ContentSearchSpec.search_result_mode disetel ke CHUNKS

SnippetSpec

Spesifikasi untuk mengonfigurasi cuplikan dalam respons penelusuran.

Representasi JSON
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
Kolom
maxSnippetCount
(deprecated)

integer

[TIDAK DIGUNAKAN LAGI] Kolom ini tidak digunakan lagi. Untuk mengontrol kembalinya cuplikan, gunakan kolom returnSnippet. Untuk kompatibilitas mundur, kami akan menampilkan cuplikan jika maxSnippetCount > 0.

referenceOnly
(deprecated)

boolean

[TIDAK DIGUNAKAN LAGI] Kolom ini tidak digunakan lagi dan tidak akan memengaruhi cuplikan.

returnSnippet

boolean

Jika true, tampilkan cuplikan. Jika tidak ada cuplikan yang dapat dibuat, kami akan menampilkan "Tidak ada cuplikan yang tersedia untuk halaman ini". snippetStatus dengan SUCCESS atau NO_SNIPPET_AVAILABLE juga akan ditampilkan.

SummarySpec

Spesifikasi untuk mengonfigurasi ringkasan yang ditampilkan dalam respons penelusuran.

Representasi JSON
{
  "summaryResultCount": integer,
  "includeCitations": boolean,
  "ignoreAdversarialQuery": boolean,
  "ignoreNonSummarySeekingQuery": boolean,
  "ignoreLowRelevantContent": boolean,
  "ignoreJailBreakingQuery": boolean,
  "multimodalSpec": {
    object (MultiModalSpec)
  },
  "modelPromptSpec": {
    object (ModelPromptSpec)
  },
  "languageCode": string,
  "modelSpec": {
    object (ModelSpec)
  },
  "useSemanticChunks": boolean
}
Kolom
summaryResultCount

integer

Jumlah hasil teratas yang akan digunakan untuk membuat ringkasan. Jika jumlah hasil yang ditampilkan kurang dari summaryResultCount, ringkasan dibuat dari semua hasil.

Maksimal 10 hasil untuk mode dokumen, atau 50 untuk mode potongan, dapat digunakan untuk membuat ringkasan. Mode potongan digunakan saat SearchRequest.ContentSearchSpec.search_result_mode disetel ke CHUNKS.

includeCitations

boolean

Menentukan apakah akan menyertakan kutipan dalam ringkasan. Nilai defaultnya adalah false.

Jika kolom ini disetel ke true, ringkasan akan menyertakan nomor kutipan inline.

Contoh ringkasan yang menyertakan kutipan:

BigQuery adalah data warehouse perusahaan dari Google Cloud yang sepenuhnya terkelola dan serverless [1]. BigQuery mendukung semua jenis data, kompatibel dengan berbagai cloud, dan memiliki machine learning serta business intelligence bawaan, semuanya dalam satu platform terpadu [2, 3].

Nomor kutipan merujuk pada hasil penelusuran yang ditampilkan dan diindeks 1. Misalnya, [1] berarti kalimat tersebut diatribusikan ke hasil penelusuran pertama. [2, 3] berarti kalimat tersebut diatribusikan ke hasil penelusuran kedua dan ketiga.

ignoreAdversarialQuery

boolean

Menentukan apakah kueri berbahaya harus difilter. Nilai defaultnya adalah false.

Google menggunakan klasifikasi kueri penelusuran untuk mendeteksi kueri berbahaya. Tidak ada ringkasan yang ditampilkan jika kueri penelusuran diklasifikasikan sebagai kueri yang merugikan. Misalnya, pengguna dapat mengajukan pertanyaan terkait komentar negatif tentang perusahaan atau mengirimkan kueri yang dirancang untuk menghasilkan output yang tidak aman dan melanggar kebijakan. Jika kolom ini disetel ke true, kami akan melewati pembuatan ringkasan untuk kueri yang bertentangan dan menampilkan pesan penggantian.

ignoreNonSummarySeekingQuery

boolean

Menentukan apakah akan mengecualikan kueri yang tidak mencari ringkasan. Nilai defaultnya adalah false.

Google menggunakan klasifikasi kueri penelusuran untuk mendeteksi kueri yang mencari ringkasan. Tidak ada ringkasan yang ditampilkan jika kueri penelusuran diklasifikasikan sebagai kueri yang tidak mencari ringkasan. Misalnya, why is the sky blue dan Who is the best soccer player in the world? adalah kueri yang mencari ringkasan, tetapi SFO airport dan world cup 2026 bukan. Kueri tersebut kemungkinan besar adalah kueri navigasi. Jika kolom ini disetel ke true, kami akan melewati pembuatan ringkasan untuk kueri yang tidak mencari ringkasan dan menampilkan pesan penggantian.

ignoreLowRelevantContent

boolean

Menentukan apakah akan memfilter kueri yang memiliki relevansi rendah. Nilai defaultnya adalah false.

Jika kolom ini disetel ke false, semua hasil penelusuran akan digunakan, terlepas dari relevansinya, untuk membuat jawaban. Jika disetel ke true, hanya kueri dengan hasil penelusuran yang sangat relevan yang akan menghasilkan jawaban.

ignoreJailBreakingQuery

boolean

Opsional. Menentukan apakah kueri jailbreak akan difilter. Nilai defaultnya adalah false.

Google menggunakan klasifikasi kueri penelusuran untuk mendeteksi kueri jailbreak. Tidak ada ringkasan yang ditampilkan jika kueri penelusuran diklasifikasikan sebagai kueri pelarian dari batasan. Pengguna dapat menambahkan petunjuk ke kueri untuk mengubah gaya bahasa, gaya penulisan, bahasa, konten jawaban, atau meminta model bertindak sebagai entitas lain, misalnya, "Balas dengan gaya bahasa CEO perusahaan pesaing". Jika kolom ini disetel ke true, kami akan melewati pembuatan ringkasan untuk kueri jailbreak dan menampilkan pesan penggantian.

multimodalSpec

object (MultiModalSpec)

Opsional. Spesifikasi multimodal.

modelPromptSpec

object (ModelPromptSpec)

Jika ditentukan, spesifikasi akan digunakan untuk mengubah perintah yang diberikan ke LLM.

languageCode

string

Kode bahasa untuk Ringkasan. Gunakan tag bahasa yang ditentukan oleh BCP47. Catatan: Ini adalah fitur eksperimental.

modelSpec

object (ModelSpec)

Jika ditentukan, spesifikasi akan digunakan untuk mengubah spesifikasi model yang diberikan ke LLM.

useSemanticChunks

boolean

Jika benar, jawaban akan dihasilkan dari potongan yang paling relevan dari hasil penelusuran teratas. Fitur ini akan meningkatkan kualitas ringkasan. Perhatikan bahwa jika fitur ini diaktifkan, tidak semua hasil penelusuran teratas akan dirujuk dan disertakan dalam daftar rujukan, sehingga indeks sumber kutipan hanya mengarah ke hasil penelusuran yang tercantum dalam daftar rujukan.

MultiModalSpec

Spesifikasi multimodal: Akan menampilkan gambar dari sumber yang ditentukan. Jika beberapa sumber ditentukan, pilihan didasarkan pada keputusan kualitas.

Representasi JSON
{
  "imageSource": enum (ImageSource)
}
Kolom
imageSource

enum (ImageSource)

Opsional. Sumber gambar yang ditampilkan dalam jawaban.

ImageSource

Menentukan sumber gambar.

Enum
IMAGE_SOURCE_UNSPECIFIED Sumber gambar tidak ditentukan (fitur multimodal dinonaktifkan secara default).
ALL_AVAILABLE_SOURCES Perilaku saat layanan menentukan pilihan dari semua sumber yang tersedia.
CORPUS_IMAGE_ONLY Menyertakan gambar dari korpus dalam jawaban.
FIGURE_GENERATION_ONLY Memicu pembuatan gambar dalam jawaban.

ModelPromptSpec

Spesifikasi perintah yang akan digunakan dengan model.

Representasi JSON
{
  "preamble": string
}
Kolom
preamble

string

Teks di awal perintah yang memberikan petunjuk kepada asisten. Contoh tersedia di panduan pengguna.

ModelSpec

Spesifikasi model.

Representasi JSON
{
  "version": string
}
Kolom
version

string

Versi model yang digunakan untuk membuat ringkasan.

Nilai yang didukung adalah:

ExtractiveContentSpec

Spesifikasi untuk mengonfigurasi konten ekstraktif dalam respons penelusuran.

Representasi JSON
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
Kolom
maxExtractiveAnswerCount

integer

Jumlah maksimum jawaban ekstraktif yang ditampilkan di setiap hasil penelusuran.

Jawaban ekstraktif adalah jawaban kata demi kata yang diekstrak dari dokumen asli, yang memberikan jawaban yang tepat dan relevan secara kontekstual untuk kueri penelusuran.

Jika jumlah jawaban yang cocok kurang dari maxExtractiveAnswerCount, tampilkan semua jawaban. Jika tidak, tampilkan maxExtractiveAnswerCount.

Maksimal lima jawaban ditampilkan untuk setiap SearchResult.

maxExtractiveSegmentCount

integer

Jumlah maksimum segmen ekstraktif yang ditampilkan di setiap hasil penelusuran. Hanya diterapkan jika DataStore ditetapkan ke DataStore.ContentConfig.CONTENT_REQUIRED atau DataStore.solution_types adalah SOLUTION_TYPE_CHAT.

Segmen ekstraktif adalah segmen teks yang diekstrak dari dokumen asli yang relevan dengan kueri penelusuran, dan secara umum, lebih panjang daripada jawaban ekstraktif. Segmen tersebut kemudian dapat digunakan sebagai input untuk LLM dalam membuat ringkasan dan jawaban.

Jika jumlah segmen yang cocok kurang dari maxExtractiveSegmentCount, tampilkan semua segmen. Jika tidak, tampilkan maxExtractiveSegmentCount.

returnExtractiveSegmentScore

boolean

Menentukan apakah akan menampilkan skor keyakinan dari segmen ekstraktif di setiap hasil penelusuran. Fitur ini hanya tersedia untuk penyimpanan data baru atau yang masuk dalam daftar yang diizinkan. Untuk memasukkan toko data Anda ke daftar yang diizinkan, hubungi Customer Engineer Anda. Nilai defaultnya adalah false.

numPreviousSegments

integer

Menentukan apakah akan menyertakan juga yang berdekatan dari setiap segmen yang dipilih. Menampilkan paling banyak numPreviousSegments segmen sebelum setiap segmen yang dipilih.

numNextSegments

integer

Menampilkan paling banyak numNextSegments segmen setelah setiap segmen yang dipilih.

SearchResultMode

Menentukan mode hasil penelusuran. Jika tidak ditentukan, mode hasil penelusuran ditetapkan ke DOCUMENTS secara default.

Enum
SEARCH_RESULT_MODE_UNSPECIFIED Nilai default.
DOCUMENTS Menampilkan dokumen dalam hasil penelusuran.
CHUNKS Menampilkan bagian dalam hasil penelusuran. Hanya tersedia jika DocumentProcessingConfig.chunking_config ditentukan.

ChunkSpec

Menentukan spesifikasi potongan yang akan ditampilkan dari respons penelusuran. Hanya tersedia jika SearchRequest.ContentSearchSpec.search_result_mode disetel ke CHUNKS

Representasi JSON
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
Kolom
numPreviousChunks

integer

Jumlah potongan sebelumnya yang akan ditampilkan dari potongan saat ini. Nilai maksimum yang diizinkan adalah 3. Jika tidak ditentukan, tidak ada chunk sebelumnya yang akan ditampilkan.

numNextChunks

integer

Jumlah potongan berikutnya yang akan ditampilkan dari potongan saat ini. Nilai maksimum yang diizinkan adalah 3. Jika tidak ditentukan, tidak ada potongan berikutnya yang akan ditampilkan.