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,
  "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.

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.

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: