SummarySpec

Uma especificação para configurar um resumo retornado em uma resposta de pesquisa.

Representação 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

O número dos principais resultados para gerar o resumo. Se o número de resultados retornados for menor que summaryResultCount, o resumo será gerado com base em todos os resultados.

É possível usar no máximo 10 resultados no modo de documentos ou 50 no modo de partes para gerar um resumo. O modo de partes é usado quando SearchRequest.ContentSearchSpec.search_result_mode é definido como CHUNKS.

includeCitations

boolean

Especifica se as citações devem ser incluídas no resumo. O valor padrão é false.

Quando esse campo é definido como true, os resumos incluem números de citação inline.

Exemplo de resumo com citações:

O BigQuery é o data warehouse corporativo totalmente gerenciado e sem servidor do Google Cloud [1]. O BigQuery oferece suporte a todos os tipos de dados, funciona em diferentes nuvens e tem machine learning e Business Intelligence integrados, tudo em uma plataforma unificada [2, 3].

Os números de citação se referem aos resultados da pesquisa retornados e são indexados de 1 a 1. Por exemplo, [1] significa que a frase é atribuída ao primeiro resultado da pesquisa. [2, 3] significa que a frase é atribuída ao segundo e ao terceiro resultados da pesquisa.

ignoreAdversarialQuery

boolean

Especifica se as consultas adversárias devem ser filtradas. O valor padrão é false.

O Google usa a classificação de consultas de pesquisa para detectar consultas adversárias. Nenhum resumo é retornado se a consulta de pesquisa for classificada como adversária. Por exemplo, um usuário pode fazer uma pergunta sobre comentários negativos sobre a empresa ou enviar uma consulta projetada para gerar uma saída não segura que viola a política. Se esse campo for definido como true, vamos pular a geração de resumos para consultas adversárias e retornar mensagens alternativas.

ignoreNonSummarySeekingQuery

boolean

Especifica se é necessário filtrar consultas que não buscam um resumo. O valor padrão é false.

O Google usa a classificação de consultas de pesquisa para detectar consultas que buscam resumos. Nenhum resumo é retornado se a consulta de pesquisa for classificada como uma consulta que não busca resumos. Por exemplo, why is the sky blue e Who is the best soccer player in the world? são consultas que buscam um resumo, mas SFO airport e world cup 2026 não são. Provavelmente são consultas de navegação. Se este campo estiver definido como true, vamos pular a geração de resumos para consultas que não buscam resumos e retornar mensagens alternativas.

ignoreLowRelevantContent

boolean

Especifica se as consultas de baixa relevância devem ser filtradas. O valor padrão é false.

Se esse campo for definido como false, todos os resultados da pesquisa serão usados, independente da relevância, para gerar respostas. Se definido como true, apenas consultas com resultados de pesquisa de alta relevância vão gerar respostas.

ignoreJailBreakingQuery

boolean

Opcional. Especifica se as consultas de jailbreak devem ser filtradas. O valor padrão é false.

O Google usa a classificação de consultas de pesquisa para detectar consultas de jailbreak. Nenhum resumo é retornado se a consulta de pesquisa for classificada como uma consulta de jailbreak. Um usuário pode adicionar instruções à consulta para mudar o tom, o estilo, o idioma, o conteúdo da resposta ou pedir que o modelo aja como uma entidade diferente, por exemplo, "Responda no tom de um CEO de uma empresa concorrente". Se esse campo for definido como true, vamos pular a geração de resumos para consultas de jailbreak e retornar mensagens alternativas.

modelPromptSpec

object (ModelPromptSpec)

Se especificado, a especificação será usada para modificar o comando fornecido ao LLM.

languageCode

string

Código do idioma do resumo. Use tags de idioma definidas pelo BCP47 (em inglês). Observação: este é um recurso experimental.

modelSpec

object (ModelSpec)

Se especificado, ele será usado para modificar a especificação do modelo fornecida ao LLM.

useSemanticChunks

boolean

Se for "true", a resposta será gerada com base nos trechos mais relevantes dos principais resultados da pesquisa. Esse recurso vai melhorar a qualidade do resumo. Com esse recurso ativado, nem todos os principais resultados da pesquisa serão referenciados e incluídos na lista de referências. Portanto, o índice de origem da citação aponta apenas para os resultados da pesquisa listados na lista de referências.

ModelPromptSpec

Especificação do comando a ser usado com o modelo.

Representação JSON
{
  "preamble": string
}
Campos
preamble

string

Texto no início do comando que instrui o assistente. Exemplos estão disponíveis no guia do usuário.

ModelSpec

Especificação do modelo.

Representação JSON
{
  "version": string
}
Campos
version

string

A versão do modelo usada para gerar o resumo.

Os valores aceitos são: