Immutable. Identifier. The server-generated resource name of the cached content Format: projects/{project}/locations/{location}/cachedContents/{cachedContent}

Optional. Immutable. The user-generated meaningful display name of the cached content.

Immutable. The name of theModel to use for cached content. Currently, only the published Gemini base models are supported, in form of projects/{PROJECT}/locations/{LOCATION}/publishers/google/models/{MODEL}

Optional. Input only. Immutable. Developer set system instruction. Currently, text only

Optional. Input only. Immutable. The content to cache

Optional. Input only. Immutable. A list ofTools the model may use to generate the next response

Optional. Input only. Immutable. Tool config. This config is shared for all tools

Output only. Creation time of the cache entry.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z" or"2014-10-02T15:01:23+05:30".

Output only. When the cache entry was last updated in UTC time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples:"2014-10-02T15:01:23Z","2014-10-02T15:01:23.045123456Z" or"2014-10-02T15:01:23+05:30".

Output only. metadata on the usage of the cached content.

Input only. Immutable. Customer-managed encryption key spec for aCachedContent. If set, thisCachedContent and all its sub-resources will be secured by this key.

Optional. Function tool type. One or more function declarations to be passed to the model along with the current user query. Model may decide to call a subset of these functions by populatingFunctionCall in the response. user should provide aFunctionResponse for each function call in the next turn. Based on the function responses, Model will generate the final response back to the user. Maximum 512 function declarations can be provided.

Optional. Retrieval tool type. System will always execute the provided retrieval tool(s) to get external knowledge to answer the prompt. Retrieval results are presented to the model for generation.

Optional. GoogleSearch tool type. Tool to support Google Search in Model. Powered by Google.

Optional. GoogleMaps tool type. Tool to support Google Maps in Model.

Optional. Tool to support searching public web data, powered by Vertex AI Search and Sec4 compliance.

Optional. CodeExecution tool type. Enables the model to execute code as part of generation.

Optional. Tool to support URL context retrieval.

Optional. Tool to support the model interacting directly with the computer. If enabled, it automatically populates computer-use specific Function Declarations.

Required. The name of the function to call. Must start with a letter or an underscore. Must be a-z, A-Z, 0-9, or contain underscores, dots, colons and dashes, with a maximum length of 64.

Optional. description and purpose of the function. Model uses it to decide how and whether to call the function.

Optional. Describes the parameters to this function in JSON Schema Object format. Reflects the Open API 3.03 Parameter Object. string Key: the name of the parameter. Parameter names are case sensitive. Schema value: the Schema defining the type used for the parameter. For function with no parameters, this can be left unset. Parameter names must start with a letter or an underscore and must only contain chars a-z, A-Z, 0-9, or underscores with a maximum length of 64. Example with 1 required and 1 optional parameter: type: OBJECT properties: param1: type: STRING param2: type: INTEGER required: - param1

Optional. Describes the parameters to the function in JSON Schema format. The schema must describe an object where the properties are the parameters to the function. For example:

{  "type": "object",  "properties": {    "name": { "type": "string" },    "age": { "type": "integer" }  },  "additionalProperties": false,  "required": ["name", "age"],  "propertyOrdering": ["name", "age"]}

This field is mutually exclusive withparameters.

Optional. Describes the output from this function in JSON Schema format. Reflects the Open API 3.03 Response Object. The Schema defines the type used for the response value of the function.

Optional. Describes the output from this function in JSON Schema format. The value specified by the schema is the response value of the function.

This field is mutually exclusive withresponse.

Optional. The type of the data.

Optional. The format of the data. Supported formats: for NUMBER type: "float", "double" for INTEGER type: "int32", "int64" for STRING type: "email", "byte", etc

Optional. The title of the Schema.

Optional. The description of the data.

Optional. Indicates if the value may be null.

Optional. Default value of the data.

Optional. SCHEMA FIELDS FOR TYPE ARRAY Schema of the elements of type.ARRAY.

Optional. Minimum number of the elements for type.ARRAY.

Optional. Maximum number of the elements for type.ARRAY.

Optional. Possible values of the element of primitive type with enum format. Examples: 1. We can define direction as : {type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]} 2. We can define apartment number as : {type:INTEGER, format:enum, enum:["101", "201", "301"]}

Optional. SCHEMA FIELDS FOR TYPE OBJECT Properties of type.OBJECT.

Optional. The order of the properties. Not a standard field in open api spec. Only used to support the order of the properties.

Optional. Required properties of type.OBJECT.

Optional. Minimum number of the properties for type.OBJECT.

Optional. Maximum number of the properties for type.OBJECT.

Optional. SCHEMA FIELDS FOR TYPE INTEGER and NUMBER Minimum value of the type.INTEGER and type.NUMBER

Optional. Maximum value of the type.INTEGER and type.NUMBER

Optional. SCHEMA FIELDS FOR TYPE STRING Minimum length of the type.STRING

Optional. Maximum length of the type.STRING

Optional. Pattern of the type.STRING to restrict a string to a regular expression.

Optional. Example of the object. Will only populated when the object is the root.

Optional. The value should be validated against any (one or more) of the subschemas in the list.

Optional. Can either be a boolean or an object; controls the presence of additional properties.

Optional. Allows indirect references between schema nodes. The value should be a valid reference to a child of the rootdefs.

For example, the following schema defines a reference to a schema node named "Pet":

type: object properties: pet: ref: #/defs/Pet defs: Pet: type: object properties: name: type: string

The value of the "pet" property is a reference to the schema node named "Pet". See details inhttps://json-schema.org/understanding-json-schema/structuring

Optional. A map of definitions for use byref Only allowed at the root of the schema.

Optional. Fully-qualified Vertex AI Search data store resource id. Format:projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

Optional. Fully-qualified Vertex AI Search engine resource id. Format:projects/{project}/locations/{location}/collections/{collection}/engines/{engine}

Optional. Number of search results to return per query. The default value is 10. The maximumm allowed value is 10.

Optional. Filter strings to be passed to the search API.

Specifications that define the specific DataStores to be searched, along with configurations for those data stores. This is only considered for Engines with multiple data stores. It should only be set if engine is used.

Full resource name of DataStore, such as Format:projects/{project}/locations/{location}/collections/{collection}/dataStores/{dataStore}

Optional. Filter specification to filter documents in the data store specified by dataStore field. For more information on filtering, seeFiltering

Optional. The representation of the rag source. It can be used to specify corpus only or ragfiles. Currently only support one corpus or multiple files from one corpus. In the future we may open up multiple corpora support.

Optional. The retrieval config for the Rag query.

Optional. Config for filters.

Optional. Config for ranking and reranking.

Optional. String for metadata filtering.

Optional. The model name of the rank service. Format:semantic-ranker-512@latest

Optional. The model name used for ranking. SeeSupported models.

Optional. List of domains to be excluded from the search results. The default limit is 2000 domains. Example: ["amazon.com", "facebook.com"].

Optional. Sites with confidence level chosen & above this value will be blocked from the search results.

Specifies the dynamic retrieval configuration for the given source.

The mode of the predictor to be used in dynamic retrieval.

Optional. The threshold to be used in dynamic retrieval. If not set, a system default value is used.

Optional. If true, include the widget context token in the response.

Optional. List of domains to be excluded from the search results. The default limit is 2000 domains.

Optional. Sites with confidence level chosen & above this value will be blocked from the search results.

Required. The environment being operated.

Optional. By default,predefined functions are included in the final model call. Some of them can be explicitly excluded from being automatically included. This can serve two purposes: 1. Using a more restricted / different action space. 2. Improving the definitions / instructions of predefined functions.

Optional. Function calling config.

Optional. Retrieval config.

Optional. Function calling mode.

Optional. Function names to call. Only set when the Mode is ANY. Function names should match [FunctionDeclaration.name]. With mode set to ANY, model will predict a function call from the set of function names provided.

Optional. When set to true, arguments of a single function call will be streamed out in multiple parts/contents/responses. Partial parameter results will be returned in the [FunctionCall.partial_args] field.

The location of the user.

The language code of the user.

Total number of tokens that the cached content consumes.

Number of text characters.

Number of images.

Duration of video in seconds.

Duration of audio in seconds.