ContentSearchSpec

Spécification permettant de configurer le comportement de la recherche de contenu.

Représentation JSON 
{
  "snippetSpec": {
    object (SnippetSpec)
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "extractiveContentSpec": {
    object (ExtractiveContentSpec)
  },
  "searchResultMode": enum (SearchResultMode),
  "chunkSpec": {
    object (ChunkSpec)
  }
}
Champs
snippetSpec

object (SnippetSpec)

Si snippetSpec n'est pas spécifié, les extraits ne sont pas inclus dans la réponse de recherche.
summarySpec

object (SummarySpec)

Si summarySpec n'est pas spécifié, les résumés ne sont pas inclus dans la réponse de recherche.
extractiveContentSpec

object (ExtractiveContentSpec)

Si aucun extractiveContentSpec n'est fourni, aucune réponse extractive ne sera incluse dans la réponse de recherche.
searchResultMode

enum (SearchResultMode)

Spécifie le mode des résultats de recherche. Si aucun mode n'est spécifié, le mode de résultat de recherche est défini par défaut sur DOCUMENTS.
chunkSpec

object (ChunkSpec)

Spécifie la spécification du bloc à renvoyer à partir de la réponse de recherche. Disponible uniquement si SearchRequest.ContentSearchSpec.search_result_mode est défini sur CHUNKS

SnippetSpec

Spécification permettant de configurer des extraits dans une réponse de recherche.

Représentation JSON 
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
Champs
maxSnippetCount
(deprecated)

integer

[OBSOLÈTE] Ce champ est obsolète. Pour contrôler le retour d'extrait, utilisez le champ returnSnippet. Pour assurer la rétrocompatibilité, nous renverrons un extrait si maxSnippetCount > 0.
referenceOnly
(deprecated)

boolean

[OBSOLÈTE] Ce champ est obsolète et n'aura aucun effet sur l'extrait.
returnSnippet

boolean

Si true, renvoie l'extrait. Si aucun extrait ne peut être généré, nous renvoyons le message "Aucun extrait n'est disponible pour cette page". Un snippetStatus avec SUCCESS ou NO_SNIPPET_AVAILABLE sera également renvoyé.

SummarySpec

Spécification permettant de configurer un résumé renvoyé dans une réponse de recherche.

Représentation 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
}
Champs
summaryResultCount

integer

Nombre de meilleurs résultats à partir desquels générer le résumé. Si le nombre de résultats renvoyés est inférieur à summaryResultCount, le résumé est généré à partir de tous les résultats.

Vous pouvez utiliser au maximum 10 résultats pour le mode "Documents" ou 50 pour le mode "Blocs" afin de générer un résumé. Le mode "chunks" est utilisé lorsque SearchRequest.ContentSearchSpec.search_result_mode est défini sur CHUNKS.
includeCitations

boolean

Indique si les citations doivent être incluses dans le résumé. La valeur par défaut est false.

Lorsque ce champ est défini sur true, les résumés incluent des numéros de citation intégrés.

Exemple de résumé incluant des citations :

BigQuery est l'entrepôt de données d'entreprise sans serveur et entièrement géré de Google Cloud [1]. BigQuery est compatible avec tous les types de données, fonctionne sur plusieurs clouds et intègre des technologies de machine learning et d'informatique décisionnelle, le tout dans une plate-forme unifiée [2, 3].

Les numéros de citation font référence aux résultats de recherche renvoyés et sont indexés à partir de 1. Par exemple, [1] signifie que la phrase est attribuée au premier résultat de recherche. [2, 3] signifie que la phrase est attribuée aux deuxième et troisième résultats de recherche.
ignoreAdversarialQuery

boolean

Indique s'il faut filtrer les requêtes contradictoires. La valeur par défaut est false.

Google utilise la classification des requêtes de recherche pour détecter les requêtes adverses. Aucun résumé n'est renvoyé si la requête de recherche est classée comme requête contradictoire. Par exemple, un utilisateur peut poser une question concernant des commentaires négatifs sur l'entreprise ou envoyer une requête conçue pour générer des résultats dangereux ou qui ne respectent pas les règles. Si ce champ est défini sur true, nous ne générons pas de résumés pour les requêtes contradictoires et renvoyons des messages de remplacement.
ignoreNonSummarySeekingQuery

boolean

Indique s'il faut filtrer les requêtes qui ne cherchent pas à obtenir un résumé. La valeur par défaut est false.

Google utilise la classification des requêtes de recherche pour détecter les requêtes visant à obtenir un résumé. Aucun résumé n'est renvoyé si la requête de recherche est classée comme ne cherchant pas de résumé. Par exemple, why is the sky blue et Who is the best soccer player in the world? sont des requêtes de recherche de résumés, mais SFO airport et world cup 2026 ne le sont pas. Il s'agit probablement de requêtes de navigation. Si ce champ est défini sur true, nous ne générons pas de résumés pour les requêtes qui ne cherchent pas de résumés et renvoyons des messages de remplacement.
ignoreLowRelevantContent

boolean

Indique s'il faut filtrer les requêtes peu pertinentes. La valeur par défaut est false.

Si ce champ est défini sur false, tous les résultats de recherche sont utilisés pour générer des réponses, quelle que soit leur pertinence. Si cette valeur est définie sur true, seules les requêtes dont les résultats de recherche sont très pertinents généreront des réponses.
ignoreJailBreakingQuery

boolean

Facultatif. Indique s'il faut filtrer les requêtes de contournement des restrictions. La valeur par défaut est false.

Google utilise la classification des requêtes de recherche pour détecter les requêtes de contournement. Aucun résumé n'est renvoyé si la requête de recherche est classée comme une requête de contournement. Un utilisateur peut ajouter des instructions à la requête pour modifier le ton, le style, la langue ou le contenu de la réponse, ou demander au modèle d'agir en tant qu'entité différente (par exemple, "Réponds sur le ton du PDG d'une entreprise concurrente"). Si ce champ est défini sur true, nous ne générons pas de résumés pour les requêtes de contournement et renvoyons des messages de remplacement.
multimodalSpec

object (MultiModalSpec)

Facultatif. Spécification multimodale.
modelPromptSpec

object (ModelPromptSpec)

Si elle est spécifiée, la spécification sera utilisée pour modifier la requête fournie au LLM.
languageCode

string

Code de langue du résumé. Utilisez les balises de langue définies par BCP47. Remarque : Il s'agit d'une fonctionnalité expérimentale.
modelSpec

object (ModelSpec)

Si elle est spécifiée, la spécification sera utilisée pour modifier la spécification du modèle fournie au LLM.
useSemanticChunks

boolean

Si la valeur est "true", la réponse sera générée à partir des blocs les plus pertinents des meilleurs résultats de recherche. Cette fonctionnalité améliorera la qualité des résumés. Notez que si cette fonctionnalité est activée, tous les premiers résultats de recherche ne seront pas référencés ni inclus dans la liste de références. L'index des sources de citation ne pointe donc que vers les résultats de recherche figurant dans la liste de références.

MultiModalSpec

Spécification multimodale : renvoie une image à partir de la source spécifiée. Si plusieurs sources sont spécifiées, le choix est basé sur la qualité.

Représentation JSON 
{
  "imageSource": enum (ImageSource)
}
Champs
imageSource

enum (ImageSource)

Facultatif. Source de l'image renvoyée dans la réponse.

ImageSource

Spécifie la source de l'image.

Enums
IMAGE_SOURCE_UNSPECIFIED Source d'image non spécifiée (la fonctionnalité multimodale est désactivée par défaut).
ALL_AVAILABLE_SOURCES Comportement lorsque le service détermine la sélection à partir de toutes les sources disponibles.
CORPUS_IMAGE_ONLY La réponse inclut une image du corpus.
FIGURE_GENERATION_ONLY Déclenche la génération de figures dans la réponse.

ModelPromptSpec

Spécification de la requête à utiliser avec le modèle.

Représentation JSON 
{
  "preamble": string
}
Champs
preamble

string

Texte au début de la requête qui donne des instructions à l'assistant. Des exemples sont disponibles dans le guide de l'utilisateur.

ModelSpec

Spécification du modèle.

Représentation JSON 
{
  "version": string
}
Champs
version

string

Version du modèle utilisée pour générer le résumé.

Les valeurs compatibles sont :

ExtractiveContentSpec

Spécification permettant de configurer le contenu extractif dans une réponse de recherche.

Représentation JSON 
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
Champs
maxExtractiveAnswerCount

integer

Nombre maximal de réponses extractives renvoyées dans chaque résultat de recherche.

Une réponse extractive est une réponse littérale extraite du document d'origine. Elle fournit une réponse précise et pertinente par rapport au contexte de la requête de recherche.

Si le nombre de réponses correspondantes est inférieur à maxExtractiveAnswerCount, renvoyez toutes les réponses. Sinon, renvoie maxExtractiveAnswerCount.

Au maximum cinq réponses sont renvoyées pour chaque SearchResult.
maxExtractiveSegmentCount

integer

Nombre maximal de segments extractifs renvoyés dans chaque résultat de recherche. Ne s'applique que si DataStore est défini sur DataStore.ContentConfig.CONTENT_REQUIRED ou DataStore.solution_types est SOLUTION_TYPE_CHAT.

Un segment extractif est un segment de texte extrait du document d'origine qui est pertinent pour la requête de recherche et, en général, plus verbeux qu'une réponse extractive. Le segment peut ensuite être utilisé comme entrée pour les LLM afin de générer des résumés et des réponses.

Si le nombre de segments correspondants est inférieur à maxExtractiveSegmentCount, renvoyez tous les segments. Sinon, renvoie maxExtractiveSegmentCount.
returnExtractiveSegmentScore

boolean

Indique s'il faut renvoyer le score de confiance des segments extractifs dans chaque résultat de recherche. Cette fonctionnalité n'est disponible que pour les nouveaux datastores ou ceux ajoutés à la liste d'autorisation. Pour ajouter votre data store à la liste d'autorisation, contactez votre ingénieur client. La valeur par défaut est false.
numPreviousSegments

integer

Indique si les segments adjacents doivent également être inclus pour chaque segment sélectionné. Renvoie au maximum numPreviousSegments segments avant chaque segment sélectionné.
numNextSegments

integer

Renvoie au maximum numNextSegments segments après chaque segment sélectionné.

SearchResultMode

Spécifie le mode des résultats de recherche. Si aucun mode n'est spécifié, le mode de résultat de recherche est défini par défaut sur DOCUMENTS.

Enums
SEARCH_RESULT_MODE_UNSPECIFIED Valeur par défaut.
DOCUMENTS Renvoie les documents dans les résultats de recherche.
CHUNKS Renvoie des blocs dans le résultat de la recherche. Disponible uniquement si DocumentProcessingConfig.chunking_config est spécifié.

ChunkSpec

Spécifie la spécification du bloc à renvoyer à partir de la réponse de recherche. Disponible uniquement si SearchRequest.ContentSearchSpec.search_result_mode est défini sur CHUNKS

Représentation JSON 
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
Champs
numPreviousChunks

integer

Nombre de blocs précédents à renvoyer du bloc actuel. La valeur maximale autorisée est de 3. Si aucune valeur n'est spécifiée, aucun bloc précédent ne sera renvoyé.
numNextChunks

integer

Nombre de blocs suivants à renvoyer du bloc actuel. La valeur maximale autorisée est de 3. Si aucune valeur n'est spécifiée, aucun autre bloc ne sera renvoyé.