google.ai.generativelanguage.QueryCorpusRequest

Request for querying a Corpus.

name str

Required. The name of the Corpus to query. Example: corpora/my-corpus-123

query str

Required. Query string to perform semantic search.

metadata_filters MutableSequence[google.ai.generativelanguage.MetadataFilter]

Optional. Filter for Chunk and Document metadata. Each MetadataFilter object should correspond to a unique key. Multiple MetadataFilter objects are joined by logical "AND"s.

Example query at document level: (year >= 2020 OR year < 2010) AND (genre = drama OR genre = action)

MetadataFilter object list: metadata_filters = [ {key = "document.custom_metadata.year" conditions = [{int_value = 2020, operation = GREATER_EQUAL}, {int_value = 2010, operation = LESS}]}, {key = "document.custom_metadata.year" conditions = [{int_value = 2020, operation = GREATER_EQUAL}, {int_value = 2010, operation = LESS}]}, {key = "document.custom_metadata.genre" conditions = [{string_value = "drama", operation = EQUAL}, {string_value = "action", operation = EQUAL}]}]

Example query at chunk level for a numeric range of values: (year > 2015 AND year <= 2020)

MetadataFilter object list: metadata_filters = [ {key = "chunk.custom_metadata.year" conditions = [{int_value = 2015, operation = GREATER}]}, {key = "chunk.custom_metadata.year" conditions = [{int_value = 2020, operation = LESS_EQUAL}]}]

results_count int

Optional. The maximum number of Chunk\ s to return. The service may return fewer Chunk\ s.

If unspecified, at most 10 Chunk\ s will be returned. The maximum specified result count is 100.