feat: Add support for Inline source based deployment

Google APIs · copybara-github · commit 3403a38bb54b · 2025-10-14T12:21:39.000-07:00
docs: A comment for message `ReasoningEngineSpec` is changed
docs: A comment for field `package_spec` in message `.google.cloud.aiplatform.v1.ReasoningEngineSpec` is changed

PiperOrigin-RevId: 819343785
diff --git a/google/cloud/aiplatform/v1/reasoning_engine.proto b/google/cloud/aiplatform/v1/reasoning_engine.proto
@@ -34,7 +34,8 @@ option ruby_package = "Google::Cloud::AIPlatform::V1";
 
 // ReasoningEngine configurations
 message ReasoningEngineSpec {
-  // User provided package spec like pickled object and package requirements.
+  // User-provided package specification, containing pickled object and package
+  // requirements.
   message PackageSpec {
     // Optional. The Cloud Storage URI of the pickled python object.
     string pickle_object_gcs_uri = 1 [(google.api.field_behavior) = OPTIONAL];
@@ -98,6 +99,66 @@ message ReasoningEngineSpec {
         [(google.api.field_behavior) = OPTIONAL];
   }
 
+  // Specification for deploying from source code.
+  message SourceCodeSpec {
+    // Specifies source code provided as a byte stream.
+    message InlineSource {
+      // Required. Input only. The application source code archive, provided as
+      // a compressed tarball
+      // (.tar.gz) file.
+      bytes source_archive = 1 [
+        (google.api.field_behavior) = REQUIRED,
+        (google.api.field_behavior) = INPUT_ONLY
+      ];
+    }
+
+    // Specification for running a Python application from source.
+    message PythonSpec {
+      // 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.
+      string version = 1 [(google.api.field_behavior) = OPTIONAL];
+
+      // 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.
+      string entrypoint_module = 2 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The name of the callable object within the
+      // `entrypoint_module` to use as the application If not specified,
+      // defaults to "root_agent".
+      string entrypoint_object = 3 [(google.api.field_behavior) = OPTIONAL];
+
+      // Optional. The path to the requirements file, relative to the source
+      // root. If not specified, defaults to "requirements.txt".
+      string requirements_file = 4 [(google.api.field_behavior) = OPTIONAL];
+    }
+
+    // Specifies where the source code is located.
+    oneof source {
+      // Source code is provided directly in the request.
+      InlineSource inline_source = 1;
+    }
+
+    // Specifies the language-specific configuration for building and running
+    // the code.
+    oneof language_spec {
+      // Configuration for a Python application.
+      PythonSpec python_spec = 2;
+    }
+  }
+
+  // Defines the source for the deployment.
+  // The `package_spec` field should not be set if `deployment_source` is
+  // specified.
+  oneof deployment_source {
+    // Deploy from source code files with a defined entrypoint.
+    SourceCodeSpec source_code_spec = 11;
+  }
+
   // Optional. The service account that the Reasoning Engine artifact runs as.
   // It should have "roles/storage.objectViewer" for reading the user project's
   // Cloud Storage and "roles/aiplatform.user" for using Vertex extensions. If
@@ -109,6 +170,8 @@ message ReasoningEngineSpec {
   // Ignored when users directly specify a deployment image through
   // `deployment_spec.first_party_image_override`, but keeping the
   // field_behavior to avoid introducing breaking changes.
+  // The `deployment_source` field should not be set if `package_spec` is
+  // specified.
   PackageSpec package_spec = 2 [(google.api.field_behavior) = OPTIONAL];
 
   // Optional. The specification of a Reasoning Engine deployment.
@@ -165,4 +228,7 @@ message ReasoningEngine {
   // ReasoningEngine and all sub-resources of this ReasoningEngine will be
   // secured by this key.
   EncryptionSpec encryption_spec = 11;
+
+  // Labels for the ReasoningEngine.
+  map<string, string> labels = 17;
 }
