Reference documentation and code samples for the Discovery Engine V1 API class Google::Cloud::DiscoveryEngine::V1::SearchRequest::ContentSearchSpec::SummarySpec.
A specification for configuring a summary returned in a search response.
Inherits
- Object
Extended By
- Google::Protobuf::MessageExts::ClassMethods
Includes
- Google::Protobuf::MessageExts
Methods
#ignore_adversarial_query
def ignore_adversarial_query() -> ::Boolean
-
(::Boolean) — Specifies whether to filter out adversarial queries. The default value
is
false
.Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to
true
, we skip generating summaries for adversarial queries and return fallback messages instead.
#ignore_adversarial_query=
def ignore_adversarial_query=(value) -> ::Boolean
-
value (::Boolean) — Specifies whether to filter out adversarial queries. The default value
is
false
.Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to
true
, we skip generating summaries for adversarial queries and return fallback messages instead.
-
(::Boolean) — Specifies whether to filter out adversarial queries. The default value
is
false
.Google employs search-query classification to detect adversarial queries. No summary is returned if the search query is classified as an adversarial query. For example, a user might ask a question regarding negative comments about the company or submit a query designed to generate unsafe, policy-violating output. If this field is set to
true
, we skip generating summaries for adversarial queries and return fallback messages instead.
#ignore_non_summary_seeking_query
def ignore_non_summary_seeking_query() -> ::Boolean
-
(::Boolean) — Specifies whether to filter out queries that are not summary-seeking.
The default value is
false
.Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example,
why is the sky blue
andWho is the best soccer player in the world?
are summary-seeking queries, butSFO airport
andworld cup 2026
are not. They are most likely navigational queries. If this field is set totrue
, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
#ignore_non_summary_seeking_query=
def ignore_non_summary_seeking_query=(value) -> ::Boolean
-
value (::Boolean) — Specifies whether to filter out queries that are not summary-seeking.
The default value is
false
.Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example,
why is the sky blue
andWho is the best soccer player in the world?
are summary-seeking queries, butSFO airport
andworld cup 2026
are not. They are most likely navigational queries. If this field is set totrue
, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
-
(::Boolean) — Specifies whether to filter out queries that are not summary-seeking.
The default value is
false
.Google employs search-query classification to detect summary-seeking queries. No summary is returned if the search query is classified as a non-summary seeking query. For example,
why is the sky blue
andWho is the best soccer player in the world?
are summary-seeking queries, butSFO airport
andworld cup 2026
are not. They are most likely navigational queries. If this field is set totrue
, we skip generating summaries for non-summary seeking queries and return fallback messages instead.
#include_citations
def include_citations() -> ::Boolean
-
(::Boolean) — Specifies whether to include citations in the summary. The default
value is
false
.When this field is set to
true
, summaries include in-line citation numbers.Example summary including citations:
BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3].
The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
#include_citations=
def include_citations=(value) -> ::Boolean
-
value (::Boolean) — Specifies whether to include citations in the summary. The default
value is
false
.When this field is set to
true
, summaries include in-line citation numbers.Example summary including citations:
BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3].
The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
-
(::Boolean) — Specifies whether to include citations in the summary. The default
value is
false
.When this field is set to
true
, summaries include in-line citation numbers.Example summary including citations:
BigQuery is Google Cloud's fully managed and completely serverless enterprise data warehouse [1]. BigQuery supports all data types, works across clouds, and has built-in machine learning and business intelligence, all within a unified platform [2, 3].
The citation numbers refer to the returned search results and are 1-indexed. For example, [1] means that the sentence is attributed to the first search result. [2, 3] means that the sentence is attributed to both the second and third search results.
#language_code
def language_code() -> ::String
- (::String) — Language code for Summary. Use language tags defined by [BCP47][https://www.rfc-editor.org/rfc/bcp/bcp47.txt].
#language_code=
def language_code=(value) -> ::String
- value (::String) — Language code for Summary. Use language tags defined by [BCP47][https://www.rfc-editor.org/rfc/bcp/bcp47.txt].
- (::String) — Language code for Summary. Use language tags defined by [BCP47][https://www.rfc-editor.org/rfc/bcp/bcp47.txt].
#summary_result_count
def summary_result_count() -> ::Integer
-
(::Integer) — The number of top results to generate the summary from. If the number
of results returned is less than
summaryResultCount
, the summary is generated from all of the results.At most five results can be used to generate a summary.
#summary_result_count=
def summary_result_count=(value) -> ::Integer
-
value (::Integer) — The number of top results to generate the summary from. If the number
of results returned is less than
summaryResultCount
, the summary is generated from all of the results.At most five results can be used to generate a summary.
-
(::Integer) — The number of top results to generate the summary from. If the number
of results returned is less than
summaryResultCount
, the summary is generated from all of the results.At most five results can be used to generate a summary.