ContentSearchSpec

Es 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 incluirán en la respuesta de la búsqueda.
summarySpec

object (SummarySpec)

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

object (ExtractiveContentSpec)

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

enum (SearchResultMode)

Especifica el modo de resultado de la búsqueda. Si no se especifica, el modo de resultado de la búsqueda se establece de forma predeterminada como DOCUMENTS.
chunkSpec

object (ChunkSpec)

Especifica el objeto ChunkSpec que se devolverá en la respuesta de búsqueda. Solo está disponible si SearchRequest.ContentSearchSpec.search_result_mode se establece como CHUNKS.

SnippetSpec

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

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

integer

[OBSOLETO] Este campo ya no está disponible. Para controlar la devolución de fragmentos, usa el campo returnSnippet. Para la retrocompatibilidad, mostraremos el fragmento si maxSnippetCount > 0.
referenceOnly
(deprecated)

boolean

[EN DESUSO] Este campo está en desuso y no tendrá ningún efecto en el fragmento.
returnSnippet

boolean

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

SummarySpec

Es una especificación para configurar un resumen que se muestra 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

Cantidad de resultados principales a partir de los que se generará el resumen. Si la cantidad de resultados que se muestran es menor que summaryResultCount, el resumen se genera a partir de todos los resultados.

Se pueden usar hasta 10 resultados para el modo de documentos o 50 para el modo de fragmentos para generar un resumen. El modo de fragmentos se usa cuando SearchRequest.ContentSearchSpec.search_result_mode se establece en CHUNKS.
includeCitations

boolean

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

Cuando este campo se establece en true, los resúmenes incluyen números de citas intercalados.

Ejemplo de resumen con citas:

BigQuery es el almacén de datos empresarial completamente administrado y sin servidores de Google Cloud [1]. BigQuery es compatible con todos los tipos de datos, funciona en todas las nubes y cuenta con inteligencia empresarial y aprendizaje automático integrados, todo en una plataforma unificada [2, 3].

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

boolean

Especifica si se deben filtrar las búsquedas adversarias. El valor predeterminado es false.

Google emplea la clasificación de búsquedas para detectar las búsquedas adversarias. No se devuelve ningún resumen si la búsqueda se clasifica como una búsqueda adversarial. Por ejemplo, un usuario puede hacer una pregunta sobre comentarios negativos sobre la empresa o enviar una búsqueda diseñada para generar resultados inseguros que incumplan las políticas. Si este campo se establece en true, omitimos la generación de resúmenes para las búsquedas adversariales y, en su lugar, devolvemos mensajes de resguardo.
ignoreNonSummarySeekingQuery

boolean

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

Google emplea la clasificación de búsquedas para detectar las búsquedas que buscan resúmenes. No se devuelve ningún resumen si la búsqueda se clasifica como una búsqueda que no busca un resumen. Por ejemplo, why is the sky blue y Who is the best soccer player in the world? son búsquedas de resumen, pero SFO airport y world cup 2026 no lo son. Es muy probable que sean búsquedas de navegación. Si este campo se establece en true, omitimos la generación de resúmenes para las búsquedas que no son de resumen y, en su lugar, devolvemos mensajes de resguardo.
ignoreLowRelevantContent

boolean

Especifica si se deben filtrar las búsquedas que tienen baja relevancia. El valor predeterminado es false.

Si este campo se establece en false, se usarán todos los resultados de la búsqueda, independientemente de su relevancia, para generar respuestas. Si se configura como true, solo las búsquedas con resultados de alta relevancia generarán respuestas.
ignoreJailBreakingQuery

boolean

Opcional. Especifica si se deben filtrar las preguntas que intentan evadir las restricciones. El valor predeterminado es false.

Google emplea la clasificación de búsquedas para detectar las búsquedas que intentan eludir las restricciones. No se devuelve ningún resumen si la búsqueda se clasifica como una búsqueda de evasión de restricciones. Un usuario puede agregar instrucciones a la búsqueda para cambiar el tono, el estilo, el idioma o el contenido de la respuesta, o bien pedirle al modelo que actúe como una entidad diferente, p.ej., "Responde con el tono del CEO de una empresa de la competencia". Si este campo se establece en true, omitimos la generación de resúmenes para las búsquedas de evasión de restricciones y, en su lugar, devolvemos mensajes de resguardo.
multimodalSpec

object (MultiModalSpec)

Opcional. Especificación multimodal.
modelPromptSpec

object (ModelPromptSpec)

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

string

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

object (ModelSpec)

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

boolean

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

MultiModalSpec

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

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

enum (ImageSource)

Opcional. Es la fuente de la imagen que se muestra en la respuesta.

ImageSource

Especifica la fuente de la imagen.

Enums
IMAGE_SOURCE_UNSPECIFIED No se especificó la fuente de la imagen (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 figuras en la respuesta.

ModelPromptSpec

Es la especificación de la instrucción para usar con el modelo.

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

string

Es el texto al comienzo de la instrucción que le indica al asistente qué hacer. En la guía del usuario, se incluyen ejemplos.

ModelSpec

Es la especificación del modelo.

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

string

Es la versión del modelo que se usó para generar el resumen.

Los valores admitidos son los que se detallan a continuación:

ExtractiveContentSpec

Es una 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

Es la cantidad máxima de respuestas extractivas que se muestran en cada resultado de la búsqueda.

Una respuesta extractiva es una respuesta textual extraída del documento original, que proporciona una respuesta precisa y pertinente a nivel contextual para la búsqueda.

Si la cantidad de respuestas coincidentes es menor que maxExtractiveAnswerCount, devuelve todas las respuestas. De lo contrario, devuelve maxExtractiveAnswerCount.

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

integer

Es la cantidad máxima de segmentos extractivos que se muestran en cada resultado de la búsqueda. Solo se aplica si DataStore se configura 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 pertinente para la búsqueda y, en general, más detallado que una respuesta extractiva. Luego, el segmento se podría usar como entrada para que los LLMs generen resúmenes y respuestas.

Si la cantidad de segmentos coincidentes es menor que maxExtractiveSegmentCount, se devuelven todos los segmentos. De lo contrario, devuelve maxExtractiveSegmentCount.
returnExtractiveSegmentScore

boolean

Especifica si se debe devolver la puntuación de confianza de los segmentos extractivos en cada resultado de la búsqueda. Esta función solo está disponible para los almacenes de datos nuevos o incluidos en la lista de entidades permitidas. Para incluir tu almacén de datos en la lista de entidades permitidas, comunícate con tu ingeniero de atención al cliente. El valor predeterminado es false.
numPreviousSegments

integer

Especifica si también se debe incluir el tramo adyacente de cada segmento seleccionado. Devuelve un máximo de 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 resultado de la búsqueda. Si no se especifica, el modo de resultado de la búsqueda se establece de forma predeterminada como DOCUMENTS.

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

ChunkSpec

Especifica el objeto ChunkSpec que se devolverá en la respuesta de búsqueda. Solo está disponible si SearchRequest.ContentSearchSpec.search_result_mode se establece como CHUNKS.

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

integer

Es la cantidad de fragmentos anteriores del fragmento actual que se devolverán. El valor máximo permitido es 3. Si no se especifica, no se devolverán fragmentos anteriores.
numNextChunks

integer

Es la cantidad de fragmentos siguientes que se devolverán del fragmento actual. El valor máximo permitido es 3. Si no se especifica, no se devolverán los próximos fragmentos.