SummarySpec

Uma especificação para configurar um resumo devolvido numa 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 de principais resultados a partir dos quais gerar o resumo. Se o número de resultados devolvidos for inferior a summaryResultCount, o resumo é gerado a partir de todos os resultados.

Podem ser usados, no máximo, 10 resultados para o modo de documentos ou 50 para o modo de fragmentos para gerar um resumo. O modo de fragmentos é usado quando SearchRequest.ContentSearchSpec.search_result_mode está definido como CHUNKS.
includeCitations

boolean

Especifica se devem ser incluídas citações no resumo. O valor predefinido é false.

Quando este campo está definido como true, os resumos incluem números de citações inline.

Exemplo de resumo com citações:

O BigQuery é o armazém de dados empresarial totalmente gerido e completamente sem servidor da Google Cloud [1]. O BigQuery suporta todos os tipos de dados, funciona em várias nuvens e tem aprendizagem automática e Business Intelligence incorporadas, tudo numa plataforma unificada [2, 3].

Os números das citações referem-se aos resultados da pesquisa devolvidos e são indexados 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 terceiro resultados da pesquisa.
ignoreAdversarialQuery

boolean

Especifica se as consultas adversariais devem ser filtradas. O valor predefinido é false.

A Google usa a classificação de consultas de pesquisa para detetar consultas adversariais. Não é devolvido nenhum resumo se a consulta de pesquisa for classificada como uma consulta adversária. Por exemplo, um utilizador pode fazer uma pergunta sobre comentários negativos acerca da empresa ou enviar uma consulta concebida para gerar resultados inseguros que violem as políticas. Se este campo estiver definido como true, ignoramos a geração de resumos para consultas adversariais e devolvemos mensagens alternativas.
ignoreNonSummarySeekingQuery

boolean

Especifica se devem ser filtradas consultas que não procuram resumos. O valor predefinido é false.

A Google usa a classificação de consultas de pesquisa para detetar consultas que procuram resumos. Não é devolvido nenhum resumo se a consulta de pesquisa for classificada como uma consulta que não procura resumos. Por exemplo, why is the sky blue e Who is the best soccer player in the world? são consultas que procuram resumos, mas SFO airport e world cup 2026 não. São, muito provavelmente, consultas de navegação. Se este campo estiver definido como true, ignoramos a geração de resumos para consultas que não procuram resumos e devolvemos mensagens alternativas.
ignoreLowRelevantContent

boolean

Especifica se devem ser filtradas consultas com baixa relevância. O valor predefinido é false.

Se este campo estiver definido como false, todos os resultados da pesquisa são usados, independentemente da relevância, para gerar respostas. Se estiver definido como true, apenas as consultas com resultados da pesquisa de alta relevância geram respostas.
ignoreJailBreakingQuery

boolean

Opcional. Especifica se as consultas de jailbreak devem ser filtradas. O valor predefinido é false.

A Google usa a classificação de consultas de pesquisa para detetar consultas de jailbreak. Não é devolvido nenhum resumo se a consulta de pesquisa for classificada como uma consulta de jailbreak. Um utilizador pode adicionar instruções à consulta para alterar o tom, o estilo, o idioma, o conteúdo da resposta ou pedir ao modelo para agir como uma entidade diferente, por exemplo, "Responde no tom do CEO de uma empresa concorrente". Se este campo estiver definido como true, ignoramos a geração de resumos para consultas de jailbreak e devolvemos mensagens alternativas.
modelPromptSpec

object (ModelPromptSpec)

Se for especificado, a especificação é usada para modificar o comando fornecido ao MDG.
languageCode

string

Código do idioma para o resumo. Use etiquetas de idioma definidas pela norma BCP47. Nota: esta é uma funcionalidade experimental.
modelSpec

object (ModelSpec)

Se for especificado, a especificação é usada para modificar a especificação do modelo fornecida ao MDG.
useSemanticChunks

boolean

Se for verdadeiro, a resposta é gerada a partir dos fragmentos mais relevantes dos principais resultados da pesquisa. Esta funcionalidade melhora a qualidade dos resumos. Tenha em atenção que, com esta funcionalidade ativada, nem todos os principais resultados da pesquisa são referenciados e incluídos na lista de referências. Por isso, o índice da fonte de citação aponta apenas para os resultados da pesquisa apresentados na lista de referências.

ModelPromptSpec

Especificação do comando a usar com o modelo.

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

string

Texto no início do comando que dá instruções ao assistente. Estão disponíveis exemplos no guia do utilizador.

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 suportados são: