google-cloud-ai_platform-v1 1.10.0 → 1.12.0

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

@@ -24,7 +24,8 @@ module Google
         # Represents a TuningJob that runs with Google owned models.
         # @!attribute [rw] base_model
         #   @return [::String]
-        #     The base model that is being tuned, e.g., "gemini-1.0-pro-002".
+        #     The base model that is being tuned. See [Supported
+        #     models](https://cloud.google.com/vertex-ai/generative-ai/docs/model-reference/tuning#supported_models).
         # @!attribute [rw] supervised_tuning_spec
         #   @return [::Google::Cloud::AIPlatform::V1::SupervisedTuningSpec]
         #     Tuning Spec for Supervised Fine Tuning.
@@ -85,7 +86,7 @@ module Google
         #     {::Google::Cloud::AIPlatform::V1::TuningJob TuningJob}.
         # @!attribute [r] tuned_model
         #   @return [::Google::Cloud::AIPlatform::V1::TunedModel]
-        #     Output only. The tuned model resources assiociated with this
+        #     Output only. The tuned model resources associated with this
         #     {::Google::Cloud::AIPlatform::V1::TuningJob TuningJob}.
         # @!attribute [r] tuning_data_stats
         #   @return [::Google::Cloud::AIPlatform::V1::TuningDataStats]
@@ -119,7 +120,7 @@ module Google
           end
         end
 
-        # The Model Registry Model and Online Prediction Endpoint assiociated with
+        # The Model Registry Model and Online Prediction Endpoint associated with
         # this {::Google::Cloud::AIPlatform::V1::TuningJob TuningJob}.
         # @!attribute [r] model
         #   @return [::String]
@@ -129,6 +130,11 @@ module Google
         #   @return [::String]
         #     Output only. A resource name of an Endpoint. Format:
         #     `projects/{project}/locations/{location}/endpoints/{endpoint}`.
+        # @!attribute [r] checkpoints
+        #   @return [::Array<::Google::Cloud::AIPlatform::V1::TunedModelCheckpoint>]
+        #     Output only. The checkpoints associated with this TunedModel.
+        #     This field is only populated for tuning jobs that enable intermediate
+        #     checkpoints.
         class TunedModel
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,14 +218,19 @@ module Google
         # @!attribute [r] user_dataset_examples
         #   @return [::Array<::Google::Cloud::AIPlatform::V1::Content>]
         #     Output only. Sample user messages in the training dataset uri.
-        # @!attribute [rw] total_truncated_example_count
+        # @!attribute [r] total_truncated_example_count
         #   @return [::Integer]
-        #     The number of examples in the dataset that have been truncated by any
-        #     amount.
-        # @!attribute [rw] truncated_example_indices
+        #     Output only. The number of examples in the dataset that have been dropped.
+        #     An example can be dropped for reasons including: too many tokens, contains
+        #     an invalid image, contains too many images, etc.
+        # @!attribute [r] truncated_example_indices
         #   @return [::Array<::Integer>]
-        #     A partial sample of the indices (starting from 1) of the truncated
-        #     examples.
+        #     Output only. A partial sample of the indices (starting from 1) of the
+        #     dropped examples.
+        # @!attribute [r] dropped_example_reasons
+        #   @return [::Array<::String>]
+        #     Output only. For each index in `truncated_example_indices`, the user-facing
+        #     reason why the example was dropped.
         class SupervisedTuningDataStats
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -258,6 +269,9 @@ module Google
             # Adapter size 1.
             ADAPTER_SIZE_ONE = 1
 
+            # Adapter size 2.
+            ADAPTER_SIZE_TWO = 6
+
             # Adapter size 4.
             ADAPTER_SIZE_FOUR = 2
 
@@ -266,6 +280,9 @@ module Google
 
             # Adapter size 16.
             ADAPTER_SIZE_SIXTEEN = 4
+
+            # Adapter size 32.
+            ADAPTER_SIZE_THIRTY_TWO = 5
           end
         end
 
@@ -281,6 +298,11 @@ module Google
         # @!attribute [rw] hyper_parameters
         #   @return [::Google::Cloud::AIPlatform::V1::SupervisedHyperParameters]
         #     Optional. Hyperparameters for SFT.
+        # @!attribute [rw] export_last_checkpoint_only
+        #   @return [::Boolean]
+        #     Optional. If set to true, disable intermediate checkpoints for SFT and only
+        #     the last checkpoint will be exported. Otherwise, enable intermediate
+        #     checkpoints for SFT. Default is false.
         class SupervisedTuningSpec
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -308,6 +330,25 @@ module Google
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
+
+        # TunedModelCheckpoint for the Tuned Model of a Tuning Job.
+        # @!attribute [rw] checkpoint_id
+        #   @return [::String]
+        #     The ID of the checkpoint.
+        # @!attribute [rw] epoch
+        #   @return [::Integer]
+        #     The epoch of the checkpoint.
+        # @!attribute [rw] step
+        #   @return [::Integer]
+        #     The step of the checkpoint.
+        # @!attribute [rw] endpoint
+        #   @return [::String]
+        #     The Endpoint resource name that the checkpoint is deployed to. Format:
+        #     `projects/{project}/locations/{location}/endpoints/{endpoint}`.
+        class TunedModelCheckpoint
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
       end
     end
   end

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

@@ -84,9 +84,56 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
 
           # The config for the default RAG-managed Vector DB.
+          # @!attribute [rw] knn
+          #   @return [::Google::Cloud::AIPlatform::V1::RagVectorDbConfig::RagManagedDb::KNN]
+          #     Performs a KNN search on RagCorpus.
+          #     Default choice if not specified.
+          #
+          #     Note: The following fields are mutually exclusive: `knn`, `ann`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+          # @!attribute [rw] ann
+          #   @return [::Google::Cloud::AIPlatform::V1::RagVectorDbConfig::RagManagedDb::ANN]
+          #     Performs an ANN search on RagCorpus. Use this if you have a lot of
+          #     files (> 10K) in your RagCorpus and want to reduce the search latency.
+          #
+          #     Note: The following fields are mutually exclusive: `ann`, `knn`. If a field in that set is populated, all other fields in the set will automatically be cleared.
           class RagManagedDb
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
+
+            # Config for KNN search.
+            class KNN
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
+
+            # Config for ANN search.
+            #
+            # RagManagedDb uses a tree-based structure to partition data and
+            # facilitate faster searches. As a tradeoff, it requires longer indexing
+            # time and manual triggering of index rebuild via the ImportRagFiles and
+            # UpdateRagCorpus API.
+            # @!attribute [rw] tree_depth
+            #   @return [::Integer]
+            #     The depth of the tree-based structure. Only depth values of 2 and 3 are
+            #     supported.
+            #
+            #     Recommended value is 2 if you have if you have O(10K) files in the
+            #     RagCorpus and set this to 3 if more than that.
+            #
+            #     Default value is 2.
+            # @!attribute [rw] leaf_count
+            #   @return [::Integer]
+            #     Number of leaf nodes in the tree-based structure. Each leaf node
+            #     contains groups of closely related vectors along with their
+            #     corresponding centroid.
+            #
+            #     Recommended value is 10 * sqrt(num of RagFiles in your RagCorpus).
+            #
+            #     Default value is 500.
+            class ANN
+              include ::Google::Protobuf::MessageExts
+              extend ::Google::Protobuf::MessageExts::ClassMethods
+            end
           end
 
           # The config for the Pinecone.
@@ -336,6 +383,13 @@ module Google
         # @!attribute [rw] layout_parser
         #   @return [::Google::Cloud::AIPlatform::V1::RagFileParsingConfig::LayoutParser]
         #     The Layout Parser to use for RagFiles.
+        #
+        #     Note: The following fields are mutually exclusive: `layout_parser`, `llm_parser`. If a field in that set is populated, all other fields in the set will automatically be cleared.
+        # @!attribute [rw] llm_parser
+        #   @return [::Google::Cloud::AIPlatform::V1::RagFileParsingConfig::LlmParser]
+        #     The LLM Parser to use for RagFiles.
+        #
+        #     Note: The following fields are mutually exclusive: `llm_parser`, `layout_parser`. If a field in that set is populated, all other fields in the set will automatically be cleared.
         class RagFileParsingConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -360,6 +414,28 @@ module Google
             include ::Google::Protobuf::MessageExts
             extend ::Google::Protobuf::MessageExts::ClassMethods
           end
+
+          # Specifies the advanced parsing for RagFiles.
+          # @!attribute [rw] model_name
+          #   @return [::String]
+          #     The name of a LLM model used for parsing.
+          #     Format:
+          #     * `projects/{project_id}/locations/{location}/publishers/{publisher}/models/{model}`
+          # @!attribute [rw] max_parsing_requests_per_min
+          #   @return [::Integer]
+          #     The maximum number of requests the job is allowed to make to the
+          #     LLM model per minute. Consult
+          #     https://cloud.google.com/vertex-ai/generative-ai/docs/quotas
+          #     and your document size to set an appropriate value here. If unspecified,
+          #     a default value of 5000 QPM would be used.
+          # @!attribute [rw] custom_parsing_prompt
+          #   @return [::String]
+          #     The prompt to use for parsing. If not specified, a default prompt will
+          #     be used.
+          class LlmParser
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
         end
 
         # Config for uploading RagFile.
@@ -449,6 +525,15 @@ module Google
         #     to this job and not shared across other import jobs. Consult the Quotas
         #     page on the project to set an appropriate value here.
         #     If unspecified, a default value of 1,000 QPM would be used.
+        # @!attribute [rw] rebuild_ann_index
+        #   @return [::Boolean]
+        #     Rebuilds the ANN index to optimize for recall on the imported data.
+        #     Only applicable for RagCorpora running on RagManagedDb with
+        #     `retrieval_strategy` set to `ANN`. The rebuild will be performed using the
+        #     existing ANN config set on the RagCorpus. To change the ANN config, please
+        #     use the UpdateRagCorpus API.
+        #
+        #     Default is false, i.e., index is not rebuilt.
         class ImportRagFilesConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-ai_platform-v1
 version: !ruby/object:Gem::Version
-  version: 1.10.0
+  version: 1.12.0
 platform: ruby
 authors:
 - Google LLC
@@ -13,22 +13,16 @@ dependencies:
   name: gapic-common
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.25.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.25.0
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -47,42 +41,30 @@ dependencies:
   name: google-cloud-location
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.7'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.7'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.0'
 - !ruby/object:Gem::Dependency
   name: google-iam-v1
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.7'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0.7'
-    - - "<"
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.a
+        version: '1.3'
 description: Vertex AI enables data scientists, developers, and AI newcomers to create
   custom machine learning models specific to their business needs by leveraging Google's
   state-of-the-art transfer learning and innovative AI research. Note that google-cloud-ai_platform-v1
@@ -707,7 +689,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="