google-cloud-ai_platform-v1 0.33.0 → 0.35.0

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

@@ -45,6 +45,10 @@ module Google
         # @!attribute [rw] accelerator_count
         #   @return [::Integer]
         #     The number of accelerators to attach to the machine.
+        # @!attribute [rw] tpu_topology
+        #   @return [::String]
+        #     Immutable. The topology of the TPUs. Corresponds to the TPU topologies
+        #     available from GKE. (Example: tpu_topology: "2x2x1").
         class MachineSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -663,6 +663,31 @@ module Google
         #       (Vertex AI makes this value available to your container code as the
         #       [`AIP_DEPLOYED_MODEL_ID` environment
         #       variable](https://cloud.google.com/vertex-ai/docs/predictions/custom-container-requirements#aip-variables).)
+        # @!attribute [rw] grpc_ports
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::Port>]
+        #     Immutable. List of ports to expose from the container. Vertex AI sends gRPC
+        #     prediction requests that it receives to the first port on this list. Vertex
+        #     AI also sends liveness and health checks to this port.
+        #
+        #     If you do not specify this field, gRPC requests to the container will be
+        #     disabled.
+        #
+        #     Vertex AI does not use ports other than the first one listed. This field
+        #     corresponds to the `ports` field of the Kubernetes Containers v1 core API.
+        # @!attribute [rw] deployment_timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Immutable. Deployment timeout.
+        #     Limit for deployment timeout is 2 hours.
+        # @!attribute [rw] shared_memory_size_mb
+        #   @return [::Integer]
+        #     Immutable. The amount of the VM memory to reserve as the shared memory for
+        #     the model in megabytes.
+        # @!attribute [rw] startup_probe
+        #   @return [::Google::Cloud::AIPlatform::V1::Probe]
+        #     Immutable. Specification for Kubernetes startup probe.
+        # @!attribute [rw] health_probe
+        #   @return [::Google::Cloud::AIPlatform::V1::Probe]
+        #     Immutable. Specification for Kubernetes readiness probe.
         class ModelContainerSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -712,6 +737,42 @@ module Google
             GENIE = 5
           end
         end
+
+        # Probe describes a health check to be performed against a container to
+        # determine whether it is alive or ready to receive traffic.
+        # @!attribute [rw] exec
+        #   @return [::Google::Cloud::AIPlatform::V1::Probe::ExecAction]
+        #     Exec specifies the action to take.
+        # @!attribute [rw] period_seconds
+        #   @return [::Integer]
+        #     How often (in seconds) to perform the probe. Default to 10 seconds.
+        #     Minimum value is 1. Must be less than timeout_seconds.
+        #
+        #     Maps to Kubernetes probe argument 'periodSeconds'.
+        # @!attribute [rw] timeout_seconds
+        #   @return [::Integer]
+        #     Number of seconds after which the probe times out. Defaults to 1 second.
+        #     Minimum value is 1. Must be greater or equal to period_seconds.
+        #
+        #     Maps to Kubernetes probe argument 'timeoutSeconds'.
+        class Probe
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # ExecAction specifies a command to execute.
+          # @!attribute [rw] command
+          #   @return [::Array<::String>]
+          #     Command is the command line to execute inside the container, the working
+          #     directory for the command is root ('/') in the container's filesystem.
+          #     The command is simply exec'd, it is not run inside a shell, so
+          #     traditional shell instructions ('|', etc) won't work. To use a shell, you
+          #     need to explicitly call out to that shell. Exit status of 0 is treated as
+          #     live/healthy and non-zero is unhealthy.
+          class ExecAction
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
       end
     end
   end

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

@@ -115,7 +115,72 @@ module Google
         end
 
         # Request message for
-        # [PredictionService.StreamingPredict][google.cloud.aiplatform.v1.PredictionService.StreamingPredict].
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#direct_predict PredictionService.DirectPredict}.
+        # @!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>]
+        #     The prediction input.
+        # @!attribute [rw] parameters
+        #   @return [::Google::Cloud::AIPlatform::V1::Tensor]
+        #     The parameters that govern the prediction.
+        class DirectPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#direct_predict PredictionService.DirectPredict}.
+        # @!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 DirectPredictResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#direct_raw_predict PredictionService.DirectRawPredict}.
+        # @!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]
+        #     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]
+        #     The prediction input.
+        class DirectRawPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#direct_raw_predict PredictionService.DirectRawPredict}.
+        # @!attribute [rw] output
+        #   @return [::String]
+        #     The prediction output.
+        class DirectRawPredictResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#streaming_predict PredictionService.StreamingPredict}.
         #
         # The first message must contain
         # {::Google::Cloud::AIPlatform::V1::StreamingPredictRequest#endpoint endpoint} field
@@ -137,7 +202,7 @@ module Google
         end
 
         # Response message for
-        # [PredictionService.StreamingPredict][google.cloud.aiplatform.v1.PredictionService.StreamingPredict].
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#streaming_predict PredictionService.StreamingPredict}.
         # @!attribute [rw] outputs
         #   @return [::Array<::Google::Cloud::AIPlatform::V1::Tensor>]
         #     The prediction output.
@@ -149,6 +214,51 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Request message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#streaming_raw_predict PredictionService.StreamingRawPredict}.
+        #
+        # The first message must contain
+        # {::Google::Cloud::AIPlatform::V1::StreamingRawPredictRequest#endpoint endpoint}
+        # and
+        # {::Google::Cloud::AIPlatform::V1::StreamingRawPredictRequest#method_name method_name}
+        # fields and optionally
+        # {::Google::Cloud::AIPlatform::V1::StreamingRawPredictRequest#input input}. The
+        # subsequent messages must contain
+        # {::Google::Cloud::AIPlatform::V1::StreamingRawPredictRequest#input input}.
+        # {::Google::Cloud::AIPlatform::V1::StreamingRawPredictRequest#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]
+        #     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]
+        #     The prediction input.
+        class StreamingRawPredictRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for
+        # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#streaming_raw_predict PredictionService.StreamingRawPredict}.
+        # @!attribute [rw] output
+        #   @return [::String]
+        #     The prediction output.
+        class StreamingRawPredictResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Request message for
         # {::Google::Cloud::AIPlatform::V1::PredictionService::Client#explain PredictionService.Explain}.
         # @!attribute [rw] endpoint
@@ -216,6 +326,34 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # Request message for [PredictionService.CountTokens][].
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     Required. The name of the Endpoint requested to perform token counting.
+        #     Format:
+        #     `projects/{project}/locations/{location}/endpoints/{endpoint}`
+        # @!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.
+        class CountTokensRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Response message for [PredictionService.CountTokens][].
+        # @!attribute [rw] total_tokens
+        #   @return [::Integer]
+        #     The total number of tokens counted across all instances from the request.
+        # @!attribute [rw] total_billable_characters
+        #   @return [::Integer]
+        #     The total number of billable characters counted across all instances from
+        #     the request.
+        class CountTokensResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -205,6 +205,18 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Time-based Constraint for Study
+        # @!attribute [rw] max_duration
+        #   @return [::Google::Protobuf::Duration]
+        #     Counts the wallclock time passed since the creation of this Study.
+        # @!attribute [rw] end_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Compares the wallclock time to this time. Must use UTC timezone.
+        class StudyTimeConstraint
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # Represents specification of a Study.
         # @!attribute [rw] decay_curve_stopping_spec
         #   @return [::Google::Cloud::AIPlatform::V1::StudySpec::DecayCurveAutomatedStoppingSpec]
@@ -232,6 +244,10 @@ module Google
         # @!attribute [rw] measurement_selection_type
         #   @return [::Google::Cloud::AIPlatform::V1::StudySpec::MeasurementSelectionType]
         #     Describe which measurement selection type will be used
+        # @!attribute [rw] study_stopping_config
+        #   @return [::Google::Cloud::AIPlatform::V1::StudySpec::StudyStoppingConfig]
+        #     Conditions for automated stopping of a Study. Enable automated stopping by
+        #     configuring at least one condition.
         class StudySpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -561,6 +577,65 @@ module Google
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
 
+          # The configuration (stopping conditions) for automated stopping of a Study.
+          # Conditions include trial budgets, time budgets, and convergence detection.
+          # @!attribute [rw] should_stop_asap
+          #   @return [::Google::Protobuf::BoolValue]
+          #     If true, a Study enters STOPPING_ASAP whenever it would normally enters
+          #     STOPPING state.
+          #
+          #     The bottom line is: set to true if you want to interrupt on-going
+          #     evaluations of Trials as soon as the study stopping condition is met.
+          #     (Please see Study.State documentation for the source of truth).
+          # @!attribute [rw] minimum_runtime_constraint
+          #   @return [::Google::Cloud::AIPlatform::V1::StudyTimeConstraint]
+          #     Each "stopping rule" in this proto specifies an "if" condition. Before
+          #     Vizier would generate a new suggestion, it first checks each specified
+          #     stopping rule, from top to bottom in this list.
+          #     Note that the first few rules (e.g. minimum_runtime_constraint,
+          #     min_num_trials) will prevent other stopping rules from being evaluated
+          #     until they are met. For example, setting `min_num_trials=5` and
+          #     `always_stop_after= 1 hour` means that the Study will ONLY stop after it
+          #     has 5 COMPLETED trials, even if more than an hour has passed since its
+          #     creation. It follows the first applicable rule (whose "if" condition is
+          #     satisfied) to make a stopping decision. If none of the specified rules
+          #     are applicable, then Vizier decides that the study should not stop.
+          #     If Vizier decides that the study should stop, the study enters
+          #     STOPPING state (or STOPPING_ASAP if should_stop_asap = true).
+          #     IMPORTANT: The automatic study state transition happens precisely as
+          #     described above; that is, deleting trials or updating StudyConfig NEVER
+          #     automatically moves the study state back to ACTIVE. If you want to
+          #     _resume_ a Study that was stopped, 1) change the stopping conditions if
+          #     necessary, 2) activate the study, and then 3) ask for suggestions.
+          #     If the specified time or duration has not passed, do not stop the
+          #     study.
+          # @!attribute [rw] maximum_runtime_constraint
+          #   @return [::Google::Cloud::AIPlatform::V1::StudyTimeConstraint]
+          #     If the specified time or duration has passed, stop the study.
+          # @!attribute [rw] min_num_trials
+          #   @return [::Google::Protobuf::Int32Value]
+          #     If there are fewer than this many COMPLETED trials, do not stop the
+          #     study.
+          # @!attribute [rw] max_num_trials
+          #   @return [::Google::Protobuf::Int32Value]
+          #     If there are more than this many trials, stop the study.
+          # @!attribute [rw] max_num_trials_no_progress
+          #   @return [::Google::Protobuf::Int32Value]
+          #     If the objective value has not improved for this many consecutive
+          #     trials, stop the study.
+          #
+          #     WARNING: Effective only for single-objective studies.
+          # @!attribute [rw] max_duration_no_progress
+          #   @return [::Google::Protobuf::Duration]
+          #     If the objective value has not improved for this much time, stop the
+          #     study.
+          #
+          #     WARNING: Effective only for single-objective studies.
+          class StudyStoppingConfig
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+
           # The available search algorithms for the Study.
           module Algorithm
             # The default algorithm used by Vertex AI for [hyperparameter

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-ai_platform-v1
 version: !ruby/object:Gem::Version
-  version: 0.33.0
+  version: 0.35.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-10-06 00:00:00.000000000 Z
+date: 2023-12-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -222,6 +222,20 @@ files:
 - lib/google/cloud/ai_platform/v1/endpoint_service/credentials.rb
 - lib/google/cloud/ai_platform/v1/endpoint_service/operations.rb
 - lib/google/cloud/ai_platform/v1/endpoint_service/paths.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_admin_service.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/client.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/credentials.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/operations.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_admin_service/paths.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_service.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_service/client.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_service/credentials.rb
+- lib/google/cloud/ai_platform/v1/feature_online_store_service/paths.rb
+- lib/google/cloud/ai_platform/v1/feature_registry_service.rb
+- lib/google/cloud/ai_platform/v1/feature_registry_service/client.rb
+- lib/google/cloud/ai_platform/v1/feature_registry_service/credentials.rb
+- lib/google/cloud/ai_platform/v1/feature_registry_service/operations.rb
+- lib/google/cloud/ai_platform/v1/feature_registry_service/paths.rb
 - lib/google/cloud/ai_platform/v1/featurestore_online_serving_service.rb
 - lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/client.rb
 - lib/google/cloud/ai_platform/v1/featurestore_online_serving_service/credentials.rb
@@ -246,6 +260,10 @@ files:
 - lib/google/cloud/ai_platform/v1/job_service/credentials.rb
 - lib/google/cloud/ai_platform/v1/job_service/operations.rb
 - lib/google/cloud/ai_platform/v1/job_service/paths.rb
+- lib/google/cloud/ai_platform/v1/llm_utility_service.rb
+- lib/google/cloud/ai_platform/v1/llm_utility_service/client.rb
+- lib/google/cloud/ai_platform/v1/llm_utility_service/credentials.rb
+- lib/google/cloud/ai_platform/v1/llm_utility_service/paths.rb
 - lib/google/cloud/ai_platform/v1/match_service.rb
 - lib/google/cloud/ai_platform/v1/match_service/client.rb
 - lib/google/cloud/ai_platform/v1/match_service/credentials.rb
@@ -326,9 +344,19 @@ files:
 - lib/google/cloud/aiplatform/v1/execution_pb.rb
 - lib/google/cloud/aiplatform/v1/explanation_metadata_pb.rb
 - lib/google/cloud/aiplatform/v1/explanation_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_group_pb.rb
 - lib/google/cloud/aiplatform/v1/feature_monitoring_stats_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_online_store_admin_service_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_online_store_admin_service_services_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_online_store_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_online_store_service_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_online_store_service_services_pb.rb
 - lib/google/cloud/aiplatform/v1/feature_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_registry_service_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_registry_service_services_pb.rb
 - lib/google/cloud/aiplatform/v1/feature_selector_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_view_pb.rb
+- lib/google/cloud/aiplatform/v1/feature_view_sync_pb.rb
 - lib/google/cloud/aiplatform/v1/featurestore_monitoring_pb.rb
 - lib/google/cloud/aiplatform/v1/featurestore_online_service_pb.rb
 - lib/google/cloud/aiplatform/v1/featurestore_online_service_services_pb.rb
@@ -347,6 +375,8 @@ files:
 - lib/google/cloud/aiplatform/v1/job_service_services_pb.rb
 - lib/google/cloud/aiplatform/v1/job_state_pb.rb
 - lib/google/cloud/aiplatform/v1/lineage_subgraph_pb.rb
+- lib/google/cloud/aiplatform/v1/llm_utility_service_pb.rb
+- lib/google/cloud/aiplatform/v1/llm_utility_service_services_pb.rb
 - lib/google/cloud/aiplatform/v1/machine_resources_pb.rb
 - lib/google/cloud/aiplatform/v1/manual_batch_tuning_parameters_pb.rb
 - lib/google/cloud/aiplatform/v1/match_service_pb.rb
@@ -432,8 +462,15 @@ files:
 - proto_docs/google/cloud/aiplatform/v1/explanation.rb
 - proto_docs/google/cloud/aiplatform/v1/explanation_metadata.rb
 - proto_docs/google/cloud/aiplatform/v1/feature.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_group.rb
 - proto_docs/google/cloud/aiplatform/v1/feature_monitoring_stats.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_online_store.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_online_store_admin_service.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_online_store_service.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_registry_service.rb
 - proto_docs/google/cloud/aiplatform/v1/feature_selector.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_view.rb
+- proto_docs/google/cloud/aiplatform/v1/feature_view_sync.rb
 - proto_docs/google/cloud/aiplatform/v1/featurestore.rb
 - proto_docs/google/cloud/aiplatform/v1/featurestore_monitoring.rb
 - proto_docs/google/cloud/aiplatform/v1/featurestore_online_service.rb
@@ -447,6 +484,7 @@ files:
 - proto_docs/google/cloud/aiplatform/v1/job_service.rb
 - proto_docs/google/cloud/aiplatform/v1/job_state.rb
 - proto_docs/google/cloud/aiplatform/v1/lineage_subgraph.rb
+- proto_docs/google/cloud/aiplatform/v1/llm_utility_service.rb
 - proto_docs/google/cloud/aiplatform/v1/machine_resources.rb
 - proto_docs/google/cloud/aiplatform/v1/manual_batch_tuning_parameters.rb
 - proto_docs/google/cloud/aiplatform/v1/match_service.rb