google-cloud-ai_platform-v1 0.35.0 → 0.36.0

data/proto_docs/google/cloud/aiplatform/v1/model_monitoring.rb

@@ -205,6 +205,7 @@ module Google
           end
         end
 
+        # The alert config for model monitoring.
         # @!attribute [rw] email_alert_config
         #   @return [::Google::Cloud::AIPlatform::V1::ModelMonitoringAlertConfig::EmailAlertConfig]
         #     Email alert config.

data/proto_docs/google/cloud/aiplatform/v1/model_service.rb

@@ -46,10 +46,10 @@ module Google
         #     Optional. The user-provided custom service account to use to do the model
         #     upload. If empty, [Vertex AI Service
         #     Agent](https://cloud.google.com/vertex-ai/docs/general/access-control#service-agents)
-        #     will be used. Users uploading the Model must have the
-        #     `iam.serviceAccounts.actAs` permission on this service account. Also, this
-        #     account must belong to the project specified in the `parent` field and have
-        #     all necessary read permissions.
+        #     will be used to access resources needed to upload the model. This account
+        #     must belong to the target project where the model is uploaded to, i.e., the
+        #     project specified in the `parent` field of this request and have necessary
+        #     read permissions (to Google Cloud Storage, Artifact Registry, etc.).
         class UploadModelRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/cloud/aiplatform/v1/nas_job.rb

@@ -72,6 +72,7 @@ module Google
         #     If this is set, then all resources created by the NasJob
         #     will be encrypted with the provided encryption key.
         # @!attribute [rw] enable_restricted_image_training
+        #   @deprecated This field is deprecated and may be removed in the next major version update.
         #   @return [::Boolean]
         #     Optional. Enable a separation of Custom model training
         #     and restricted image training for tenant project.

data/proto_docs/google/cloud/aiplatform/v1/openapi.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AIPlatform
+      module V1
+        # Schema is used to define the format of input/output data. Represents a select
+        # subset of an [OpenAPI 3.0 schema
+        # object](https://spec.openapis.org/oas/v3.0.3#schema). More fields may be
+        # added in the future as needed.
+        # @!attribute [rw] type
+        #   @return [::Google::Cloud::AIPlatform::V1::Type]
+        #     Optional. The type of the data.
+        # @!attribute [rw] format
+        #   @return [::String]
+        #     Optional. The format of the data.
+        #     Supported formats:
+        #      for NUMBER type: float, double
+        #      for INTEGER type: int32, int64
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. The description of the data.
+        # @!attribute [rw] nullable
+        #   @return [::Boolean]
+        #     Optional. Indicates if the value may be null.
+        # @!attribute [rw] items
+        #   @return [::Google::Cloud::AIPlatform::V1::Schema]
+        #     Optional. Schema of the elements of Type.ARRAY.
+        # @!attribute [rw] enum
+        #   @return [::Array<::String>]
+        #     Optional. Possible values of the element of Type.STRING with enum format.
+        #     For example we can define an Enum Direction as :
+        #     \\{type:STRING, format:enum, enum:["EAST", NORTH", "SOUTH", "WEST"]}
+        # @!attribute [rw] properties
+        #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::AIPlatform::V1::Schema}]
+        #     Optional. Properties of Type.OBJECT.
+        # @!attribute [rw] required
+        #   @return [::Array<::String>]
+        #     Optional. Required properties of Type.OBJECT.
+        # @!attribute [rw] example
+        #   @return [::Google::Protobuf::Value]
+        #     Optional. Example of the object. Will only populated when the object is the
+        #     root.
+        class Schema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # @!attribute [rw] key
+          #   @return [::String]
+          # @!attribute [rw] value
+          #   @return [::Google::Cloud::AIPlatform::V1::Schema]
+          class PropertiesEntry
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # Type contains the list of OpenAPI data types as defined by
+        # https://swagger.io/docs/specification/data-models/data-types/
+        module Type
+          # Not specified, should not be used.
+          TYPE_UNSPECIFIED = 0
+
+          # OpenAPI string type
+          STRING = 1
+
+          # OpenAPI number type
+          NUMBER = 2
+
+          # OpenAPI integer type
+          INTEGER = 3
+
+          # OpenAPI boolean type
+          BOOLEAN = 4
+
+          # OpenAPI array type
+          ARRAY = 5
+
+          # OpenAPI object type
+          OBJECT = 6
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/cloud/aiplatform/v1/pipeline_job.rb

@@ -132,6 +132,7 @@ module Google
 
           # The runtime config of a PipelineJob.
           # @!attribute [rw] parameters
+          #   @deprecated This field is deprecated and may be removed in the next major version update.
           #   @return [::Google::Protobuf::Map{::String => ::Google::Cloud::AIPlatform::V1::Value}]
           #     Deprecated. Use
           #     {::Google::Cloud::AIPlatform::V1::PipelineJob::RuntimeConfig#parameter_values RuntimeConfig.parameter_values}

data/proto_docs/google/cloud/aiplatform/v1/prediction_service.rb

@@ -114,6 +114,21 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#stream_raw_predict PredictionService.StreamRawPredict}.
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     Required. The name of the Endpoint requested to serve the prediction.
+        #     Format:
+        #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+        # @!attribute [rw] http_body
+        #   @return [::Google::Api::HttpBody]
+        #     The prediction input. Supports HTTP headers and arbitrary data payload.
+        class StreamRawPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for
         # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#direct_predict PredictionService.DirectPredict}.
         # @!attribute [rw] endpoint
@@ -179,6 +194,87 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#stream_direct_predict PredictionService.StreamDirectPredict}.
+        #
+        # The first message must contain
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectPredictRequest#endpoint endpoint}
+        # field and optionally [input][]. The subsequent messages must contain
+        # [input][].
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     Required. The name of the Endpoint requested to serve the prediction.
+        #     Format:
+        #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+        # @!attribute [rw] inputs
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Tensor>]
+        #     Optional. The prediction input.
+        # @!attribute [rw] parameters
+        #   @return [::Google::Cloud::AIPlatform::V1::Tensor]
+        #     Optional. The parameters that govern the prediction.
+        class StreamDirectPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#stream_direct_predict PredictionService.StreamDirectPredict}.
+        # @!attribute [rw] outputs
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Tensor>]
+        #     The prediction output.
+        # @!attribute [rw] parameters
+        #   @return [::Google::Cloud::AIPlatform::V1::Tensor]
+        #     The parameters that govern the prediction.
+        class StreamDirectPredictResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#stream_direct_raw_predict PredictionService.StreamDirectRawPredict}.
+        #
+        # The first message must contain
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectRawPredictRequest#endpoint endpoint}
+        # and
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectRawPredictRequest#method_name method_name}
+        # fields and optionally
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectRawPredictRequest#input input}. The
+        # subsequent messages must contain
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectRawPredictRequest#input input}.
+        # {::Google::Cloud::AIPlatform::V1::StreamDirectRawPredictRequest#method_name method_name}
+        # in the subsequent messages have no effect.
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     Required. The name of the Endpoint requested to serve the prediction.
+        #     Format:
+        #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+        # @!attribute [rw] method_name
+        #   @return [::String]
+        #     Optional. Fully qualified name of the API method being invoked to perform
+        #     predictions.
+        #
+        #     Format:
+        #     `/namespace.Service/Method/`
+        #     Example:
+        #     `/tensorflow.serving.PredictionService/Predict`
+        # @!attribute [rw] input
+        #   @return [::String]
+        #     Optional. The prediction input.
+        class StreamDirectRawPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#stream_direct_raw_predict PredictionService.StreamDirectRawPredict}.
+        # @!attribute [rw] output
+        #   @return [::String]
+        #     The prediction output.
+        class StreamDirectRawPredictResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for
         # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#streaming_predict PredictionService.StreamingPredict}.
         #
@@ -333,10 +429,18 @@ module Google
         #     Required. The name of the Endpoint requested to perform token counting.
         #     Format:
         #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+        # @!attribute [rw] model
+        #   @return [::String]
+        #     Required. The name of the publisher model requested to serve the
+        #     prediction. Format:
+        #     `projects/{project}/locations/{location}/publishers/*/models/*`
         # @!attribute [rw] instances
         #   @return [::Array<::Google::Protobuf::Value>]
         #     Required. The instances that are the input to token counting call.
         #     Schema is identical to the prediction schema of the underlying model.
+        # @!attribute [rw] contents
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Content>]
+        #     Required. Input content.
         class CountTokensRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -354,6 +458,97 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for [PredictionService.GenerateContent].
+        # @!attribute [rw] model
+        #   @return [::String]
+        #     Required. The name of the publisher model requested to serve the
+        #     prediction. Format:
+        #     `projects/{project}/locations/{location}/publishers/*/models/*`
+        # @!attribute [rw] contents
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Content>]
+        #     Required. The content of the current conversation with the model.
+        #
+        #     For single-turn queries, this is a single instance. For multi-turn queries,
+        #     this is a repeated field that contains conversation history + latest
+        #     request.
+        # @!attribute [rw] tools
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Tool>]
+        #     Optional. A list of `Tools` the model may use to generate the next
+        #     response.
+        #
+        #     A `Tool` is a piece of code that enables the system to interact with
+        #     external systems to perform an action, or set of actions, outside of
+        #     knowledge and scope of the model.
+        # @!attribute [rw] safety_settings
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::SafetySetting>]
+        #     Optional. Per request settings for blocking unsafe content.
+        #     Enforced on GenerateContentResponse.candidates.
+        # @!attribute [rw] generation_config
+        #   @return [::Google::Cloud::AIPlatform::V1::GenerationConfig]
+        #     Optional. Generation config.
+        class GenerateContentRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for [PredictionService.GenerateContent].
+        # @!attribute [r] candidates
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Candidate>]
+        #     Output only. Generated candidates.
+        # @!attribute [r] prompt_feedback
+        #   @return [::Google::Cloud::AIPlatform::V1::GenerateContentResponse::PromptFeedback]
+        #     Output only. Content filter results for a prompt sent in the request.
+        #     Note: Sent only in the first stream chunk.
+        #     Only happens when no candidates were generated due to content violations.
+        # @!attribute [rw] usage_metadata
+        #   @return [::Google::Cloud::AIPlatform::V1::GenerateContentResponse::UsageMetadata]
+        #     Usage metadata about the response(s).
+        class GenerateContentResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # Content filter results for a prompt sent in the request.
+          # @!attribute [r] block_reason
+          #   @return [::Google::Cloud::AIPlatform::V1::GenerateContentResponse::PromptFeedback::BlockedReason]
+          #     Output only. Blocked reason.
+          # @!attribute [r] safety_ratings
+          #   @return [::Array<::Google::Cloud::AIPlatform::V1::SafetyRating>]
+          #     Output only. Safety ratings.
+          # @!attribute [r] block_reason_message
+          #   @return [::String]
+          #     Output only. A readable block reason message.
+          class PromptFeedback
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Blocked reason enumeration.
+            module BlockedReason
+              # Unspecified blocked reason.
+              BLOCKED_REASON_UNSPECIFIED = 0
+
+              # Candidates blocked due to safety.
+              SAFETY = 1
+
+              # Candidates blocked due to other reason.
+              OTHER = 2
+            end
+          end
+
+          # Usage metadata about response(s).
+          # @!attribute [rw] prompt_token_count
+          #   @return [::Integer]
+          #     Number of tokens in the request.
+          # @!attribute [rw] candidates_token_count
+          #   @return [::Integer]
+          #     Number of tokens in the response(s).
+          # @!attribute [rw] total_token_count
+          #   @return [::Integer]
+          class UsageMetadata
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
       end
     end
   end

data/proto_docs/google/cloud/aiplatform/v1/publisher_model.rb

@@ -43,6 +43,9 @@ module Google
         # @!attribute [rw] launch_stage
         #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::LaunchStage]
         #     Optional. Indicates the launch stage of the model.
+        # @!attribute [rw] version_state
+        #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::VersionState]
+        #     Optional. Indicates the state of the model version.
         # @!attribute [r] publisher_model_template
         #   @return [::String]
         #     Optional. Output only. Immutable. Used to indicate this model has a
@@ -64,6 +67,14 @@ module Google
           # @!attribute [rw] resource_name
           #   @return [::String]
           #     The resource name of the Google Cloud resource.
+          # @!attribute [rw] use_case
+          #   @deprecated This field is deprecated and may be removed in the next major version update.
+          #   @return [::String]
+          #     Use case (CUJ) of the resource.
+          # @!attribute [rw] description
+          #   @deprecated This field is deprecated and may be removed in the next major version update.
+          #   @return [::String]
+          #     Description of the resource.
           class ResourceReference
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -89,12 +100,18 @@ module Google
           # @!attribute [rw] open_notebook
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences]
           #     Optional. Open notebook of the PublisherModel.
+          # @!attribute [rw] open_notebooks
+          #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::OpenNotebooks]
+          #     Optional. Open notebooks of the PublisherModel.
           # @!attribute [rw] create_application
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences]
           #     Optional. Create application using the PublisherModel.
           # @!attribute [rw] open_fine_tuning_pipeline
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences]
           #     Optional. Open fine-tuning pipeline of the PublisherModel.
+          # @!attribute [rw] open_fine_tuning_pipelines
+          #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::OpenFineTuningPipelines]
+          #     Optional. Open fine-tuning pipelines of the PublisherModel.
           # @!attribute [rw] open_prompt_tuning_pipeline
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences]
           #     Optional. Open prompt-tuning pipeline of the PublisherModel.
@@ -104,6 +121,9 @@ module Google
           # @!attribute [rw] deploy
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::Deploy]
           #     Optional. Deploy the PublisherModel to Vertex Endpoint.
+          # @!attribute [rw] deploy_gke
+          #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::DeployGke]
+          #     Optional. Deploy PublisherModel to Google Kubernetes Engine.
           # @!attribute [rw] open_generation_ai_studio
           #   @return [::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences]
           #     Optional. Open in Generation AI Studio.
@@ -124,7 +144,16 @@ module Google
             #     Required.
             # @!attribute [rw] title
             #   @return [::String]
-            #     Required. The title of the regional resource reference.
+            #     Required.
+            # @!attribute [rw] resource_title
+            #   @return [::String]
+            #     Optional. Title of the resource.
+            # @!attribute [rw] resource_use_case
+            #   @return [::String]
+            #     Optional. Use case (CUJ) of the resource.
+            # @!attribute [rw] resource_description
+            #   @return [::String]
+            #     Optional. Description of the resource.
             class RegionalResourceReferences
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -151,6 +180,24 @@ module Google
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
 
+            # Open notebooks.
+            # @!attribute [rw] notebooks
+            #   @return [::Array<::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences>]
+            #     Required. Regional resource references to notebooks.
+            class OpenNotebooks
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Open fine tuning pipelines.
+            # @!attribute [rw] fine_tuning_pipelines
+            #   @return [::Array<::Google::Cloud::AIPlatform::V1::PublisherModel::CallToAction::RegionalResourceReferences>]
+            #     Required. Regional resource references to fine tuning pipelines.
+            class OpenFineTuningPipelines
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
             # Model metadata that is needed for UploadModel or
             # DeployModel/CreateEndpoint requests.
             # @!attribute [rw] dedicated_resources
@@ -184,10 +231,23 @@ module Google
             # @!attribute [rw] title
             #   @return [::String]
             #     Required. The title of the regional resource reference.
+            # @!attribute [rw] public_artifact_uri
+            #   @return [::String]
+            #     Optional. The signed URI for ephemeral Cloud Storage access to model
+            #     artifact.
             class Deploy
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods
             end
+
+            # Configurations for PublisherModel GKE deployment
+            # @!attribute [rw] gke_yaml_configs
+            #   @return [::Array<::String>]
+            #     Optional. GKE deployment configuration in yaml format.
+            class DeployGke
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # An enum representing the open source category of a PublisherModel.
@@ -231,6 +291,18 @@ module Google
             # Used to indicate the PublisherModel is at GA launch stage.
             GA = 4
           end
+
+          # An enum representing the state of the PublicModelVersion.
+          module VersionState
+            # The version state is unspecified.
+            VERSION_STATE_UNSPECIFIED = 0
+
+            # Used to indicate the version is stable.
+            VERSION_STATE_STABLE = 1
+
+            # Used to indicate the version is unstable.
+            VERSION_STATE_UNSTABLE = 2
+          end
         end
       end
     end

data/proto_docs/google/cloud/aiplatform/v1/service_networking.rb

@@ -33,6 +33,22 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # PscAutomatedEndpoints defines the output of the forwarding rule
+        # automatically created by each PscAutomationConfig.
+        # @!attribute [rw] project_id
+        #   @return [::String]
+        #     Corresponding project_id in pscAutomationConfigs
+        # @!attribute [rw] network
+        #   @return [::String]
+        #     Corresponding network in pscAutomationConfigs.
+        # @!attribute [rw] match_address
+        #   @return [::String]
+        #     Ip Address created by the automated forwarding rule.
+        class PscAutomatedEndpoints
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

data/proto_docs/google/cloud/aiplatform/v1/tool.rb

@@ -0,0 +1,112 @@
+# frozen_string_literal: true
+
+# Copyright 2023 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Cloud
+    module AIPlatform
+      module V1
+        # Tool details that the model may use to generate response.
+        #
+        # A `Tool` is a piece of code that enables the system to interact with
+        # external systems to perform an action, or set of actions, outside of
+        # knowledge and scope of the model.
+        # @!attribute [rw] function_declarations
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::FunctionDeclaration>]
+        #     Optional. One or more function declarations to be passed to the model along
+        #     with the current user query. Model may decide to call a subset of these
+        #     functions by populating [FunctionCall][content.part.function_call] in the
+        #     response. User should provide a
+        #     [FunctionResponse][content.part.function_response] for each function call
+        #     in the next turn. Based on the function responses, Model will generate the
+        #     final response back to the user. Maximum 64 function declarations can be
+        #     provided.
+        class Tool
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Structured representation of a function declaration as defined by the
+        # [OpenAPI 3.0 specification](https://spec.openapis.org/oas/v3.0.3). Included
+        # in this declaration are the function name and parameters. This
+        # FunctionDeclaration is a representation of a block of code that can be used
+        # as a `Tool` by the model and executed by the client.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the function to call.
+        #     Must start with a letter or an underscore.
+        #     Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum
+        #     length of 64.
+        # @!attribute [rw] description
+        #   @return [::String]
+        #     Optional. Description and purpose of the function.
+        #     Model uses it to decide how and whether to call the function.
+        # @!attribute [rw] parameters
+        #   @return [::Google::Cloud::AIPlatform::V1::Schema]
+        #     Optional. Describes the parameters to this function in JSON Schema Object
+        #     format. Reflects the Open API 3.03 Parameter Object. string Key: the name
+        #     of the parameter. Parameter names are case sensitive. Schema Value: the
+        #     Schema defining the type used for the parameter. For function with no
+        #     parameters, this can be left unset. Example with 1 required and 1 optional
+        #     parameter: type: OBJECT properties:
+        #      param1:
+        #        type: STRING
+        #      param2:
+        #        type: INTEGER
+        #     required:
+        #      - param1
+        class FunctionDeclaration
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A predicted [FunctionCall] returned from the model that contains a string
+        # representing the [FunctionDeclaration.name] and a structured JSON object
+        # containing the parameters and their values.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the function to call.
+        #     Matches [FunctionDeclaration.name].
+        # @!attribute [rw] args
+        #   @return [::Google::Protobuf::Struct]
+        #     Optional. Required. The function parameters and values in JSON object
+        #     format. See [FunctionDeclaration.parameters] for parameter details.
+        class FunctionCall
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The result output from a [FunctionCall] that contains a string representing
+        # the [FunctionDeclaration.name] and a structured JSON object containing any
+        # output from the function is used as context to the model. This should contain
+        # the result of a [FunctionCall] made based on model prediction.
+        # @!attribute [rw] name
+        #   @return [::String]
+        #     Required. The name of the function to call.
+        #     Matches [FunctionDeclaration.name] and [FunctionCall.name].
+        # @!attribute [rw] response
+        #   @return [::Google::Protobuf::Struct]
+        #     Required. The function response in JSON object format.
+        class FunctionResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+      end
+    end
+  end
+end

data/proto_docs/google/protobuf/any.rb

@@ -129,7 +129,8 @@ module Google
     #
     #     Note: this functionality is not currently available in the official
     #     protobuf release, and it is not used for type URLs beginning with
-    #     type.googleapis.com.
+    #     type.googleapis.com. As of May 2023, there are no widely used type server
+    #     implementations and no plans to implement one.
     #
     #     Schemes other than `http`, `https` (or the empty scheme) might be
     #     used with implementation specific semantics.