google-apis-aiplatform_v1beta1 0.64.0 → 0.66.0

data/lib/google/apis/aiplatform_v1beta1/classes.rb

@@ -818,6 +818,11 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1BleuMetricValue]
         attr_accessor :bleu_metric_value
       
+        # Result for custom code execution metric.
+        # Corresponds to the JSON property `customCodeExecutionResult`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1CustomCodeExecutionResult]
+        attr_accessor :custom_code_execution_result
+      
         # Exact match metric value for an instance.
         # Corresponds to the JSON property `exactMatchMetricValue`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ExactMatchMetricValue]
@@ -846,6 +851,7 @@ module Google
         def update!(**args)
           @aggregation_metric = args[:aggregation_metric] if args.key?(:aggregation_metric)
           @bleu_metric_value = args[:bleu_metric_value] if args.key?(:bleu_metric_value)
+          @custom_code_execution_result = args[:custom_code_execution_result] if args.key?(:custom_code_execution_result)
           @exact_match_metric_value = args[:exact_match_metric_value] if args.key?(:exact_match_metric_value)
           @pairwise_metric_result = args[:pairwise_metric_result] if args.key?(:pairwise_metric_result)
           @pointwise_metric_result = args[:pointwise_metric_result] if args.key?(:pointwise_metric_result)
@@ -1830,7 +1836,9 @@ module Google
         attr_accessor :flip_enabled
         alias_method :flip_enabled?, :flip_enabled
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -3204,20 +3212,21 @@ module Google
         end
       end
       
-      # Content blob.
+      # A content blob. A Blob contains data of a specific media type. It is used to
+      # represent images, audio, and video.
       class GoogleCloudAiplatformV1beta1Blob
         include Google::Apis::Core::Hashable
       
-        # Required. Raw bytes.
+        # Required. The raw bytes of the data.
         # Corresponds to the JSON property `data`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
         attr_accessor :data
       
-        # Optional. Display name of the blob. Used to provide a label or filename to
-        # distinguish blobs. This field is only returned in PromptMessage for prompt
-        # management. It is currently used in the Gemini GenerateContent calls only when
-        # server side tools (code_execution, google_search, and url_context) are enabled.
+        # Optional. The display name of the blob. Used to provide a label or filename to
+        # distinguish blobs. This field is only returned in `PromptMessage` for prompt
+        # management. It is used in the Gemini calls only when server-side tools (`
+        # code_execution`, `google_search`, and `url_context`) are enabled.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
@@ -3356,10 +3365,9 @@ module Google
         # @return [String]
         attr_accessor :name
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `systemInstruction`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :system_instruction
@@ -3577,58 +3585,70 @@ module Google
       class GoogleCloudAiplatformV1beta1Candidate
         include Google::Apis::Core::Hashable
       
-        # Output only. Average log probability score of the candidate.
+        # Output only. The average log probability of the tokens in this candidate. This
+        # is a length-normalized score that can be used to compare the quality of
+        # candidates of different lengths. A higher average log probability suggests a
+        # more confident and coherent response.
         # Corresponds to the JSON property `avgLogprobs`
         # @return [Float]
         attr_accessor :avg_logprobs
       
-        # A collection of source attributions for a piece of content.
+        # A collection of citations that apply to a piece of generated content.
         # Corresponds to the JSON property `citationMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1CitationMetadata]
         attr_accessor :citation_metadata
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
       
-        # Output only. Describes the reason the mode stopped generating tokens in more
-        # detail. This is only filled when `finish_reason` is set.
+        # Output only. Describes the reason the model stopped generating tokens in more
+        # detail. This field is returned only when `finish_reason` is set.
         # Corresponds to the JSON property `finishMessage`
         # @return [String]
         attr_accessor :finish_message
       
         # Output only. The reason why the model stopped generating tokens. If empty, the
-        # model has not stopped generating the tokens.
+        # model has not stopped generating.
         # Corresponds to the JSON property `finishReason`
         # @return [String]
         attr_accessor :finish_reason
       
-        # Metadata returned to client when grounding is enabled.
+        # Information about the sources that support the content of a response. When
+        # grounding is enabled, the model returns citations for claims in the response.
+        # This object contains the retrieved sources.
         # Corresponds to the JSON property `groundingMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingMetadata]
         attr_accessor :grounding_metadata
       
-        # Output only. Index of the candidate.
+        # Output only. The 0-based index of this candidate in the list of generated
+        # responses. This is useful for distinguishing between multiple candidates when `
+        # candidate_count` > 1.
         # Corresponds to the JSON property `index`
         # @return [Fixnum]
         attr_accessor :index
       
-        # Logprobs Result
+        # The log probabilities of the tokens generated by the model. This is useful for
+        # understanding the model's confidence in its predictions and for debugging. For
+        # example, you can use log probabilities to identify when the model is making a
+        # less confident prediction or to explore alternative responses that the model
+        # considered. A low log probability can also indicate that the model is "
+        # hallucinating" or generating factually incorrect information.
         # Corresponds to the JSON property `logprobsResult`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1LogprobsResult]
         attr_accessor :logprobs_result
       
-        # Output only. List of ratings for the safety of a response candidate. There is
-        # at most one rating per category.
+        # Output only. A list of ratings for the safety of a response candidate. There
+        # is at most one rating per category.
         # Corresponds to the JSON property `safetyRatings`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SafetyRating>]
         attr_accessor :safety_ratings
       
-        # Metadata related to url context retrieval tool.
+        # Metadata returned when the model uses the `url_context` tool to get
+        # information from a user-provided URL.
         # Corresponds to the JSON property `urlContextMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1UrlContextMetadata]
         attr_accessor :url_context_metadata
@@ -3661,6 +3681,12 @@ module Google
         # @return [String]
         attr_accessor :candidate
       
+        # Optional. Intermediate events (such as tool calls and responses) that led to
+        # the final response.
+        # Corresponds to the JSON property `events`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
+        attr_accessor :events
+      
         # Text response.
         # Corresponds to the JSON property `text`
         # @return [String]
@@ -3678,6 +3704,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @candidate = args[:candidate] if args.key?(:candidate)
+          @events = args[:events] if args.key?(:events)
           @text = args[:text] if args.key?(:text)
           @value = args[:value] if args.key?(:value)
         end
@@ -3884,16 +3911,16 @@ module Google
         end
       end
       
-      # Source attributions for content.
+      # A citation for a piece of generatedcontent.
       class GoogleCloudAiplatformV1beta1Citation
         include Google::Apis::Core::Hashable
       
-        # Output only. End index into the content.
+        # Output only. The end index of the citation in the content.
         # Corresponds to the JSON property `endIndex`
         # @return [Fixnum]
         attr_accessor :end_index
       
-        # Output only. License of the attribution.
+        # Output only. The license of the source of the citation.
         # Corresponds to the JSON property `license`
         # @return [String]
         attr_accessor :license
@@ -3910,17 +3937,17 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleTypeDate]
         attr_accessor :publication_date
       
-        # Output only. Start index into the content.
+        # Output only. The start index of the citation in the content.
         # Corresponds to the JSON property `startIndex`
         # @return [Fixnum]
         attr_accessor :start_index
       
-        # Output only. Title of the attribution.
+        # Output only. The title of the source of the citation.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
       
-        # Output only. Url reference of the attribution.
+        # Output only. The URI of the source of the citation.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -3940,11 +3967,11 @@ module Google
         end
       end
       
-      # A collection of source attributions for a piece of content.
+      # A collection of citations that apply to a piece of generated content.
       class GoogleCloudAiplatformV1beta1CitationMetadata
         include Google::Apis::Core::Hashable
       
-        # Output only. List of citations.
+        # Output only. A list of citations for the content.
         # Corresponds to the JSON property `citations`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Citation>]
         attr_accessor :citations
@@ -4472,22 +4499,21 @@ module Google
         end
       end
       
-      # The base structured datatype containing multi-part content of a message. A `
-      # Content` includes a `role` field designating the producer of the `Content` and
-      # a `parts` field containing multi-part data that contains the content of the
-      # message turn.
+      # The structured data content of a message. A Content message contains a `role`
+      # field, which indicates the producer of the content, and a `parts` field, which
+      # contains the multi-part data of the message.
       class GoogleCloudAiplatformV1beta1Content
         include Google::Apis::Core::Hashable
       
-        # Required. Ordered `Parts` that constitute a single message. Parts may have
-        # different IANA MIME types.
+        # Required. A list of Part objects that make up a single message. Parts of a
+        # message can have different MIME types. A Content message must have at least
+        # one Part.
         # Corresponds to the JSON property `parts`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Part>]
         attr_accessor :parts
       
-        # Optional. The producer of the content. Must be either 'user' or 'model'.
-        # Useful to set for multi-turn conversations, otherwise can be left blank or
-        # unset.
+        # Optional. The producer of the content. Must be either 'user' or 'model'. If
+        # not set, the service will default to 'user'.
         # Corresponds to the JSON property `role`
         # @return [String]
         attr_accessor :role
@@ -4573,10 +4599,9 @@ module Google
       class GoogleCloudAiplatformV1beta1ContentsExampleExpectedContent
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -4800,10 +4825,9 @@ module Google
       class GoogleCloudAiplatformV1beta1CorroborateContentRequest
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -4886,7 +4910,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
         attr_accessor :contents
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -4903,10 +4929,9 @@ module Google
         # @return [String]
         attr_accessor :model
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `systemInstruction`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :system_instruction
@@ -5691,6 +5716,56 @@ module Google
         end
       end
       
+      # Result for custom code execution metric.
+      class GoogleCloudAiplatformV1beta1CustomCodeExecutionResult
+        include Google::Apis::Core::Hashable
+      
+        # Output only. Custom code execution score.
+        # Corresponds to the JSON property `score`
+        # @return [Float]
+        attr_accessor :score
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @score = args[:score] if args.key?(:score)
+        end
+      end
+      
+      # Specificies a metric that is populated by evaluating user-defined Python code.
+      class GoogleCloudAiplatformV1beta1CustomCodeExecutionSpec
+        include Google::Apis::Core::Hashable
+      
+        # Required. Python function. Expected user to define the following function, e.g.
+        # : def evaluate(instance: dict[str, Any]) -> float: Please include this
+        # function signature in the code snippet. Instance is the evaluation instance,
+        # any fields populated in the instance are available to the function as instance[
+        # field_name]. Example: Example input: ``` instance= EvaluationInstance(
+        # response=EvaluationInstance.InstanceData(text="The answer is 4."), reference=
+        # EvaluationInstance.InstanceData(text="4") ) ``` Example converted input: ``` `
+        # 'response': `'text': 'The answer is 4.'`, 'reference': `'text': '4'` ` ```
+        # Example python function: ``` def evaluate(instance: dict[str, Any]) -> float:
+        # if instance'response' == instance'reference': return 1.0 return 0.0 ```
+        # CustomCodeExecutionSpec is also supported in Batch Evaluation (EvalDataset RPC)
+        # and Tuning Evaluation. Each line in the input jsonl file will be converted to
+        # dict[str, Any] and passed to the evaluation function.
+        # Corresponds to the JSON property `evaluationFunction`
+        # @return [String]
+        attr_accessor :evaluation_function
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @evaluation_function = args[:evaluation_function] if args.key?(:evaluation_function)
+        end
+      end
+      
       # Represents a job that runs custom workloads such as a Docker container or a
       # Python package. A CustomJob can have multiple worker pools and each worker
       # pool can have its own machine and input spec. A CustomJob will be cleaned up
@@ -6756,7 +6831,7 @@ module Google
       class GoogleCloudAiplatformV1beta1DedicatedResourcesScaleToZeroSpec
         include Google::Apis::Core::Hashable
       
-        # Optional. Duration of no traffic before scaling to zero. [MinValue=3600] (5
+        # Optional. Duration of no traffic before scaling to zero. [MinValue=300] (5
         # minutes) [MaxValue=28800] (8 hours)
         # Corresponds to the JSON property `idleScaledownPeriod`
         # @return [String]
@@ -8420,10 +8495,9 @@ module Google
         attr_accessor :auto_truncate
         alias_method :auto_truncate?, :auto_truncate
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -9721,6 +9795,11 @@ module Google
       class GoogleCloudAiplatformV1beta1EvaluationInstance
         include Google::Apis::Core::Hashable
       
+        # Contains data specific to agent evaluations.
+        # Corresponds to the JSON property `agentData`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData]
+        attr_accessor :agent_data
+      
         # Instance data specified as a map.
         # Corresponds to the JSON property `otherData`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceMapInstance]
@@ -9754,6 +9833,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @agent_data = args[:agent_data] if args.key?(:agent_data)
           @other_data = args[:other_data] if args.key?(:other_data)
           @prompt = args[:prompt] if args.key?(:prompt)
           @reference = args[:reference] if args.key?(:reference)
@@ -9762,6 +9842,144 @@ module Google
         end
       end
       
+      # Configuration for an Agent.
+      class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig
+        include Google::Apis::Core::Hashable
+      
+        # Instance data used to populate placeholders in a metric prompt template.
+        # Corresponds to the JSON property `developerInstruction`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData]
+        attr_accessor :developer_instruction
+      
+        # Represents a list of tools for an agent.
+        # Corresponds to the JSON property `tools`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfigTools]
+        attr_accessor :tools
+      
+        # A JSON string containing a list of tools available to an agent with info such
+        # as name, description, parameters and required parameters.
+        # Corresponds to the JSON property `toolsText`
+        # @return [String]
+        attr_accessor :tools_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @developer_instruction = args[:developer_instruction] if args.key?(:developer_instruction)
+          @tools = args[:tools] if args.key?(:tools)
+          @tools_text = args[:tools_text] if args.key?(:tools_text)
+        end
+      end
+      
+      # Represents a list of tools for an agent.
+      class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfigTools
+        include Google::Apis::Core::Hashable
+      
+        # Optional. List of tools: each tool can have multiple function declarations.
+        # Corresponds to the JSON property `tool`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Tool>]
+        attr_accessor :tool
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @tool = args[:tool] if args.key?(:tool)
+        end
+      end
+      
+      # Contains data specific to agent evaluations.
+      class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData
+        include Google::Apis::Core::Hashable
+      
+        # Configuration for an Agent.
+        # Corresponds to the JSON property `agentConfig`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig]
+        attr_accessor :agent_config
+      
+        # Instance data used to populate placeholders in a metric prompt template.
+        # Corresponds to the JSON property `developerInstruction`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData]
+        attr_accessor :developer_instruction
+      
+        # Represents a list of events for an agent.
+        # Corresponds to the JSON property `events`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataEvents]
+        attr_accessor :events
+      
+        # Represents a list of tools for an agent.
+        # Corresponds to the JSON property `tools`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools]
+        attr_accessor :tools
+      
+        # A JSON string containing a list of tools available to an agent with info such
+        # as name, description, parameters and required parameters. Example: [ ` "name":
+        # "search_actors", "description": "Search for actors in a movie. Returns a list
+        # of actors, their roles, their birthdate, and their place of birth.", "
+        # parameters": [ ` "name": "movie_name", "description": "The name of the movie."
+        # `, ` "name": "character_name", "description": "The name of the character." ` ],
+        # "required": ["movie_name", "character_name"] ` ]
+        # Corresponds to the JSON property `toolsText`
+        # @return [String]
+        attr_accessor :tools_text
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @agent_config = args[:agent_config] if args.key?(:agent_config)
+          @developer_instruction = args[:developer_instruction] if args.key?(:developer_instruction)
+          @events = args[:events] if args.key?(:events)
+          @tools = args[:tools] if args.key?(:tools)
+          @tools_text = args[:tools_text] if args.key?(:tools_text)
+        end
+      end
+      
+      # Represents a list of events for an agent.
+      class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataEvents
+        include Google::Apis::Core::Hashable
+      
+        # Optional. A list of events.
+        # Corresponds to the JSON property `event`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
+        attr_accessor :event
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @event = args[:event] if args.key?(:event)
+        end
+      end
+      
+      # Represents a list of tools for an agent.
+      class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools
+        include Google::Apis::Core::Hashable
+      
+        # Optional. List of tools: each tool can have multiple function declarations.
+        # Corresponds to the JSON property `tool`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Tool>]
+        attr_accessor :tool
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @tool = args[:tool] if args.key?(:tool)
+        end
+      end
+      
       # Instance data used to populate placeholders in a metric prompt template.
       class GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData
         include Google::Apis::Core::Hashable
@@ -10299,7 +10517,9 @@ module Google
         # @return [String]
         attr_accessor :autorater_model
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -10379,7 +10599,14 @@ module Google
       class GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfig
         include Google::Apis::Core::Hashable
       
-        # Generation config.
+        # Configuration that describes an agent.
+        # Corresponds to the JSON property `agentConfig`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentConfig]
+        attr_accessor :agent_config
+      
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -10398,11 +10625,39 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @agent_config = args[:agent_config] if args.key?(:agent_config)
           @generation_config = args[:generation_config] if args.key?(:generation_config)
           @model = args[:model] if args.key?(:model)
         end
       end
       
+      # Configuration that describes an agent.
+      class GoogleCloudAiplatformV1beta1EvaluationRunInferenceConfigAgentConfig
+        include Google::Apis::Core::Hashable
+      
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
+        # Corresponds to the JSON property `developerInstruction`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
+        attr_accessor :developer_instruction
+      
+        # Optional. The tools available to the agent.
+        # Corresponds to the JSON property `tools`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Tool>]
+        attr_accessor :tools
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @developer_instruction = args[:developer_instruction] if args.key?(:developer_instruction)
+          @tools = args[:tools] if args.key?(:tools)
+        end
+      end
+      
       # The metric used for evaluation runs.
       class GoogleCloudAiplatformV1beta1EvaluationRunMetric
         include Google::Apis::Core::Hashable
@@ -10417,6 +10672,11 @@ module Google
         # @return [String]
         attr_accessor :metric
       
+        # The metric used for running evaluations.
+        # Corresponds to the JSON property `metricConfig`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Metric]
+        attr_accessor :metric_config
+      
         # Specification for a pre-defined metric.
         # Corresponds to the JSON property `predefinedMetricSpec`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationRunMetricPredefinedMetricSpec]
@@ -10435,6 +10695,7 @@ module Google
         def update!(**args)
           @llm_based_metric_spec = args[:llm_based_metric_spec] if args.key?(:llm_based_metric_spec)
           @metric = args[:metric] if args.key?(:metric)
+          @metric_config = args[:metric_config] if args.key?(:metric_config)
           @predefined_metric_spec = args[:predefined_metric_spec] if args.key?(:predefined_metric_spec)
           @rubric_based_metric_spec = args[:rubric_based_metric_spec] if args.key?(:rubric_based_metric_spec)
         end
@@ -10800,7 +11061,9 @@ module Google
         # @return [Hash<String,Object>]
         attr_accessor :custom_metadata
       
-        # Metadata returned to client when grounding is enabled.
+        # Information about the sources that support the content of a response. When
+        # grounding is enabled, the model returns citations for claims in the response.
+        # This object contains the retrieved sources.
         # Corresponds to the JSON property `groundingMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingMetadata]
         attr_accessor :grounding_metadata
@@ -11263,6 +11526,44 @@ module Google
         end
       end
       
+      # Request message for SandboxEnvironmentExecutionService.ExecuteCode.
+      class GoogleCloudAiplatformV1beta1ExecuteCodeRequest
+        include Google::Apis::Core::Hashable
+      
+        # Required. The inputs used for the stateless code execution.
+        # Corresponds to the JSON property `inputs`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Chunk>]
+        attr_accessor :inputs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @inputs = args[:inputs] if args.key?(:inputs)
+        end
+      end
+      
+      # Response message for SandboxEnvironmentExecutionService.ExecuteCode.
+      class GoogleCloudAiplatformV1beta1ExecuteCodeResponse
+        include Google::Apis::Core::Hashable
+      
+        # The outputs from the sandbox environment.
+        # Corresponds to the JSON property `outputs`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Chunk>]
+        attr_accessor :outputs
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @outputs = args[:outputs] if args.key?(:outputs)
+        end
+      end
+      
       # Request message for ExtensionExecutionService.ExecuteExtension.
       class GoogleCloudAiplatformV1beta1ExecuteExtensionRequest
         include Google::Apis::Core::Hashable
@@ -15572,20 +15873,21 @@ module Google
         end
       end
       
-      # URI based data.
+      # URI-based data. A FileData message contains a URI pointing to data of a
+      # specific media type. It is used to represent images, audio, and video stored
+      # in Google Cloud Storage.
       class GoogleCloudAiplatformV1beta1FileData
         include Google::Apis::Core::Hashable
       
-        # Optional. Display name of the file data. Used to provide a label or filename
-        # to distinguish file datas. This field is only returned in PromptMessage for
-        # prompt management. It is currently used in the Gemini GenerateContent calls
-        # only when server side tools (code_execution, google_search, and url_context)
-        # are enabled.
+        # Optional. The display name of the file. Used to provide a label or filename to
+        # distinguish files. This field is only returned in `PromptMessage` for prompt
+        # management. It is used in the Gemini calls only when server side tools (`
+        # code_execution`, `google_search`, and `url_context`) are enabled.
         # Corresponds to the JSON property `displayName`
         # @return [String]
         attr_accessor :display_name
       
-        # Required. URI.
+        # Required. The URI of the file in Google Cloud Storage.
         # Corresponds to the JSON property `fileUri`
         # @return [String]
         attr_accessor :file_uri
@@ -16522,7 +16824,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
         attr_accessor :contents
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -16550,10 +16854,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SafetySetting>]
         attr_accessor :safety_settings
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `systemInstruction`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :system_instruction
@@ -16618,10 +16921,9 @@ module Google
       class GoogleCloudAiplatformV1beta1GeminiPreferenceExampleCompletion
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `completion`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :completion
@@ -16814,7 +17116,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
         attr_accessor :contents
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -16828,7 +17132,10 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :labels
       
-        # Configuration for Model Armor integrations of prompt and responses.
+        # Configuration for Model Armor. Model Armor is a Google Cloud service that
+        # provides safety and security filtering for prompts and responses. It helps
+        # protect your AI applications from risks such as harmful content, sensitive
+        # data leakage, and prompt injection attacks.
         # Corresponds to the JSON property `modelArmorConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ModelArmorConfig]
         attr_accessor :model_armor_config
@@ -16839,10 +17146,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SafetySetting>]
         attr_accessor :safety_settings
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `systemInstruction`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :system_instruction
@@ -17099,6 +17405,11 @@ module Google
       class GoogleCloudAiplatformV1beta1GenerateInstanceRubricsRequest
         include Google::Apis::Core::Hashable
       
+        # Configuration for an Agent.
+        # Corresponds to the JSON property `agentConfig`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig]
+        attr_accessor :agent_config
+      
         # Required. The prompt to generate rubrics from. For single-turn queries, this
         # is a single instance. For multi-turn queries, this is a repeated field that
         # contains conversation history + latest request.
@@ -17122,6 +17433,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @agent_config = args[:agent_config] if args.key?(:agent_config)
           @contents = args[:contents] if args.key?(:contents)
           @predefined_rubric_generation_spec = args[:predefined_rubric_generation_spec] if args.key?(:predefined_rubric_generation_spec)
           @rubric_generation_spec = args[:rubric_generation_spec] if args.key?(:rubric_generation_spec)
@@ -17251,10 +17563,9 @@ module Google
       class GoogleCloudAiplatformV1beta1GenerateMemoriesRequestDirectContentsSourceEvent
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -17299,6 +17610,11 @@ module Google
         # @return [String]
         attr_accessor :fact
       
+        # Optional. The topics that the consolidated memories should be associated with.
+        # Corresponds to the JSON property `topics`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1MemoryTopicId>]
+        attr_accessor :topics
+      
         def initialize(**args)
            update!(**args)
         end
@@ -17306,6 +17622,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @fact = args[:fact] if args.key?(:fact)
+          @topics = args[:topics] if args.key?(:topics)
         end
       end
       
@@ -17473,50 +17790,72 @@ module Google
         end
       end
       
-      # Generation config.
+      # Configuration for content generation. This message contains all the parameters
+      # that control how the model generates content. It allows you to influence the
+      # randomness, length, and structure of the output.
       class GoogleCloudAiplatformV1beta1GenerationConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. If enabled, audio timestamp will be included in the request to the
-        # model.
+        # Optional. If enabled, audio timestamps will be included in the request to the
+        # model. This can be useful for synchronizing audio with other modalities in the
+        # response.
         # Corresponds to the JSON property `audioTimestamp`
         # @return [Boolean]
         attr_accessor :audio_timestamp
         alias_method :audio_timestamp?, :audio_timestamp
       
-        # Optional. Number of candidates to generate.
+        # Optional. The number of candidate responses to generate. A higher `
+        # candidate_count` can provide more options to choose from, but it also consumes
+        # more resources. This can be useful for generating a variety of responses and
+        # selecting the best one.
         # Corresponds to the JSON property `candidateCount`
         # @return [Fixnum]
         attr_accessor :candidate_count
       
         # Optional. If enabled, the model will detect emotions and adapt its responses
-        # accordingly.
+        # accordingly. For example, if the model detects that the user is frustrated, it
+        # may provide a more empathetic response.
         # Corresponds to the JSON property `enableAffectiveDialog`
         # @return [Boolean]
         attr_accessor :enable_affective_dialog
         alias_method :enable_affective_dialog?, :enable_affective_dialog
       
-        # Optional. Frequency penalties.
+        # Optional. Penalizes tokens based on their frequency in the generated text. A
+        # positive value helps to reduce the repetition of words and phrases. Valid
+        # values can range from [-2.0, 2.0].
         # Corresponds to the JSON property `frequencyPenalty`
         # @return [Float]
         attr_accessor :frequency_penalty
       
-        # Config for image generation features.
+        # Configuration for image generation. This message allows you to control various
+        # aspects of image generation, such as the output format, aspect ratio, and
+        # whether the model can generate images of people.
         # Corresponds to the JSON property `imageConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ImageConfig]
         attr_accessor :image_config
       
-        # Optional. Logit probabilities.
+        # Optional. The number of top log probabilities to return for each token. This
+        # can be used to see which other tokens were considered likely candidates for a
+        # given position. A higher value will return more options, but it will also
+        # increase the size of the response.
         # Corresponds to the JSON property `logprobs`
         # @return [Fixnum]
         attr_accessor :logprobs
       
-        # Optional. The maximum number of output tokens to generate per message.
+        # Optional. The maximum number of tokens to generate in the response. A token is
+        # approximately four characters. The default value varies by model. This
+        # parameter can be used to control the length of the generated text and prevent
+        # overly long responses.
         # Corresponds to the JSON property `maxOutputTokens`
         # @return [Fixnum]
         attr_accessor :max_output_tokens
       
-        # Optional. If specified, the media resolution specified will be used.
+        # Optional. The token resolution at which input media content is sampled. This
+        # is used to control the trade-off between the quality of the response and the
+        # number of tokens used to represent the media. A higher resolution allows the
+        # model to perceive more detail, which can lead to a more nuanced response, but
+        # it will also use more tokens. This does not affect the image dimensions sent
+        # to the model.
         # Corresponds to the JSON property `mediaResolution`
         # @return [String]
         attr_accessor :media_resolution
@@ -17526,44 +17865,41 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfigModelConfig]
         attr_accessor :model_config
       
-        # Optional. Positive penalties.
+        # Optional. Penalizes tokens that have already appeared in the generated text. A
+        # positive value encourages the model to generate more diverse and less
+        # repetitive text. Valid values can range from [-2.0, 2.0].
         # Corresponds to the JSON property `presencePenalty`
         # @return [Float]
         attr_accessor :presence_penalty
       
-        # Optional. Output schema of the generated response. This is an alternative to `
-        # response_schema` that accepts [JSON Schema](https://json-schema.org/). If set,
-        # `response_schema` must be omitted, but `response_mime_type` is required. While
-        # the full JSON Schema may be sent, not all features are supported. Specifically,
-        # only the following properties are supported: - `$id` - `$defs` - `$ref` - `$
-        # anchor` - `type` - `format` - `title` - `description` - `enum` (for strings
-        # and numbers) - `items` - `prefixItems` - `minItems` - `maxItems` - `minimum` -
-        # `maximum` - `anyOf` - `oneOf` (interpreted the same as `anyOf`) - `properties`
-        # - `additionalProperties` - `required` The non-standard `propertyOrdering`
-        # property may also be set. Cyclic references are unrolled to a limited degree
-        # and, as such, may only be used within non-required properties. (Nullable
-        # properties are not sufficient.) If `$ref` is set on a sub-schema, no other
-        # properties, except for than those starting as a `$`, may be set.
+        # Optional. When this field is set, response_schema must be omitted and
+        # response_mime_type must be set to `application/json`.
         # Corresponds to the JSON property `responseJsonSchema`
         # @return [Object]
         attr_accessor :response_json_schema
       
-        # Optional. If true, export the logprobs results in response.
+        # Optional. If set to true, the log probabilities of the output tokens are
+        # returned. Log probabilities are the logarithm of the probability of a token
+        # appearing in the output. A higher log probability means the token is more
+        # likely to be generated. This can be useful for analyzing the model's
+        # confidence in its own output and for debugging.
         # Corresponds to the JSON property `responseLogprobs`
         # @return [Boolean]
         attr_accessor :response_logprobs
         alias_method :response_logprobs?, :response_logprobs
       
-        # Optional. Output response mimetype of the generated candidate text. Supported
-        # mimetype: - `text/plain`: (default) Text output. - `application/json`: JSON
-        # response in the candidates. The model needs to be prompted to output the
+        # Optional. The IANA standard MIME type of the response. The model will generate
+        # output that conforms to this MIME type. Supported values include 'text/plain' (
+        # default) and 'application/json'. The model needs to be prompted to output the
         # appropriate response type, otherwise the behavior is undefined. This is a
         # preview feature.
         # Corresponds to the JSON property `responseMimeType`
         # @return [String]
         attr_accessor :response_mime_type
       
-        # Optional. The modalities of the response.
+        # Optional. The modalities of the response. The model will generate a response
+        # that includes all the specified modalities. For example, if this is set to `[
+        # TEXT, IMAGE]`, the response will include both text and an image.
         # Corresponds to the JSON property `responseModalities`
         # @return [Array<String>]
         attr_accessor :response_modalities
@@ -17575,42 +17911,68 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Schema]
         attr_accessor :response_schema
       
-        # The configuration for routing the request to a specific model.
+        # The configuration for routing the request to a specific model. This can be
+        # used to control which model is used for the generation, either automatically
+        # or by specifying a model name.
         # Corresponds to the JSON property `routingConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig]
         attr_accessor :routing_config
       
-        # Optional. Seed.
+        # Optional. A seed for the random number generator. By setting a seed, you can
+        # make the model's output mostly deterministic. For a given prompt and
+        # parameters (like temperature, top_p, etc.), the model will produce the same
+        # response every time. However, it's not a guaranteed absolute deterministic
+        # behavior. This is different from parameters like `temperature`, which control
+        # the *level* of randomness. `seed` ensures that the "random" choices the model
+        # makes are the same on every run, making it essential for testing and ensuring
+        # reproducible results.
         # Corresponds to the JSON property `seed`
         # @return [Fixnum]
         attr_accessor :seed
       
-        # The speech generation config.
+        # Configuration for speech generation.
         # Corresponds to the JSON property `speechConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SpeechConfig]
         attr_accessor :speech_config
       
-        # Optional. Stop sequences.
+        # Optional. A list of character sequences that will stop the model from
+        # generating further tokens. If a stop sequence is generated, the output will
+        # end at that point. This is useful for controlling the length and structure of
+        # the output. For example, you can use ["\n", "###"] to stop generation at a new
+        # line or a specific marker.
         # Corresponds to the JSON property `stopSequences`
         # @return [Array<String>]
         attr_accessor :stop_sequences
       
-        # Optional. Controls the randomness of predictions.
+        # Optional. Controls the randomness of the output. A higher temperature results
+        # in more creative and diverse responses, while a lower temperature makes the
+        # output more predictable and focused. The valid range is (0.0, 2.0].
         # Corresponds to the JSON property `temperature`
         # @return [Float]
         attr_accessor :temperature
       
-        # Config for thinking features.
+        # Configuration for the model's thinking features. "Thinking" is a process where
+        # the model breaks down a complex task into smaller, manageable steps. This
+        # allows the model to reason about the task, plan its approach, and execute the
+        # plan to generate a high-quality response.
         # Corresponds to the JSON property `thinkingConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfigThinkingConfig]
         attr_accessor :thinking_config
       
-        # Optional. If specified, top-k sampling will be used.
+        # Optional. Specifies the top-k sampling threshold. The model considers only the
+        # top k most probable tokens for the next token. This can be useful for
+        # generating more coherent and less random text. For example, a `top_k` of 40
+        # means the model will choose the next word from the 40 most likely words.
         # Corresponds to the JSON property `topK`
         # @return [Float]
         attr_accessor :top_k
       
-        # Optional. If specified, nucleus sampling will be used.
+        # Optional. Specifies the nucleus sampling threshold. The model considers only
+        # the smallest set of tokens whose cumulative probability is at least `top_p`.
+        # This helps generate more diverse and less repetitive responses. For example, a
+        # `top_p` of 0.9 means the model considers tokens until the cumulative
+        # probability of the tokens to select from reaches 0.9. It's recommended to
+        # adjust either temperature or `top_p`, but not both.
         # Corresponds to the JSON property `topP`
         # @return [Float]
         attr_accessor :top_p
@@ -17666,17 +18028,21 @@ module Google
         end
       end
       
-      # The configuration for routing the request to a specific model.
+      # The configuration for routing the request to a specific model. This can be
+      # used to control which model is used for the generation, either automatically
+      # or by specifying a model name.
       class GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfig
         include Google::Apis::Core::Hashable
       
-        # When automated routing is specified, the routing will be determined by the
-        # pretrained routing model and customer provided model routing preference.
+        # The configuration for automated routing. When automated routing is specified,
+        # the routing will be determined by the pretrained routing model and customer
+        # provided model routing preference.
         # Corresponds to the JSON property `autoMode`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode]
         attr_accessor :auto_mode
       
-        # When manual routing is set, the specified model will be used directly.
+        # The configuration for manual routing. When manual routing is specified, the
+        # model will be selected based on the model name provided.
         # Corresponds to the JSON property `manualMode`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode]
         attr_accessor :manual_mode
@@ -17692,8 +18058,9 @@ module Google
         end
       end
       
-      # When automated routing is specified, the routing will be determined by the
-      # pretrained routing model and customer provided model routing preference.
+      # The configuration for automated routing. When automated routing is specified,
+      # the routing will be determined by the pretrained routing model and customer
+      # provided model routing preference.
       class GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigAutoRoutingMode
         include Google::Apis::Core::Hashable
       
@@ -17712,13 +18079,12 @@ module Google
         end
       end
       
-      # When manual routing is set, the specified model will be used directly.
+      # The configuration for manual routing. When manual routing is specified, the
+      # model will be selected based on the model name provided.
       class GoogleCloudAiplatformV1beta1GenerationConfigRoutingConfigManualRoutingMode
         include Google::Apis::Core::Hashable
       
-        # The model name to use. Only the public LLM models are accepted. See [Supported
-        # models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/
-        # inference#supported-models).
+        # The name of the model to use. Only public LLM models are accepted.
         # Corresponds to the JSON property `modelName`
         # @return [String]
         attr_accessor :model_name
@@ -17733,18 +18099,26 @@ module Google
         end
       end
       
-      # Config for thinking features.
+      # Configuration for the model's thinking features. "Thinking" is a process where
+      # the model breaks down a complex task into smaller, manageable steps. This
+      # allows the model to reason about the task, plan its approach, and execute the
+      # plan to generate a high-quality response.
       class GoogleCloudAiplatformV1beta1GenerationConfigThinkingConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. Indicates whether to include thoughts in the response. If true,
-        # thoughts are returned only when available.
+        # Optional. If true, the model will include its thoughts in the response. "
+        # Thoughts" are the intermediate steps the model takes to arrive at the final
+        # response. They can provide insights into the model's reasoning process and
+        # help with debugging. If this is true, thoughts are returned only when
+        # available.
         # Corresponds to the JSON property `includeThoughts`
         # @return [Boolean]
         attr_accessor :include_thoughts
         alias_method :include_thoughts?, :include_thoughts
       
-        # Optional. Indicates the thinking budget in tokens.
+        # Optional. The token budget for the model's thinking process. The model will
+        # make a best effort to stay within this budget. This can be used to control the
+        # trade-off between response quality and latency.
         # Corresponds to the JSON property `thinkingBudget`
         # @return [Fixnum]
         attr_accessor :thinking_budget
@@ -17998,21 +18372,30 @@ module Google
         end
       end
       
-      # Grounding chunk.
+      # A piece of evidence that supports a claim made by the model. This is used to
+      # show a citation for a claim made by the model. When grounding is enabled, the
+      # model returns a `GroundingChunk` that contains a reference to the source of
+      # the information.
       class GoogleCloudAiplatformV1beta1GroundingChunk
         include Google::Apis::Core::Hashable
       
-        # Chunk from Google Maps.
+        # A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains
+        # information about a place, such as its name, address, and reviews. This is
+        # used to provide the user with rich, location-based information.
         # Corresponds to the JSON property `maps`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunkMaps]
         attr_accessor :maps
       
-        # Chunk from context retrieved by the retrieval tools.
+        # Context retrieved from a data source to ground the model's response. This is
+        # used when a retrieval tool fetches information from a user-provided corpus or
+        # a public dataset.
         # Corresponds to the JSON property `retrievedContext`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext]
         attr_accessor :retrieved_context
       
-        # Chunk from the web.
+        # A `Web` chunk is a piece of evidence that comes from a web page. It contains
+        # the URI of the web page, the title of the page, and the domain of the page.
+        # This is used to provide the user with a link to the source of the information.
         # Corresponds to the JSON property `web`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunkWeb]
         attr_accessor :web
@@ -18029,32 +18412,36 @@ module Google
         end
       end
       
-      # Chunk from Google Maps.
+      # A `Maps` chunk is a piece of evidence that comes from Google Maps. It contains
+      # information about a place, such as its name, address, and reviews. This is
+      # used to provide the user with rich, location-based information.
       class GoogleCloudAiplatformV1beta1GroundingChunkMaps
         include Google::Apis::Core::Hashable
       
-        # Sources used to generate the place answer.
+        # The sources that were used to generate the place answer. This includes review
+        # snippets and photos that were used to generate the answer, as well as URIs to
+        # flag content.
         # Corresponds to the JSON property `placeAnswerSources`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources]
         attr_accessor :place_answer_sources
       
-        # This Place's resource name, in `places/`place_id`` format. Can be used to look
-        # up the Place.
+        # This Place's resource name, in `places/`place_id`` format. This can be used to
+        # look up the place in the Google Maps API.
         # Corresponds to the JSON property `placeId`
         # @return [String]
         attr_accessor :place_id
       
-        # Text of the place answer.
+        # The text of the place answer.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # Title of the place.
+        # The title of the place.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
       
-        # URI reference of the place.
+        # The URI of the place.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -18073,11 +18460,13 @@ module Google
         end
       end
       
-      # Sources used to generate the place answer.
+      # The sources that were used to generate the place answer. This includes review
+      # snippets and photos that were used to generate the answer, as well as URIs to
+      # flag content.
       class GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSources
         include Google::Apis::Core::Hashable
       
-        # Snippets of reviews that are used to generate the answer.
+        # Snippets of reviews that were used to generate the answer.
         # Corresponds to the JSON property `reviewSnippets`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet>]
         attr_accessor :review_snippets
@@ -18092,7 +18481,7 @@ module Google
         end
       end
       
-      # Encapsulates a review snippet.
+      # A review snippet that is used to generate the answer.
       class GoogleCloudAiplatformV1beta1GroundingChunkMapsPlaceAnswerSourcesReviewSnippet
         include Google::Apis::Core::Hashable
       
@@ -18101,12 +18490,12 @@ module Google
         # @return [String]
         attr_accessor :google_maps_uri
       
-        # Id of the review referencing the place.
+        # The ID of the review that is being referenced.
         # Corresponds to the JSON property `reviewId`
         # @return [String]
         attr_accessor :review_id
       
-        # Title of the review.
+        # The title of the review.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
@@ -18123,12 +18512,16 @@ module Google
         end
       end
       
-      # Chunk from context retrieved by the retrieval tools.
+      # Context retrieved from a data source to ground the model's response. This is
+      # used when a retrieval tool fetches information from a user-provided corpus or
+      # a public dataset.
       class GoogleCloudAiplatformV1beta1GroundingChunkRetrievedContext
         include Google::Apis::Core::Hashable
       
-        # Output only. The full document name for the referenced Vertex AI Search
-        # document.
+        # Output only. The full resource name of the referenced Vertex AI Search
+        # document. This is used to identify the specific document that was retrieved.
+        # The format is `projects/`project`/locations/`location`/collections/`collection`
+        # /dataStores/`data_store`/branches/`branch`/documents/`document``.
         # Corresponds to the JSON property `documentName`
         # @return [String]
         attr_accessor :document_name
@@ -18139,17 +18532,17 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1RagChunk]
         attr_accessor :rag_chunk
       
-        # Text of the attribution.
+        # The content of the retrieved data source.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # Title of the attribution.
+        # The title of the retrieved data source.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
       
-        # URI reference of the attribution.
+        # The URI of the retrieved data source.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -18168,21 +18561,24 @@ module Google
         end
       end
       
-      # Chunk from the web.
+      # A `Web` chunk is a piece of evidence that comes from a web page. It contains
+      # the URI of the web page, the title of the page, and the domain of the page.
+      # This is used to provide the user with a link to the source of the information.
       class GoogleCloudAiplatformV1beta1GroundingChunkWeb
         include Google::Apis::Core::Hashable
       
-        # Domain of the (original) URI.
+        # The domain of the web page that contains the evidence. This can be used to
+        # filter out low-quality sources.
         # Corresponds to the JSON property `domain`
         # @return [String]
         attr_accessor :domain
       
-        # Title of the chunk.
+        # The title of the web page that contains the evidence.
         # Corresponds to the JSON property `title`
         # @return [String]
         attr_accessor :title
       
-        # URI reference of the chunk.
+        # The URI of the web page that contains the evidence.
         # Corresponds to the JSON property `uri`
         # @return [String]
         attr_accessor :uri
@@ -18199,49 +18595,63 @@ module Google
         end
       end
       
-      # Metadata returned to client when grounding is enabled.
+      # Information about the sources that support the content of a response. When
+      # grounding is enabled, the model returns citations for claims in the response.
+      # This object contains the retrieved sources.
       class GoogleCloudAiplatformV1beta1GroundingMetadata
         include Google::Apis::Core::Hashable
       
-        # Optional. Output only. Resource name of the Google Maps widget context token
-        # to be used with the PlacesContextElement widget to render contextual data.
-        # This is populated only for Google Maps grounding.
+        # Optional. Output only. A token that can be used to render a Google Maps widget
+        # with the contextual data. This field is populated only when the grounding
+        # source is Google Maps.
         # Corresponds to the JSON property `googleMapsWidgetContextToken`
         # @return [String]
         attr_accessor :google_maps_widget_context_token
       
-        # List of supporting references retrieved from specified grounding source.
+        # A list of supporting references retrieved from the grounding source. This
+        # field is populated when the grounding source is Google Search, Vertex AI
+        # Search, or Google Maps.
         # Corresponds to the JSON property `groundingChunks`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingChunk>]
         attr_accessor :grounding_chunks
       
-        # Optional. List of grounding support.
+        # Optional. A list of grounding supports that connect the generated content to
+        # the grounding chunks. This field is populated when the grounding source is
+        # Google Search or Vertex AI Search.
         # Corresponds to the JSON property `groundingSupports`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingSupport>]
         attr_accessor :grounding_supports
       
-        # Metadata related to retrieval in the grounding flow.
+        # Metadata related to the retrieval grounding source. This is part of the `
+        # GroundingMetadata` returned when grounding is enabled.
         # Corresponds to the JSON property `retrievalMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1RetrievalMetadata]
         attr_accessor :retrieval_metadata
       
-        # Optional. Queries executed by the retrieval tools.
+        # Optional. The queries that were executed by the retrieval tools. This field is
+        # populated only when the grounding source is a retrieval tool, such as Vertex
+        # AI Search.
         # Corresponds to the JSON property `retrievalQueries`
         # @return [Array<String>]
         attr_accessor :retrieval_queries
       
-        # Google search entry point.
+        # An entry point for displaying Google Search results. A `SearchEntryPoint` is
+        # populated when the grounding source for a model's response is Google Search.
+        # It provides information that you can use to display the search results in your
+        # application.
         # Corresponds to the JSON property `searchEntryPoint`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SearchEntryPoint]
         attr_accessor :search_entry_point
       
-        # Optional. Output only. List of source flagging uris. This is currently
-        # populated only for Google Maps grounding.
+        # Optional. Output only. A list of URIs that can be used to flag a place or
+        # review for inappropriate content. This field is populated only when the
+        # grounding source is Google Maps.
         # Corresponds to the JSON property `sourceFlaggingUris`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GroundingMetadataSourceFlaggingUri>]
         attr_accessor :source_flagging_uris
       
-        # Optional. Web search queries for the following-up web search.
+        # Optional. The web search queries that were used to generate the content. This
+        # field is populated only when the grounding source is Google Search.
         # Corresponds to the JSON property `webSearchQueries`
         # @return [Array<String>]
         attr_accessor :web_search_queries
@@ -18263,17 +18673,17 @@ module Google
         end
       end
       
-      # Source content flagging uri for a place or review. This is currently populated
-      # only for Google Maps grounding.
+      # A URI that can be used to flag a place or review for inappropriate content.
+      # This is populated only when the grounding source is Google Maps.
       class GoogleCloudAiplatformV1beta1GroundingMetadataSourceFlaggingUri
         include Google::Apis::Core::Hashable
       
-        # A link where users can flag a problem with the source (place or review).
+        # The URI that can be used to flag the content.
         # Corresponds to the JSON property `flagContentUri`
         # @return [String]
         attr_accessor :flag_content_uri
       
-        # Id of the place or review.
+        # The ID of the place or review.
         # Corresponds to the JSON property `sourceId`
         # @return [String]
         attr_accessor :source_id
@@ -18289,27 +18699,30 @@ module Google
         end
       end
       
-      # Grounding support.
+      # A collection of supporting references for a segment of the model's response.
       class GoogleCloudAiplatformV1beta1GroundingSupport
         include Google::Apis::Core::Hashable
       
-        # Confidence score of the support references. Ranges from 0 to 1. 1 is the most
-        # confident. For Gemini 2.0 and before, this list must have the same size as the
-        # grounding_chunk_indices. For Gemini 2.5 and after, this list will be empty and
+        # The confidence scores for the support references. This list is parallel to the
+        # `grounding_chunk_indices` list. A score is a value between 0.0 and 1.0, with a
+        # higher score indicating a higher confidence that the reference supports the
+        # claim. For Gemini 2.0 and before, this list has the same size as `
+        # grounding_chunk_indices`. For Gemini 2.5 and later, this list is empty and
         # should be ignored.
         # Corresponds to the JSON property `confidenceScores`
         # @return [Array<Float>]
         attr_accessor :confidence_scores
       
-        # A list of indices (into 'grounding_chunk') specifying the citations associated
-        # with the claim. For instance [1,3,4] means that grounding_chunk[1],
-        # grounding_chunk[3], grounding_chunk[4] are the retrieved content attributed to
-        # the claim.
+        # A list of indices into the `grounding_chunks` field of the `GroundingMetadata`
+        # message. These indices specify which grounding chunks support the claim made
+        # in the content segment. For example, if this field has the values `[1, 3]`, it
+        # means that `grounding_chunks[1]` and `grounding_chunks[3]` are the sources for
+        # the claim in the content segment.
         # Corresponds to the JSON property `groundingChunkIndices`
         # @return [Array<Fixnum>]
         attr_accessor :grounding_chunk_indices
       
-        # Segment of the content.
+        # A segment of the content.
         # Corresponds to the JSON property `segment`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Segment]
         attr_accessor :segment
@@ -18488,7 +18901,9 @@ module Google
         end
       end
       
-      # Config for image generation features.
+      # Configuration for image generation. This message allows you to control various
+      # aspects of image generation, such as the output format, aspect ratio, and
+      # whether the model can generate images of people.
       class GoogleCloudAiplatformV1beta1ImageConfig
         include Google::Apis::Core::Hashable
       
@@ -18499,6 +18914,16 @@ module Google
         # @return [String]
         attr_accessor :aspect_ratio
       
+        # The image output format for generated images.
+        # Corresponds to the JSON property `imageOutputOptions`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ImageConfigImageOutputOptions]
+        attr_accessor :image_output_options
+      
+        # Optional. Controls whether the model can generate people.
+        # Corresponds to the JSON property `personGeneration`
+        # @return [String]
+        attr_accessor :person_generation
+      
         def initialize(**args)
            update!(**args)
         end
@@ -18506,6 +18931,33 @@ module Google
         # Update properties of this object
         def update!(**args)
           @aspect_ratio = args[:aspect_ratio] if args.key?(:aspect_ratio)
+          @image_output_options = args[:image_output_options] if args.key?(:image_output_options)
+          @person_generation = args[:person_generation] if args.key?(:person_generation)
+        end
+      end
+      
+      # The image output format for generated images.
+      class GoogleCloudAiplatformV1beta1ImageConfigImageOutputOptions
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The compression quality of the output image.
+        # Corresponds to the JSON property `compressionQuality`
+        # @return [Fixnum]
+        attr_accessor :compression_quality
+      
+        # Optional. The image format that the output should be saved as.
+        # Corresponds to the JSON property `mimeType`
+        # @return [String]
+        attr_accessor :mime_type
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @compression_quality = args[:compression_quality] if args.key?(:compression_quality)
+          @mime_type = args[:mime_type] if args.key?(:mime_type)
         end
       end
       
@@ -19907,6 +20359,25 @@ module Google
         end
       end
       
+      # An extracted memory that is the intermediate result before consolidation.
+      class GoogleCloudAiplatformV1beta1IntermediateExtractedMemory
+        include Google::Apis::Core::Hashable
+      
+        # Output only. The fact of the extracted memory.
+        # Corresponds to the JSON property `fact`
+        # @return [String]
+        attr_accessor :fact
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @fact = args[:fact] if args.key?(:fact)
+        end
+      end
+      
       # Request message for [InternalOsServiceStateInstance].
       class GoogleCloudAiplatformV1beta1InternalOsServiceStateInstance
         include Google::Apis::Core::Hashable
@@ -21924,17 +22395,24 @@ module Google
         end
       end
       
-      # Logprobs Result
+      # The log probabilities of the tokens generated by the model. This is useful for
+      # understanding the model's confidence in its predictions and for debugging. For
+      # example, you can use log probabilities to identify when the model is making a
+      # less confident prediction or to explore alternative responses that the model
+      # considered. A low log probability can also indicate that the model is "
+      # hallucinating" or generating factually incorrect information.
       class GoogleCloudAiplatformV1beta1LogprobsResult
         include Google::Apis::Core::Hashable
       
-        # Length = total number of decoding steps. The chosen candidates may or may not
-        # be in top_candidates.
+        # A list of the chosen candidate tokens at each decoding step. The length of
+        # this list is equal to the total number of decoding steps. Note that the chosen
+        # candidate might not be in `top_candidates`.
         # Corresponds to the JSON property `chosenCandidates`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1LogprobsResultCandidate>]
         attr_accessor :chosen_candidates
       
-        # Length = total number of decoding steps.
+        # A list of the top candidate tokens at each decoding step. The length of this
+        # list is equal to the total number of decoding steps.
         # Corresponds to the JSON property `topCandidates`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates>]
         attr_accessor :top_candidates
@@ -21950,21 +22428,27 @@ module Google
         end
       end
       
-      # Candidate for the logprobs token and score.
+      # A single token and its associated log probability.
       class GoogleCloudAiplatformV1beta1LogprobsResultCandidate
         include Google::Apis::Core::Hashable
       
-        # The candidate's log probability.
+        # The log probability of this token. A higher value indicates that the model was
+        # more confident in this token. The log probability can be used to assess the
+        # relative likelihood of different tokens and to identify when the model is
+        # uncertain.
         # Corresponds to the JSON property `logProbability`
         # @return [Float]
         attr_accessor :log_probability
       
-        # The candidate's token string value.
+        # The token's string representation.
         # Corresponds to the JSON property `token`
         # @return [String]
         attr_accessor :token
       
-        # The candidate's token id value.
+        # The token's numerical ID. While the `token` field provides the string
+        # representation of the token, the `token_id` is the numerical representation
+        # that the model uses internally. This can be useful for developers who want to
+        # build custom logic based on the model's vocabulary.
         # Corresponds to the JSON property `tokenId`
         # @return [Fixnum]
         attr_accessor :token_id
@@ -21981,11 +22465,12 @@ module Google
         end
       end
       
-      # Candidates with top log probabilities at each decoding step.
+      # A list of the top candidate tokens and their log probabilities at each
+      # decoding step. This can be used to see what other tokens the model considered.
       class GoogleCloudAiplatformV1beta1LogprobsResultTopCandidates
         include Google::Apis::Core::Hashable
       
-        # Sorted by log probability in descending order.
+        # The list of candidate tokens, sorted by log probability in descending order.
         # Corresponds to the JSON property `candidates`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1LogprobsResultCandidate>]
         attr_accessor :candidates
@@ -22265,6 +22750,12 @@ module Google
         # @return [String]
         attr_accessor :revision_expire_time
       
+        # Optional. Input only. The labels to apply to the Memory Revision created as a
+        # result of this request.
+        # Corresponds to the JSON property `revisionLabels`
+        # @return [Hash<String,String>]
+        attr_accessor :revision_labels
+      
         # Optional. Input only. The TTL for the revision. The expiration time is
         # computed: now + TTL.
         # Corresponds to the JSON property `revisionTtl`
@@ -22278,6 +22769,11 @@ module Google
         # @return [Hash<String,String>]
         attr_accessor :scope
       
+        # Optional. The Topics of the Memory.
+        # Corresponds to the JSON property `topics`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1MemoryTopicId>]
+        attr_accessor :topics
+      
         # Optional. Input only. The TTL for this resource. The expiration time is
         # computed: now + TTL.
         # Corresponds to the JSON property `ttl`
@@ -22303,8 +22799,10 @@ module Google
           @fact = args[:fact] if args.key?(:fact)
           @name = args[:name] if args.key?(:name)
           @revision_expire_time = args[:revision_expire_time] if args.key?(:revision_expire_time)
+          @revision_labels = args[:revision_labels] if args.key?(:revision_labels)
           @revision_ttl = args[:revision_ttl] if args.key?(:revision_ttl)
           @scope = args[:scope] if args.key?(:scope)
+          @topics = args[:topics] if args.key?(:topics)
           @ttl = args[:ttl] if args.key?(:ttl)
           @update_time = args[:update_time] if args.key?(:update_time)
         end
@@ -22399,10 +22897,9 @@ module Google
       class GoogleCloudAiplatformV1beta1MemoryBankCustomizationConfigGenerateMemoriesExampleConversationSourceEvent
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -22529,6 +23026,13 @@ module Google
         # @return [String]
         attr_accessor :expire_time
       
+        # Output only. The extracted memories from the source content before
+        # consolidation when the memory was updated via GenerateMemories. This
+        # information was used to modify an existing Memory via Consolidation.
+        # Corresponds to the JSON property `extractedMemories`
+        # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1IntermediateExtractedMemory>]
+        attr_accessor :extracted_memories
+      
         # Output only. The fact of the Memory Revision. This corresponds to the `fact`
         # field of the parent Memory at the time of revision creation.
         # Corresponds to the JSON property `fact`
@@ -22557,6 +23061,7 @@ module Google
         def update!(**args)
           @create_time = args[:create_time] if args.key?(:create_time)
           @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @extracted_memories = args[:extracted_memories] if args.key?(:extracted_memories)
           @fact = args[:fact] if args.key?(:fact)
           @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
@@ -22803,6 +23308,11 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1BleuSpec]
         attr_accessor :bleu_spec
       
+        # Specificies a metric that is populated by evaluating user-defined Python code.
+        # Corresponds to the JSON property `customCodeExecutionSpec`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1CustomCodeExecutionSpec]
+        attr_accessor :custom_code_execution_spec
+      
         # Spec for exact match metric - returns 1 if prediction and reference exactly
         # matches, otherwise 0.
         # Corresponds to the JSON property `exactMatchSpec`
@@ -22843,6 +23353,7 @@ module Google
         def update!(**args)
           @aggregation_metrics = args[:aggregation_metrics] if args.key?(:aggregation_metrics)
           @bleu_spec = args[:bleu_spec] if args.key?(:bleu_spec)
+          @custom_code_execution_spec = args[:custom_code_execution_spec] if args.key?(:custom_code_execution_spec)
           @exact_match_spec = args[:exact_match_spec] if args.key?(:exact_match_spec)
           @llm_based_metric_spec = args[:llm_based_metric_spec] if args.key?(:llm_based_metric_spec)
           @pairwise_metric_spec = args[:pairwise_metric_spec] if args.key?(:pairwise_metric_spec)
@@ -23413,16 +23924,21 @@ module Google
         end
       end
       
-      # Represents token counting info for a single modality.
+      # Represents a breakdown of token usage by modality. This message is used in
+      # CountTokensResponse and GenerateContentResponse.UsageMetadata to provide a
+      # detailed view of how many tokens are used by each modality (e.g., text, image,
+      # video) in a request. This is particularly useful for multimodal models,
+      # allowing you to track and manage token consumption for billing and quota
+      # purposes.
       class GoogleCloudAiplatformV1beta1ModalityTokenCount
         include Google::Apis::Core::Hashable
       
-        # The modality associated with this token count.
+        # The modality that this token count applies to.
         # Corresponds to the JSON property `modality`
         # @return [String]
         attr_accessor :modality
       
-        # Number of tokens.
+        # The number of tokens counted for this modality.
         # Corresponds to the JSON property `tokenCount`
         # @return [Fixnum]
         attr_accessor :token_count
@@ -23723,17 +24239,29 @@ module Google
         end
       end
       
-      # Configuration for Model Armor integrations of prompt and responses.
+      # Configuration for Model Armor. Model Armor is a Google Cloud service that
+      # provides safety and security filtering for prompts and responses. It helps
+      # protect your AI applications from risks such as harmful content, sensitive
+      # data leakage, and prompt injection attacks.
       class GoogleCloudAiplatformV1beta1ModelArmorConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. The name of the Model Armor template to use for prompt sanitization.
+        # Optional. The resource name of the Model Armor template to use for prompt
+        # screening. A Model Armor template is a set of customized filters and
+        # thresholds that define how Model Armor screens content. If specified, Model
+        # Armor will use this template to check the user's prompt for safety and
+        # security risks before it is sent to the model. The name must be in the format `
+        # projects/`project`/locations/`location`/templates/`template``.
         # Corresponds to the JSON property `promptTemplateName`
         # @return [String]
         attr_accessor :prompt_template_name
       
-        # Optional. The name of the Model Armor template to use for response
-        # sanitization.
+        # Optional. The resource name of the Model Armor template to use for response
+        # screening. A Model Armor template is a set of customized filters and
+        # thresholds that define how Model Armor screens content. If specified, Model
+        # Armor will use this template to check the model's response for safety and
+        # security risks before it is returned to the user. The name must be in the
+        # format `projects/`project`/locations/`location`/templates/`template``.
         # Corresponds to the JSON property `responseTemplateName`
         # @return [String]
         attr_accessor :response_template_name
@@ -26474,8 +27002,7 @@ module Google
         end
       end
       
-      # Configuration for a multi-speaker text-to-speech setup. Enables the use of up
-      # to two distinct voices in a single synthesis request.
+      # Configuration for a multi-speaker text-to-speech request.
       class GoogleCloudAiplatformV1beta1MultiSpeakerVoiceConfig
         include Google::Apis::Core::Hashable
       
@@ -28279,14 +28806,18 @@ module Google
       class GoogleCloudAiplatformV1beta1OptimizePromptRequest
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
       
+        # Optional. The target model to optimize the prompt for.
+        # Corresponds to the JSON property `optimizationTarget`
+        # @return [String]
+        attr_accessor :optimization_target
+      
         def initialize(**args)
            update!(**args)
         end
@@ -28294,6 +28825,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @content = args[:content] if args.key?(:content)
+          @optimization_target = args[:optimization_target] if args.key?(:optimization_target)
         end
       end
       
@@ -28301,10 +28833,9 @@ module Google
       class GoogleCloudAiplatformV1beta1OptimizePromptResponse
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -28824,11 +29355,11 @@ module Google
         end
       end
       
-      # A datatype containing media that is part of a multi-part `Content` message. A `
+      # A datatype containing media that is part of a multi-part Content message. A `
       # Part` consists of data which has an associated datatype. A `Part` can only
-      # contain one of the accepted types in `Part.data`. A `Part` must have a fixed
-      # IANA MIME type identifying the type and subtype of the media if `inline_data`
-      # or `file_data` field is filled with raw bytes.
+      # contain one of the accepted types in `Part.data`. For media types that are not
+      # text, `Part` must have a fixed IANA MIME type identifying the type and subtype
+      # of the media if `inline_data` or `file_data` field is filled with raw bytes.
       class GoogleCloudAiplatformV1beta1Part
         include Google::Apis::Core::Hashable
       
@@ -28847,7 +29378,9 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ExecutableCode]
         attr_accessor :executable_code
       
-        # URI based data.
+        # URI-based data. A FileData message contains a URI pointing to data of a
+        # specific media type. It is used to represent images, audio, and video stored
+        # in Google Cloud Storage.
         # Corresponds to the JSON property `fileData`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1FileData]
         attr_accessor :file_data
@@ -28867,17 +29400,19 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1FunctionResponse]
         attr_accessor :function_response
       
-        # Content blob.
+        # A content blob. A Blob contains data of a specific media type. It is used to
+        # represent images, audio, and video.
         # Corresponds to the JSON property `inlineData`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Blob]
         attr_accessor :inline_data
       
-        # Optional. Text part (can be code).
+        # Optional. The text content of the part.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
       
-        # Optional. Indicates if the part is thought from the model.
+        # Optional. Indicates whether the `part` represents the model's thought process
+        # or reasoning.
         # Corresponds to the JSON property `thought`
         # @return [Boolean]
         attr_accessor :thought
@@ -28890,7 +29425,8 @@ module Google
         # @return [String]
         attr_accessor :thought_signature
       
-        # Metadata describes the input video content.
+        # Provides metadata for a video, including the start and end offsets for
+        # clipping and the frame rate.
         # Corresponds to the JSON property `videoMetadata`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1VideoMetadata]
         attr_accessor :video_metadata
@@ -30109,11 +30645,11 @@ module Google
         end
       end
       
-      # The configuration for the prebuilt speaker to use.
+      # Configuration for a prebuilt voice.
       class GoogleCloudAiplatformV1beta1PrebuiltVoiceConfig
         include Google::Apis::Core::Hashable
       
-        # The name of the preset voice to use.
+        # The name of the prebuilt voice to use.
         # Corresponds to the JSON property `voiceName`
         # @return [String]
         attr_accessor :voice_name
@@ -30558,11 +31094,6 @@ module Google
       class GoogleCloudAiplatformV1beta1PreferenceOptimizationSpec
         include Google::Apis::Core::Hashable
       
-        # Evaluation Config for Tuning Job.
-        # Corresponds to the JSON property `evaluationConfig`
-        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1EvaluationConfig]
-        attr_accessor :evaluation_config
-      
         # Optional. If set to true, disable intermediate checkpoints for Preference
         # Optimization and only the last checkpoint will be exported. Otherwise, enable
         # intermediate checkpoints for Preference Optimization. Default is false.
@@ -30594,7 +31125,6 @@ module Google
       
         # Update properties of this object
         def update!(**args)
-          @evaluation_config = args[:evaluation_config] if args.key?(:evaluation_config)
           @export_last_checkpoint_only = args[:export_last_checkpoint_only] if args.key?(:export_last_checkpoint_only)
           @hyper_parameters = args[:hyper_parameters] if args.key?(:hyper_parameters)
           @training_dataset_uri = args[:training_dataset_uri] if args.key?(:training_dataset_uri)
@@ -32702,6 +33232,18 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1RagVectorDbConfig]
         attr_accessor :rag_vector_db_config
       
+        # Output only. Reserved for future use.
+        # Corresponds to the JSON property `satisfiesPzi`
+        # @return [Boolean]
+        attr_accessor :satisfies_pzi
+        alias_method :satisfies_pzi?, :satisfies_pzi
+      
+        # Output only. Reserved for future use.
+        # Corresponds to the JSON property `satisfiesPzs`
+        # @return [Boolean]
+        attr_accessor :satisfies_pzs
+        alias_method :satisfies_pzs?, :satisfies_pzs
+      
         # Output only. Timestamp when this RagCorpus was last updated.
         # Corresponds to the JSON property `updateTime`
         # @return [String]
@@ -32733,6 +33275,8 @@ module Google
           @rag_embedding_model_config = args[:rag_embedding_model_config] if args.key?(:rag_embedding_model_config)
           @rag_files_count = args[:rag_files_count] if args.key?(:rag_files_count)
           @rag_vector_db_config = args[:rag_vector_db_config] if args.key?(:rag_vector_db_config)
+          @satisfies_pzi = args[:satisfies_pzi] if args.key?(:satisfies_pzi)
+          @satisfies_pzs = args[:satisfies_pzs] if args.key?(:satisfies_pzs)
           @update_time = args[:update_time] if args.key?(:update_time)
           @vector_db_config = args[:vector_db_config] if args.key?(:vector_db_config)
           @vertex_ai_search_config = args[:vertex_ai_search_config] if args.key?(:vertex_ai_search_config)
@@ -34622,6 +35166,13 @@ module Google
       class GoogleCloudAiplatformV1beta1ReasoningEngineSpec
         include Google::Apis::Core::Hashable
       
+        # Optional. The A2A Agent Card for the agent (if available). It follows the
+        # specification at https://a2a-protocol.org/latest/specification/#5-agent-
+        # discovery-the-agent-card.
+        # Corresponds to the JSON property `agentCard`
+        # @return [Hash<String,Object>]
+        attr_accessor :agent_card
+      
         # Optional. The OSS agent framework used to develop the agent. Currently
         # supported values: "google-adk", "langchain", "langgraph", "ag2", "llama-index",
         # "custom".
@@ -34640,6 +35191,23 @@ module Google
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ReasoningEngineSpecDeploymentSpec]
         attr_accessor :deployment_spec
       
+        # Output only. The identity to use for the Reasoning Engine. It can contain one
+        # of the following values: * service-`project`@gcp-sa-aiplatform-re.googleapis.
+        # com (for SERVICE_AGENT identity type) * `name`@`project`.gserviceaccount.com (
+        # for SERVICE_ACCOUNT identity type) * agents.global.`org`.system.id.goog/
+        # resources/aiplatform/projects/`project`/locations/`location`/reasoningEngines/`
+        # reasoning_engine` (for AGENT_IDENTITY identity type)
+        # Corresponds to the JSON property `effectiveIdentity`
+        # @return [String]
+        attr_accessor :effective_identity
+      
+        # Optional. The identity type to use for the Reasoning Engine. If not specified,
+        # the `service_account` field will be used if set, otherwise the default Vertex
+        # AI Reasoning Engine Service Agent in the project will be used.
+        # Corresponds to the JSON property `identityType`
+        # @return [String]
+        attr_accessor :identity_type
+      
         # User-provided package specification, containing pickled object and package
         # requirements.
         # Corresponds to the JSON property `packageSpec`
@@ -34655,17 +35223,26 @@ module Google
         # @return [String]
         attr_accessor :service_account
       
+        # Specification for deploying from source code.
+        # Corresponds to the JSON property `sourceCodeSpec`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpec]
+        attr_accessor :source_code_spec
+      
         def initialize(**args)
            update!(**args)
         end
       
         # Update properties of this object
         def update!(**args)
+          @agent_card = args[:agent_card] if args.key?(:agent_card)
           @agent_framework = args[:agent_framework] if args.key?(:agent_framework)
           @class_methods = args[:class_methods] if args.key?(:class_methods)
           @deployment_spec = args[:deployment_spec] if args.key?(:deployment_spec)
+          @effective_identity = args[:effective_identity] if args.key?(:effective_identity)
+          @identity_type = args[:identity_type] if args.key?(:identity_type)
           @package_spec = args[:package_spec] if args.key?(:package_spec)
           @service_account = args[:service_account] if args.key?(:service_account)
+          @source_code_spec = args[:source_code_spec] if args.key?(:source_code_spec)
         end
       end
       
@@ -34759,8 +35336,8 @@ module Google
         # @return [String]
         attr_accessor :pickle_object_gcs_uri
       
-        # Optional. The Python version. Currently support 3.8, 3.9, 3.10, 3.11. If not
-        # specified, default value is 3.10.
+        # Optional. The Python version. Supported values are 3.9, 3.10, 3.11, 3.12, 3.13.
+        # If not specified, the default value is 3.10.
         # Corresponds to the JSON property `pythonVersion`
         # @return [String]
         attr_accessor :python_version
@@ -34783,6 +35360,95 @@ module Google
         end
       end
       
+      # Specification for deploying from source code.
+      class GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpec
+        include Google::Apis::Core::Hashable
+      
+        # Specifies source code provided as a byte stream.
+        # Corresponds to the JSON property `inlineSource`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource]
+        attr_accessor :inline_source
+      
+        # Specification for running a Python application from source.
+        # Corresponds to the JSON property `pythonSpec`
+        # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecPythonSpec]
+        attr_accessor :python_spec
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @inline_source = args[:inline_source] if args.key?(:inline_source)
+          @python_spec = args[:python_spec] if args.key?(:python_spec)
+        end
+      end
+      
+      # Specifies source code provided as a byte stream.
+      class GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecInlineSource
+        include Google::Apis::Core::Hashable
+      
+        # Required. Input only. The application source code archive, provided as a
+        # compressed tarball (.tar.gz) file.
+        # Corresponds to the JSON property `sourceArchive`
+        # NOTE: Values are automatically base64 encoded/decoded in the client library.
+        # @return [String]
+        attr_accessor :source_archive
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @source_archive = args[:source_archive] if args.key?(:source_archive)
+        end
+      end
+      
+      # Specification for running a Python application from source.
+      class GoogleCloudAiplatformV1beta1ReasoningEngineSpecSourceCodeSpecPythonSpec
+        include Google::Apis::Core::Hashable
+      
+        # Optional. The Python module to load as the entrypoint, specified as a fully
+        # qualified module name. For example: path.to.agent. If not specified, defaults
+        # to "agent". The project root will be added to Python sys.path, allowing
+        # imports to be specified relative to the root.
+        # Corresponds to the JSON property `entrypointModule`
+        # @return [String]
+        attr_accessor :entrypoint_module
+      
+        # Optional. The name of the callable object within the `entrypoint_module` to
+        # use as the application If not specified, defaults to "root_agent".
+        # Corresponds to the JSON property `entrypointObject`
+        # @return [String]
+        attr_accessor :entrypoint_object
+      
+        # Optional. The path to the requirements file, relative to the source root. If
+        # not specified, defaults to "requirements.txt".
+        # Corresponds to the JSON property `requirementsFile`
+        # @return [String]
+        attr_accessor :requirements_file
+      
+        # Optional. The version of Python to use. Support version includes 3.9, 3.10, 3.
+        # 11, 3.12, 3.13. If not specified, default value is 3.10.
+        # Corresponds to the JSON property `version`
+        # @return [String]
+        attr_accessor :version
+      
+        def initialize(**args)
+           update!(**args)
+        end
+      
+        # Update properties of this object
+        def update!(**args)
+          @entrypoint_module = args[:entrypoint_module] if args.key?(:entrypoint_module)
+          @entrypoint_object = args[:entrypoint_object] if args.key?(:entrypoint_object)
+          @requirements_file = args[:requirements_file] if args.key?(:requirements_file)
+          @version = args[:version] if args.key?(:version)
+        end
+      end
+      
       # Request message for GenAiTuningService.RebaseTunedModel.
       class GoogleCloudAiplatformV1beta1RebaseTunedModelRequest
         include Google::Apis::Core::Hashable
@@ -35542,15 +36208,17 @@ module Google
         end
       end
       
-      # Metadata related to retrieval in the grounding flow.
+      # Metadata related to the retrieval grounding source. This is part of the `
+      # GroundingMetadata` returned when grounding is enabled.
       class GoogleCloudAiplatformV1beta1RetrievalMetadata
         include Google::Apis::Core::Hashable
       
-        # Optional. Score indicating how likely information from Google Search could
-        # help answer the prompt. The score is in the range `[0, 1]`, where 0 is the
-        # least likely and 1 is the most likely. This score is only populated when
-        # Google Search grounding and dynamic retrieval is enabled. It will be compared
-        # to the threshold to determine whether to trigger Google Search.
+        # Optional. A score indicating how likely it is that a Google Search query could
+        # help answer the prompt. The score is in the range of `[0, 1]`. A score of 1
+        # means the model is confident that a search will be helpful, and 0 means it is
+        # not. This score is populated only when Google Search grounding and dynamic
+        # retrieval are enabled. The score is used to determine whether to trigger a
+        # search.
         # Corresponds to the JSON property `googleSearchDynamicRetrievalScore`
         # @return [Float]
         attr_accessor :google_search_dynamic_retrieval_score
@@ -35673,6 +36341,13 @@ module Google
       class GoogleCloudAiplatformV1beta1RetrieveMemoriesRequest
         include Google::Apis::Core::Hashable
       
+        # Optional. The standard list filter that will be applied to the retrieved
+        # memories. More detail in [AIP-160](https://google.aip.dev/160). Supported
+        # fields: * `fact` * `create_time` * `update_time`
+        # Corresponds to the JSON property `filter`
+        # @return [String]
+        attr_accessor :filter
+      
         # Required. The scope of the memories to retrieve. A memory must have exactly
         # the same scope (`Memory.scope`) as the scope provided here to be retrieved (
         # same keys and values). Order does not matter, but it is case-sensitive.
@@ -35696,6 +36371,7 @@ module Google
       
         # Update properties of this object
         def update!(**args)
+          @filter = args[:filter] if args.key?(:filter)
           @scope = args[:scope] if args.key?(:scope)
           @similarity_search_params = args[:similarity_search_params] if args.key?(:similarity_search_params)
           @simple_retrieval_params = args[:simple_retrieval_params] if args.key?(:simple_retrieval_params)
@@ -36507,18 +37183,18 @@ module Google
         end
       end
       
-      # Safety rating corresponding to the generated content.
+      # A safety rating for a piece of content. The safety rating contains the harm
+      # category and the harm probability level.
       class GoogleCloudAiplatformV1beta1SafetyRating
         include Google::Apis::Core::Hashable
       
-        # Output only. Indicates whether the content was filtered out because of this
-        # rating.
+        # Output only. Indicates whether the content was blocked because of this rating.
         # Corresponds to the JSON property `blocked`
         # @return [Boolean]
         attr_accessor :blocked
         alias_method :blocked?, :blocked
       
-        # Output only. Harm category.
+        # Output only. The harm category of this rating.
         # Corresponds to the JSON property `category`
         # @return [String]
         attr_accessor :category
@@ -36530,22 +37206,22 @@ module Google
         # @return [String]
         attr_accessor :overwritten_threshold
       
-        # Output only. Harm probability levels in the content.
+        # Output only. The probability of harm for this category.
         # Corresponds to the JSON property `probability`
         # @return [String]
         attr_accessor :probability
       
-        # Output only. Harm probability score.
+        # Output only. The probability score of harm for this category.
         # Corresponds to the JSON property `probabilityScore`
         # @return [Float]
         attr_accessor :probability_score
       
-        # Output only. Harm severity levels in the content.
+        # Output only. The severity of harm for this category.
         # Corresponds to the JSON property `severity`
         # @return [String]
         attr_accessor :severity
       
-        # Output only. Harm severity score.
+        # Output only. The severity score of harm for this category.
         # Corresponds to the JSON property `severityScore`
         # @return [Float]
         attr_accessor :severity_score
@@ -36597,22 +37273,24 @@ module Google
         end
       end
       
-      # Safety settings.
+      # A safety setting that affects the safety-blocking behavior. A SafetySetting
+      # consists of a harm category and a threshold for that category.
       class GoogleCloudAiplatformV1beta1SafetySetting
         include Google::Apis::Core::Hashable
       
-        # Required. Harm category.
+        # Required. The harm category to be blocked.
         # Corresponds to the JSON property `category`
         # @return [String]
         attr_accessor :category
       
-        # Optional. Specify if the threshold is used for probability or severity score.
-        # If not specified, the threshold is used for probability score.
+        # Optional. The method for blocking content. If not specified, the default
+        # behavior is to use the probability score.
         # Corresponds to the JSON property `method`
         # @return [String]
         attr_accessor :method_prop
       
-        # Required. The harm block threshold.
+        # Required. The threshold for blocking content. If the harm probability exceeds
+        # this threshold, the content will be blocked.
         # Corresponds to the JSON property `threshold`
         # @return [String]
         attr_accessor :threshold
@@ -40237,7 +40915,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content>]
         attr_accessor :contents
       
-        # Generation config.
+        # Configuration for content generation. This message contains all the parameters
+        # that control how the model generates content. It allows you to influence the
+        # randomness, length, and structure of the output.
         # Corresponds to the JSON property `generationConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1GenerationConfig]
         attr_accessor :generation_config
@@ -40253,10 +40933,9 @@ module Google
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1SafetySetting>]
         attr_accessor :safety_settings
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `systemInstruction`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :system_instruction
@@ -40338,10 +41017,9 @@ module Google
       class GoogleCloudAiplatformV1beta1SchemaPromptSpecStructuredPrompt
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `context`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :context
@@ -44111,17 +44789,23 @@ module Google
         end
       end
       
-      # Google search entry point.
+      # An entry point for displaying Google Search results. A `SearchEntryPoint` is
+      # populated when the grounding source for a model's response is Google Search.
+      # It provides information that you can use to display the search results in your
+      # application.
       class GoogleCloudAiplatformV1beta1SearchEntryPoint
         include Google::Apis::Core::Hashable
       
-        # Optional. Web content snippet that can be embedded in a web page or an app
-        # webview.
+        # Optional. An HTML snippet that can be embedded in a web page or an application'
+        # s webview. This snippet displays a search result, including the title, URL,
+        # and a brief description of the search result.
         # Corresponds to the JSON property `renderedContent`
         # @return [String]
         attr_accessor :rendered_content
       
-        # Optional. Base64 encoded JSON representing array of tuple.
+        # Optional. A base64-encoded JSON object that contains a list of search queries
+        # and their corresponding search URLs. This information can be used to build a
+        # custom search UI.
         # Corresponds to the JSON property `sdkBlob`
         # NOTE: Values are automatically base64 encoded/decoded in the client library.
         # @return [String]
@@ -44740,28 +45424,31 @@ module Google
         end
       end
       
-      # Segment of the content.
+      # A segment of the content.
       class GoogleCloudAiplatformV1beta1Segment
         include Google::Apis::Core::Hashable
       
-        # Output only. End index in the given Part, measured in bytes. Offset from the
-        # start of the Part, exclusive, starting at zero.
+        # Output only. The end index of the segment in the `Part`, measured in bytes.
+        # This marks the end of the segment and is exclusive, meaning the segment
+        # includes content up to, but not including, the byte at this index.
         # Corresponds to the JSON property `endIndex`
         # @return [Fixnum]
         attr_accessor :end_index
       
-        # Output only. The index of a Part object within its parent Content object.
+        # Output only. The index of the `Part` object that this segment belongs to. This
+        # is useful for associating the segment with a specific part of the content.
         # Corresponds to the JSON property `partIndex`
         # @return [Fixnum]
         attr_accessor :part_index
       
-        # Output only. Start index in the given Part, measured in bytes. Offset from the
-        # start of the Part, inclusive, starting at zero.
+        # Output only. The start index of the segment in the `Part`, measured in bytes.
+        # This marks the beginning of the segment and is inclusive, meaning the byte at
+        # this index is the first byte of the segment.
         # Corresponds to the JSON property `startIndex`
         # @return [Fixnum]
         attr_accessor :start_index
       
-        # Output only. The text corresponding to the segment from the response.
+        # Output only. The text of the segment.
         # Corresponds to the JSON property `text`
         # @return [String]
         attr_accessor :text
@@ -44834,6 +45521,15 @@ module Google
         # @return [String]
         attr_accessor :expire_time
       
+        # The labels with user-defined metadata to organize your Sessions. Label keys
+        # and values can be no longer than 64 characters (Unicode codepoints), can only
+        # contain lowercase letters, numeric characters, underscores and dashes.
+        # International characters are allowed. See https://goo.gl/xmQnxf for more
+        # information and examples of labels.
+        # Corresponds to the JSON property `labels`
+        # @return [Hash<String,String>]
+        attr_accessor :labels
+      
         # Identifier. The resource name of the session. Format: 'projects/`project`/
         # locations/`location`/reasoningEngines/`reasoning_engine`/sessions/`session`'.
         # Corresponds to the JSON property `name`
@@ -44869,6 +45565,7 @@ module Google
           @create_time = args[:create_time] if args.key?(:create_time)
           @display_name = args[:display_name] if args.key?(:display_name)
           @expire_time = args[:expire_time] if args.key?(:expire_time)
+          @labels = args[:labels] if args.key?(:labels)
           @name = args[:name] if args.key?(:name)
           @session_state = args[:session_state] if args.key?(:session_state)
           @ttl = args[:ttl] if args.key?(:ttl)
@@ -44891,10 +45588,9 @@ module Google
         # @return [String]
         attr_accessor :author
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -45206,7 +45902,7 @@ module Google
         end
       end
       
-      # Configuration for a single speaker in a multi speaker setup.
+      # Configuration for a single speaker in a multi-speaker setup.
       class GoogleCloudAiplatformV1beta1SpeakerVoiceConfig
         include Google::Apis::Core::Hashable
       
@@ -45216,7 +45912,7 @@ module Google
         # @return [String]
         attr_accessor :speaker
       
-        # The configuration for the voice to use.
+        # Configuration for a voice.
         # Corresponds to the JSON property `voiceConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1VoiceConfig]
         attr_accessor :voice_config
@@ -45363,22 +46059,21 @@ module Google
         end
       end
       
-      # The speech generation config.
+      # Configuration for speech generation.
       class GoogleCloudAiplatformV1beta1SpeechConfig
         include Google::Apis::Core::Hashable
       
-        # Optional. Language code (ISO 639. e.g. en-US) for the speech synthesization.
+        # Optional. The language code (ISO 639-1) for the speech synthesis.
         # Corresponds to the JSON property `languageCode`
         # @return [String]
         attr_accessor :language_code
       
-        # Configuration for a multi-speaker text-to-speech setup. Enables the use of up
-        # to two distinct voices in a single synthesis request.
+        # Configuration for a multi-speaker text-to-speech request.
         # Corresponds to the JSON property `multiSpeakerVoiceConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1MultiSpeakerVoiceConfig]
         attr_accessor :multi_speaker_voice_config
       
-        # The configuration for the voice to use.
+        # Configuration for a voice.
         # Corresponds to the JSON property `voiceConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1VoiceConfig]
         attr_accessor :voice_config
@@ -47604,10 +48299,9 @@ module Google
       class GoogleCloudAiplatformV1beta1SyntheticField
         include Google::Apis::Core::Hashable
       
-        # The base structured datatype containing multi-part content of a message. A `
-        # Content` includes a `role` field designating the producer of the `Content` and
-        # a `parts` field containing multi-part data that contains the content of the
-        # message turn.
+        # The structured data content of a message. A Content message contains a `role`
+        # field, which indicates the producer of the content, and a `parts` field, which
+        # contains the multi-part data of the message.
         # Corresponds to the JSON property `content`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1Content]
         attr_accessor :content
@@ -48612,11 +49306,12 @@ module Google
         # @return [String]
         attr_accessor :environment
       
-        # 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. By default, [predefined functions](https://cloud.google.com/vertex-
+        # ai/generative-ai/docs/computer-use#supported-actions) 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.
         # Corresponds to the JSON property `excludedPredefinedFunctions`
         # @return [Array<String>]
         attr_accessor :excluded_predefined_functions
@@ -51268,11 +51963,13 @@ module Google
         end
       end
       
-      # Metadata related to url context retrieval tool.
+      # Metadata returned when the model uses the `url_context` tool to get
+      # information from a user-provided URL.
       class GoogleCloudAiplatformV1beta1UrlContextMetadata
         include Google::Apis::Core::Hashable
       
-        # Output only. List of url context.
+        # Output only. A list of URL metadata, with one entry for each URL retrieved by
+        # the tool.
         # Corresponds to the JSON property `urlMetadata`
         # @return [Array<Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1UrlMetadata>]
         attr_accessor :url_metadata
@@ -51287,16 +51984,16 @@ module Google
         end
       end
       
-      # Context of the a single url retrieval.
+      # The metadata for a single URL retrieval.
       class GoogleCloudAiplatformV1beta1UrlMetadata
         include Google::Apis::Core::Hashable
       
-        # Retrieved url by the tool.
+        # The URL retrieved by the tool.
         # Corresponds to the JSON property `retrievedUrl`
         # @return [String]
         attr_accessor :retrieved_url
       
-        # Status of the url retrieval.
+        # The status of the URL retrieval.
         # Corresponds to the JSON property `urlRetrievalStatus`
         # @return [String]
         attr_accessor :url_retrieval_status
@@ -51727,7 +52424,8 @@ module Google
         end
       end
       
-      # Metadata describes the input video content.
+      # Provides metadata for a video, including the start and end offsets for
+      # clipping and the frame rate.
       class GoogleCloudAiplatformV1beta1VideoMetadata
         include Google::Apis::Core::Hashable
       
@@ -51737,7 +52435,7 @@ module Google
         attr_accessor :end_offset
       
         # Optional. The frame rate of the video sent to the model. If not specified, the
-        # default value will be 1.0. The fps range is (0.0, 24.0].
+        # default value is 1.0. The valid range is (0.0, 24.0].
         # Corresponds to the JSON property `fps`
         # @return [Float]
         attr_accessor :fps
@@ -51759,11 +52457,11 @@ module Google
         end
       end
       
-      # The configuration for the voice to use.
+      # Configuration for a voice.
       class GoogleCloudAiplatformV1beta1VoiceConfig
         include Google::Apis::Core::Hashable
       
-        # The configuration for the prebuilt speaker to use.
+        # Configuration for a prebuilt voice.
         # Corresponds to the JSON property `prebuiltVoiceConfig`
         # @return [Google::Apis::AiplatformV1beta1::GoogleCloudAiplatformV1beta1PrebuiltVoiceConfig]
         attr_accessor :prebuilt_voice_config