ContentSearchSpec

Una specifica per la configurazione del comportamento della ricerca dei contenuti.

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

object (SnippetSpec)

Se snippetSpec non è specificato, gli snippet non vengono inclusi nella risposta della ricerca.
summarySpec

object (SummarySpec)

Se summarySpec non è specificato, i riepiloghi non vengono inclusi nella risposta della ricerca.
extractiveContentSpec

object (ExtractiveContentSpec)

Se non viene fornito alcun extractiveContentSpec, non verrà visualizzata alcuna risposta estrattiva nella risposta della ricerca.
searchResultMode

enum (SearchResultMode)

Specifica la modalità dei risultati di ricerca. Se non specificata, la modalità dei risultati di ricerca è impostata su DOCUMENTS per impostazione predefinita.
chunkSpec

object (ChunkSpec)

Specifica la specifica del blocco da restituire dalla risposta di ricerca. Disponibile solo se SearchRequest.ContentSearchSpec.search_result_mode è impostato su CHUNKS

SnippetSpec

Una specifica per la configurazione degli snippet in una risposta della ricerca.

Rappresentazione JSON 
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
Campi
maxSnippetCount
(deprecated)

integer

[OBSOLETO] Questo campo è obsoleto. Per controllare la restituzione degli snippet, utilizza il campo returnSnippet. Per la compatibilità con le versioni precedenti, restituiremo lo snippet se maxSnippetCount > 0.
referenceOnly
(deprecated)

boolean

[DEPRECATO] Questo campo è deprecato e non avrà alcun effetto sullo snippet.
returnSnippet

boolean

Se true, restituisci lo snippet. Se non è possibile generare uno snippet, viene restituito il messaggio "Nessuno snippet disponibile per questa pagina". Verrà restituito anche un snippetStatus con SUCCESS o NO_SNIPPET_AVAILABLE.

SummarySpec

Una specifica per la configurazione di un riepilogo restituito in una risposta di ricerca.

Rappresentazione 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
}
Campi
summaryResultCount

integer

Il numero di primi risultati da cui generare il riepilogo. Se il numero di risultati restituiti è inferiore a summaryResultCount, il riepilogo viene generato da tutti i risultati.

Per generare un riepilogo, è possibile utilizzare al massimo 10 risultati per la modalità Documenti o 50 per la modalità Chunk. La modalità Chunks viene utilizzata quando SearchRequest.ContentSearchSpec.search_result_mode è impostato su CHUNKS.
includeCitations

boolean

Specifica se includere le citazioni nel riepilogo. Il valore predefinito è false.

Quando questo campo è impostato su true, i riepiloghi includono i numeri delle citazioni in linea.

Esempio di riepilogo con citazioni:

BigQuery è il data warehouse aziendale completamente gestito e serverless di Google Cloud [1]. BigQuery supporta tutti i tipi di dati, funziona su cloud diversi ed è dotato di business intelligence e machine learning integrati, il tutto all'interno di una piattaforma unificata [2, 3].

I numeri delle citazioni si riferiscono ai risultati di ricerca restituiti e sono indicizzati a partire da 1. Ad esempio, [1] significa che la frase è attribuita al primo risultato di ricerca. [2, 3] significa che la frase è attribuita sia al secondo che al terzo risultato di ricerca.
ignoreAdversarialQuery

boolean

Specifica se filtrare le query contraddittorie. Il valore predefinito è false.

Google utilizza la classificazione delle query di ricerca per rilevare le query ostili. Non viene restituito alcun riepilogo se la query di ricerca viene classificata come query ostile. Ad esempio, un utente potrebbe porre una domanda relativa a commenti negativi sull'azienda o inviare una query progettata per generare output non sicuri che violano le norme. Se questo campo è impostato su true, non generiamo riepiloghi per le query avversative e restituiamo invece messaggi di riserva.
ignoreNonSummarySeekingQuery

boolean

Specifica se filtrare le query che non cercano riepiloghi. Il valore predefinito è false.

Google utilizza la classificazione delle query di ricerca per rilevare le query che cercano riepiloghi. Non viene restituito alcun riepilogo se la query di ricerca viene classificata come query che non richiede un riepilogo. Ad esempio, why is the sky blue e Who is the best soccer player in the world? sono query che cercano riassunti, mentre SFO airport e world cup 2026 non lo sono. Si tratta molto probabilmente di query di navigazione. Se questo campo è impostato su true, saltiamo la generazione di riepiloghi per le query che non cercano riepiloghi e restituiamo invece messaggi di riserva.
ignoreLowRelevantContent

boolean

Specifica se filtrare le query con scarsa pertinenza. Il valore predefinito è false.

Se questo campo è impostato su false, vengono utilizzati tutti i risultati di ricerca, indipendentemente dalla pertinenza, per generare le risposte. Se impostato su true, solo le query con risultati di ricerca di pertinenza elevata genereranno risposte.
ignoreJailBreakingQuery

boolean

Facoltativo. Specifica se filtrare le query di jailbreaking. Il valore predefinito è false.

Google utilizza la classificazione delle query di ricerca per rilevare le query di jailbreaking. Non viene restituito alcun riepilogo se la query di ricerca viene classificata come query di evasione. Un utente potrebbe aggiungere istruzioni alla query per modificare il tono, lo stile, la lingua, il contenuto della risposta o chiedere al modello di agire come un'entità diversa, ad esempio "Rispondi con il tono del CEO di un'azienda concorrente". Se questo campo è impostato su true, saltiamo la generazione di riepiloghi per le query di jailbreaking e restituiamo invece messaggi di riserva.
multimodalSpec

object (MultiModalSpec)

Facoltativo. Specifica multimodale.
modelPromptSpec

object (ModelPromptSpec)

Se specificata, la specifica verrà utilizzata per modificare il prompt fornito all'LLM.
languageCode

string

Codice lingua per il riepilogo. Utilizza i tag di lingua definiti da BCP47. Nota: questa è una funzionalità sperimentale.
modelSpec

object (ModelSpec)

Se specificata, la specifica verrà utilizzata per modificare la specifica del modello fornita all'LLM.
useSemanticChunks

boolean

Se è true, la risposta verrà generata dai chunk più pertinenti dei primi risultati di ricerca. Questa funzionalità migliorerà la qualità dei riassunti. Tieni presente che, con questa funzionalità attivata, non tutti i primi risultati di ricerca verranno citati e inclusi nell'elenco delle citazioni, pertanto l'indice delle fonti delle citazioni punta solo ai risultati di ricerca elencati nell'elenco delle citazioni.

MultiModalSpec

Specifica multimodale: restituirà un'immagine dalla fonte specificata. Se vengono specificate più fonti, la scelta si basa sulla qualità.

Rappresentazione JSON 
{
  "imageSource": enum (ImageSource)
}
Campi
imageSource

enum (ImageSource)

Facoltativo. L'origine dell'immagine restituita nella risposta.

ImageSource

Specifica l'origine dell'immagine.

Enum
IMAGE_SOURCE_UNSPECIFIED Origine immagine non specificata (la funzionalità multimodale è disattivata per impostazione predefinita).
ALL_AVAILABLE_SOURCES Comportamento quando il servizio determina la selezione da tutte le origini disponibili.
CORPUS_IMAGE_ONLY Include un'immagine del corpus nella risposta.
FIGURE_GENERATION_ONLY Attiva la generazione di cifre nella risposta.

ModelPromptSpec

Specifica del prompt da utilizzare con il modello.

Rappresentazione JSON 
{
  "preamble": string
}
Campi
preamble

string

Testo all'inizio del prompt che fornisce istruzioni all'assistente. Gli esempi sono disponibili nella guida dell'utente.

ModelSpec

Specifica del modello.

Rappresentazione JSON 
{
  "version": string
}
Campi
version

string

La versione del modello utilizzata per generare il riepilogo.

I valori supportati sono:

ExtractiveContentSpec

Una specifica per la configurazione dei contenuti estrattivi in una risposta di ricerca.

Rappresentazione JSON 
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
Campi
maxExtractiveAnswerCount

integer

Il numero massimo di risposte estrattive restituite in ogni risultato di ricerca.

Una risposta estrattiva è una risposta letterale estratta dal documento originale, che fornisce una risposta precisa e pertinente al contesto della query di ricerca.

Se il numero di risposte corrispondenti è inferiore a maxExtractiveAnswerCount, restituisci tutte le risposte. In caso contrario, restituisci maxExtractiveAnswerCount.

Per ogni SearchResult vengono restituite al massimo cinque risposte.
maxExtractiveSegmentCount

integer

Il numero massimo di segmenti estrattivi restituiti in ogni risultato di ricerca. Viene applicato solo se DataStore è impostato su DataStore.ContentConfig.CONTENT_REQUIRED o DataStore.solution_types è SOLUTION_TYPE_CHAT.

Un segmento estrattivo è un segmento di testo estratto dal documento originale pertinente alla query di ricerca e, in generale, più dettagliato di una risposta estrattiva. Il segmento potrebbe quindi essere utilizzato come input per gli LLM per generare riepiloghi e risposte.

Se il numero di segmenti corrispondenti è inferiore a maxExtractiveSegmentCount, restituisci tutti i segmenti. In caso contrario, restituisci maxExtractiveSegmentCount.
returnExtractiveSegmentScore

boolean

Specifica se restituire il punteggio di affidabilità dai segmenti estrattivi in ogni risultato di ricerca. Questa funzionalità è disponibile solo per i datastore nuovi o inseriti nella lista consentita. Per inserire il tuo datastore nella lista consentita, contatta il tuo Customer Engineer. Il valore predefinito è false.
numPreviousSegments

integer

Specifica se includere anche gli adiacenti di ciascuno dei segmenti selezionati. Restituisci al massimo numPreviousSegments segmenti prima di ogni segmento selezionato.
numNextSegments

integer

Restituisci al massimo numNextSegments segmenti dopo ogni segmento selezionato.

SearchResultMode

Specifica la modalità dei risultati di ricerca. Se non specificata, la modalità dei risultati di ricerca è impostata su DOCUMENTS per impostazione predefinita.

Enum
SEARCH_RESULT_MODE_UNSPECIFIED Valore predefinito.
DOCUMENTS Restituisce i documenti nel risultato di ricerca.
CHUNKS Restituisce i segmenti nel risultato di ricerca. Disponibile solo se è specificato DocumentProcessingConfig.chunking_config.

ChunkSpec

Specifica la specifica del blocco da restituire dalla risposta di ricerca. Disponibile solo se SearchRequest.ContentSearchSpec.search_result_mode è impostato su CHUNKS

Rappresentazione JSON 
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
Campi
numPreviousChunks

integer

Il numero di chunk precedenti da restituire del chunk corrente. Il valore massimo consentito è 3. Se non specificato, non verranno restituiti chunk precedenti.
numNextChunks

integer

Il numero di blocchi successivi da restituire del blocco corrente. Il valore massimo consentito è 3. Se non specificato, non verranno restituiti chunk successivi.