SummarySpec

用于配置搜索响应中返回的摘要的规范。

JSON 表示法 
{
  "summaryResultCount": integer,
  "includeCitations": boolean,
  "ignoreAdversarialQuery": boolean,
  "ignoreNonSummarySeekingQuery": boolean,
  "ignoreLowRelevantContent": boolean,
  "ignoreJailBreakingQuery": boolean,
  "modelPromptSpec": {
    object (ModelPromptSpec)
  },
  "languageCode": string,
  "modelSpec": {
    object (ModelSpec)
  },
  "useSemanticChunks": boolean
}
字段
summaryResultCount

integer

用于生成摘要的热门结果数量。如果返回的结果数量少于 summaryResultCount，则系统会根据所有结果生成摘要。

最多可以使用 10 个文档模式的结果或 50 个块模式的结果来生成摘要。当 SearchRequest.ContentSearchSpec.search_result_mode 设置为 CHUNKS 时，系统会使用块模式。
includeCitations

boolean

指定是否在摘要中包含引用。默认值为 false。

如果此字段设置为 true，摘要将包含内嵌引用编号。

包含引文的摘要示例：

BigQuery 是 Google Cloud 的全代管式无服务器企业数据仓库 [1]。BigQuery 支持所有类型的数据，可在多种云环境上运行，并在统一平台中内置了丰富的机器学习和商业智能功能 [2, 3]。

引用编号是指返回的搜索结果，从 1 开始编入索引。例如，[1] 表示相应句子归因于第一个搜索结果。[2, 3] 表示相应句子归因于第二个和第三个搜索结果。
ignoreAdversarialQuery

boolean

指定是否过滤掉对抗性查询。默认值为 false。

Google 采用搜索查询分类来检测对抗性查询。如果搜索查询被归类为对抗性查询，则不会返回摘要。例如，用户可能会询问有关公司负面评论的问题，或者提交旨在生成不安全且违反政策的输出内容的查询。如果此字段设置为 true，我们会跳过为对抗性查询生成摘要，而是返回后备消息。
ignoreNonSummarySeekingQuery

boolean

指定是否过滤掉非总结性查询。默认值为 false。

Google 采用搜索查询分类技术来检测寻求摘要的查询。如果搜索查询被归类为非摘要寻求查询，则不会返回摘要。例如，why is the sky blue 和 Who is the best soccer player in the world? 是寻求摘要的查询，但 SFO airport 和 world cup 2026 不是。它们很可能是导航查询。如果此字段设置为 true，我们会跳过为非总结寻求查询生成总结，而是返回回退消息。
ignoreLowRelevantContent

boolean

指定是否过滤掉相关性较低的查询。默认值为 false。

如果此字段设置为 false，则无论搜索结果的相关性如何，都会使用所有搜索结果来生成答案。如果设置为 true，只有搜索结果相关性较高的查询才会生成回答。
ignoreJailBreakingQuery

boolean

可选。指定是否过滤掉越狱查询。默认值为 false。

Google 采用搜索查询分类来检测越狱查询。如果搜索查询被归类为越狱查询，则不会返回摘要。用户可能会在查询中添加指令，以更改回答的语气、风格、语言、内容，或要求模型扮演其他实体，例如“以竞争对手公司 CEO 的语气回答”。如果此字段设置为 true，我们会跳过为越狱查询生成摘要，而是返回回退消息。
modelPromptSpec

object (ModelPromptSpec)

如果指定，则使用规范来修改提供给 LLM 的提示。
languageCode

string

摘要的语言代码。使用 BCP47 定义的语言标记。注意：这是一项实验性功能。
modelSpec

object (ModelSpec)

如果指定了该参数，则该规范将用于修改提供给 LLM 的模型规范。
useSemanticChunks

boolean

如果为 true，则会根据热门搜索结果中最相关的块生成回答。此功能将有助于提高摘要质量。请注意，启用此功能后，并非所有热门搜索结果都会被引用并包含在参考列表中，因此引用来源索引仅指向参考列表中列出的搜索结果。

ModelPromptSpec

要与模型搭配使用的提示的规范。

JSON 表示法 
{
  "preamble": string
}
字段
preamble

string

提示开头用于指示助理的文本。用户指南中提供了示例。

ModelSpec

模型的规范。

JSON 表示法 
{
  "version": string
}
字段
version

string

用于生成摘要的模型版本。

支持的值包括：