ContentSearchSpec

Una especificación para configurar el comportamiento de la búsqueda de contenido.

Representación JSON 
{
  "snippetSpec": {
    object (SnippetSpec)
  },
  "summarySpec": {
    object (SummarySpec)
  },
  "extractiveContentSpec": {
    object (ExtractiveContentSpec)
  },
  "searchResultMode": enum (SearchResultMode),
  "chunkSpec": {
    object (ChunkSpec)
  }
}
Campos
snippetSpec

object (SnippetSpec)

Si no se especifica snippetSpec, los fragmentos no se incluyen en la respuesta de búsqueda.
summarySpec

object (SummarySpec)

Si no se especifica summarySpec, los resúmenes no se incluirán en la respuesta de búsqueda.
extractiveContentSpec

object (ExtractiveContentSpec)

Si no se proporciona ningún extractiveContentSpec, no habrá ninguna respuesta extractiva en la respuesta de búsqueda.
searchResultMode

enum (SearchResultMode)

Especifica el modo de resultados de búsqueda. Si no se especifica, el modo de resultado de búsqueda predeterminado es DOCUMENTS.
chunkSpec

object (ChunkSpec)

Especifica el spec del fragmento que se devolverá en la respuesta de búsqueda. Solo disponible si SearchRequest.ContentSearchSpec.search_result_mode se define como CHUNKS

SnippetSpec

Especificación para configurar fragmentos en una respuesta de búsqueda.

Representación JSON 
{
  "maxSnippetCount": integer,
  "referenceOnly": boolean,
  "returnSnippet": boolean
}
Campos
maxSnippetCount
(deprecated)

integer

[DEPRECATED] Este campo está obsoleto. Para controlar la devolución de fragmentos, usa el campo returnSnippet. Para facilitar la compatibilidad con versiones anteriores, devolveremos el fragmento si maxSnippetCount > 0.
referenceOnly
(deprecated)

boolean

[OBSOLETO] Este campo está obsoleto y no tendrá ningún efecto en el fragmento.
returnSnippet

boolean

Si true, devuelve el fragmento. Si no se puede generar ningún fragmento, devolvemos el mensaje "No hay ningún fragmento disponible para esta página". También se devolverá un snippetStatus con SUCCESS o NO_SNIPPET_AVAILABLE.

SummarySpec

Especificación para configurar un resumen devuelto en una respuesta de búsqueda.

Representación 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
}
Campos
summaryResultCount

integer

Número de resultados principales a partir de los que se generará el resumen. Si el número de resultados devueltos es inferior a summaryResultCount, el resumen se genera a partir de todos los resultados.

Se pueden usar como máximo 10 resultados en el modo Documentos o 50 en el modo Fragmentos para generar un resumen. El modo de fragmentos se usa cuando SearchRequest.ContentSearchSpec.search_result_mode tiene el valor CHUNKS.
includeCitations

boolean

Especifica si se deben incluir citas en el resumen. El valor predeterminado es false.

Si este campo tiene el valor true, los resúmenes incluyen números de cita en el texto.

Ejemplo de resumen con citas:

BigQuery es la solución totalmente gestionada y sin servidor de Google Cloud para almacenar datos empresariales [1]. BigQuery es compatible con todos los tipos de datos, funciona en diferentes nubes y cuenta con capacidades de aprendizaje automático e inteligencia empresarial integradas en una plataforma unificada [2, 3].

Los números de cita hacen referencia a los resultados de búsqueda devueltos y están indexados a partir del 1. Por ejemplo, [1] significa que la frase se atribuye al primer resultado de búsqueda. [2, 3] significa que la frase se atribuye al segundo y al tercer resultado de búsqueda.
ignoreAdversarialQuery

boolean

Especifica si se deben filtrar las consultas adversarias. El valor predeterminado es false.

Google utiliza la clasificación de consultas de búsqueda para detectar consultas adversarias. No se devuelve ningún resumen si la consulta de búsqueda se clasifica como consulta adversarial. Por ejemplo, un usuario puede hacer una pregunta sobre comentarios negativos sobre la empresa o enviar una consulta diseñada para generar contenido no seguro que infrinja las políticas. Si este campo tiene el valor true, no generaremos resúmenes para las consultas adversarias y devolveremos mensajes alternativos.
ignoreNonSummarySeekingQuery

boolean

Especifica si se deben filtrar las consultas que no buscan un resumen. El valor predeterminado es false.

Google utiliza la clasificación de consultas de búsqueda para detectar las consultas que buscan un resumen. No se devuelve ningún resumen si la consulta de búsqueda se clasifica como una consulta que no busca un resumen. Por ejemplo, why is the sky blue y Who is the best soccer player in the world? son consultas que buscan un resumen, pero SFO airport y world cup 2026 no. Lo más probable es que sean consultas de navegación. Si este campo tiene el valor true, no generaremos resúmenes para las consultas que no busquen resúmenes y devolveremos mensajes alternativos.
ignoreLowRelevantContent

boolean

Especifica si se deben filtrar las consultas que tengan poca relevancia. El valor predeterminado es false.

Si este campo tiene el valor false, se usarán todos los resultados de búsqueda, independientemente de su relevancia, para generar respuestas. Si se define como true, solo se generarán respuestas para las consultas con resultados de búsqueda de alta relevancia.
ignoreJailBreakingQuery

boolean

Opcional. Especifica si se deben filtrar las consultas de jailbreak. El valor predeterminado es false.

Google utiliza la clasificación de consultas de búsqueda para detectar consultas de jailbreak. No se devuelve ningún resumen si la consulta de búsqueda se clasifica como una consulta de jailbreak. Un usuario puede añadir instrucciones a la consulta para cambiar el tono, el estilo, el idioma o el contenido de la respuesta, o pedirle al modelo que actúe como otra entidad. Por ejemplo, "Responde con el tono del CEO de una empresa de la competencia". Si este campo tiene el valor true, no generaremos resúmenes para las consultas de jailbreaking y devolveremos mensajes alternativos.
multimodalSpec

object (MultiModalSpec)

Opcional. Especificación multimodal.
modelPromptSpec

object (ModelPromptSpec)

Si se especifica, la especificación se usará para modificar la petición proporcionada al LLM.
languageCode

string

Código de idioma del resumen. Usa etiquetas de idioma definidas por BCP47. Nota: Esta es una función experimental.
modelSpec

object (ModelSpec)

Si se especifica, la especificación se usará para modificar la especificación del modelo proporcionada al LLM.
useSemanticChunks

boolean

Si es true, la respuesta se generará a partir de los fragmentos más relevantes de los primeros resultados de búsqueda. Esta función mejorará la calidad de los resúmenes. Ten en cuenta que, si esta función está habilitada, no se hará referencia a todos los resultados de búsqueda principales ni se incluirán en la lista de referencias, por lo que el índice de fuentes de las citas solo apunta a los resultados de búsqueda que aparecen en la lista de referencias.

MultiModalSpec

Especificación multimodal: devolverá una imagen de la fuente especificada. Si se especifican varias fuentes, la elección se basa en la calidad.

Representación JSON 
{
  "imageSource": enum (ImageSource)
}
Campos
imageSource

enum (ImageSource)

Opcional. Fuente de la imagen devuelta en la respuesta.

ImageSource

Especifica la fuente de la imagen.

Enumeraciones
IMAGE_SOURCE_UNSPECIFIED Fuente de imagen no especificada (la función multimodal está inhabilitada de forma predeterminada).
ALL_AVAILABLE_SOURCES Comportamiento cuando el servicio determina la selección de todas las fuentes disponibles.
CORPUS_IMAGE_ONLY Incluye una imagen del corpus en la respuesta.
FIGURE_GENERATION_ONLY Activa la generación de cifras en la respuesta.

ModelPromptSpec

Especificación de la petición que se va a usar con el modelo.

Representación JSON 
{
  "preamble": string
}
Campos
preamble

string

Texto al principio de la petición que da instrucciones al asistente. Puede consultar ejemplos en la guía del usuario.

ModelSpec

Especificación del modelo.

Representación JSON 
{
  "version": string
}
Campos
version

string

Versión del modelo que se ha usado para generar el resumen.

Los valores admitidos son:

ExtractiveContentSpec

Especificación para configurar el contenido extractivo en una respuesta de búsqueda.

Representación JSON 
{
  "maxExtractiveAnswerCount": integer,
  "maxExtractiveSegmentCount": integer,
  "returnExtractiveSegmentScore": boolean,
  "numPreviousSegments": integer,
  "numNextSegments": integer
}
Campos
maxExtractiveAnswerCount

integer

Número máximo de respuestas extractivas devueltas en cada resultado de búsqueda.

Una respuesta extractiva es una respuesta literal extraída del documento original, que proporciona una respuesta precisa y pertinente para el contexto de la consulta de búsqueda.

Si el número de respuestas coincidentes es inferior al maxExtractiveAnswerCount, devuelve todas las respuestas. De lo contrario, devuelve maxExtractiveAnswerCount.

Se devuelven como máximo cinco respuestas por cada SearchResult.
maxExtractiveSegmentCount

integer

Número máximo de segmentos extractivos devueltos en cada resultado de búsqueda. Solo se aplica si DataStore se define como DataStore.ContentConfig.CONTENT_REQUIRED o DataStore.solution_types es SOLUTION_TYPE_CHAT.

Un segmento extractivo es un segmento de texto extraído del documento original que es relevante para la consulta de búsqueda y, por lo general, más extenso que una respuesta extractiva. El segmento se podría usar como entrada para que los LLMs generen resúmenes y respuestas.

Si el número de segmentos coincidentes es inferior a maxExtractiveSegmentCount, devuelve todos los segmentos. De lo contrario, devuelve maxExtractiveSegmentCount.
returnExtractiveSegmentScore

boolean

Especifica si se debe devolver la puntuación de confianza de los segmentos extractivos de cada resultado de búsqueda. Esta función solo está disponible para los nuevos almacenes de datos o los que se hayan añadido a la lista de permitidos. Para incluir en la lista de permitidos tu almacén de datos, ponte en contacto con tu ingeniero de atención al cliente. El valor predeterminado es false.
numPreviousSegments

integer

Especifica si también se deben incluir los segmentos adyacentes de cada segmento seleccionado. Devuelve como máximo numPreviousSegments segmentos antes de cada segmento seleccionado.
numNextSegments

integer

Devuelve un máximo de numNextSegments segmentos después de cada segmento seleccionado.

SearchResultMode

Especifica el modo de resultados de búsqueda. Si no se especifica, el modo de resultado de búsqueda predeterminado es DOCUMENTS.

Enumeraciones
SEARCH_RESULT_MODE_UNSPECIFIED Valor predeterminado.
DOCUMENTS Devuelve los documentos de los resultados de búsqueda.
CHUNKS Devuelve fragmentos en el resultado de búsqueda. Solo está disponible si se especifica DocumentProcessingConfig.chunking_config.

ChunkSpec

Especifica el spec del fragmento que se devolverá en la respuesta de búsqueda. Solo disponible si SearchRequest.ContentSearchSpec.search_result_mode se define como CHUNKS

Representación JSON 
{
  "numPreviousChunks": integer,
  "numNextChunks": integer
}
Campos
numPreviousChunks

integer

Número de fragmentos anteriores que se van a devolver del fragmento actual. El valor máximo permitido es 3. Si no se especifica, no se devolverá ningún fragmento anterior.
numNextChunks

integer

Número de los siguientes fragmentos que se van a devolver del fragmento actual. El valor máximo permitido es 3. Si no se especifica, no se devolverán más fragmentos.