diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/README.md b/clients/google-api-services-aiplatform/v1/2.0.0/README.md index b9d91ff410e..3ac10e8bf86 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/README.md +++ b/clients/google-api-services-aiplatform/v1/2.0.0/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-aiplatform - v1-rev20260116-2.0.0 + v1-rev20260201-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-aiplatform:v1-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-aiplatform:v1-rev20260201-2.0.0' } ``` diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/Aiplatform.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/Aiplatform.java index 153f4559015..7832f6e9dab 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/Aiplatform.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/Aiplatform.java @@ -103,7 +103,7 @@ public class Aiplatform extends com.google.api.client.googleapis.services.json.A * {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport} *
  • Android: {@code newCompatibleTransport} from * {@code com.google.api.client.extensions.android.http.AndroidHttp}
  • - *
  • Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()} + *
  • Java: {@code com.google.api.client.http.javanet.NetHttpTransport}
  • * * * @param jsonFactory JSON factory, which may be: @@ -32794,7 +32794,10 @@ public GetRagEngineConfig set(String parameterName, Object value) { } } /** - * Lists information about the supported locations for this service. + * Lists information about the supported locations for this service. This method can be called in + * two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project- + * visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include + * public locations as well as private or other locations specifically visible to the project. * * Create a request for the method "locations.list". * @@ -32818,7 +32821,10 @@ public class List extends AiplatformRequest { + + private static final String REST_PATH = "v1/{+resource}:getIamPolicy"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Gets the access control policy for a resource. Returns an empty policy if the resource exists + * and does not have a policy set. + * + * Create a request for the method "reasoningEngines.getIamPolicy". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote + * operation.

    {@link + * GetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} + * must be called to initialize this instance immediately after invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @since 1.13 + */ + protected GetIamPolicy(java.lang.String resource) { + super(Aiplatform.this, "POST", REST_PATH, null, com.google.api.services.aiplatform.v1.model.GoogleIamV1Policy.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public GetIamPolicy set$Xgafv(java.lang.String $Xgafv) { + return (GetIamPolicy) super.set$Xgafv($Xgafv); + } + + @Override + public GetIamPolicy setAccessToken(java.lang.String accessToken) { + return (GetIamPolicy) super.setAccessToken(accessToken); + } + + @Override + public GetIamPolicy setAlt(java.lang.String alt) { + return (GetIamPolicy) super.setAlt(alt); + } + + @Override + public GetIamPolicy setCallback(java.lang.String callback) { + return (GetIamPolicy) super.setCallback(callback); + } + + @Override + public GetIamPolicy setFields(java.lang.String fields) { + return (GetIamPolicy) super.setFields(fields); + } + + @Override + public GetIamPolicy setKey(java.lang.String key) { + return (GetIamPolicy) super.setKey(key); + } + + @Override + public GetIamPolicy setOauthToken(java.lang.String oauthToken) { + return (GetIamPolicy) super.setOauthToken(oauthToken); + } + + @Override + public GetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) { + return (GetIamPolicy) super.setPrettyPrint(prettyPrint); + } + + @Override + public GetIamPolicy setQuotaUser(java.lang.String quotaUser) { + return (GetIamPolicy) super.setQuotaUser(quotaUser); + } + + @Override + public GetIamPolicy setUploadType(java.lang.String uploadType) { + return (GetIamPolicy) super.setUploadType(uploadType); + } + + @Override + public GetIamPolicy setUploadProtocol(java.lang.String uploadProtocol) { + return (GetIamPolicy) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy is being requested. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public GetIamPolicy setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + /** + * Optional. The maximum policy version that will be used to format the policy. Valid + * values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests + * for policies with any conditional role bindings must specify version 3. Policies with + * no conditional role bindings may specify any valid value or leave the field unset. The + * policy in the response might use the policy version that you specified, or it might use + * a lower policy version. For example, if you specify version 3, but the policy has no + * conditional role bindings, the response uses version 1. To learn which resources + * support conditions in their IAM policies, see the [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + @com.google.api.client.util.Key("options.requestedPolicyVersion") + private java.lang.Integer optionsRequestedPolicyVersion; + + /** Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, + and 3. Requests specifying an invalid value will be rejected. Requests for policies with any + conditional role bindings must specify version 3. Policies with no conditional role bindings may + specify any valid value or leave the field unset. The policy in the response might use the policy + version that you specified, or it might use a lower policy version. For example, if you specify + version 3, but the policy has no conditional role bindings, the response uses version 1. To learn + which resources support conditions in their IAM policies, see the [IAM + documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + public java.lang.Integer getOptionsRequestedPolicyVersion() { + return optionsRequestedPolicyVersion; + } + + /** + * Optional. The maximum policy version that will be used to format the policy. Valid + * values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests + * for policies with any conditional role bindings must specify version 3. Policies with + * no conditional role bindings may specify any valid value or leave the field unset. The + * policy in the response might use the policy version that you specified, or it might use + * a lower policy version. For example, if you specify version 3, but the policy has no + * conditional role bindings, the response uses version 1. To learn which resources + * support conditions in their IAM policies, see the [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + public GetIamPolicy setOptionsRequestedPolicyVersion(java.lang.Integer optionsRequestedPolicyVersion) { + this.optionsRequestedPolicyVersion = optionsRequestedPolicyVersion; + return this; + } + + @Override + public GetIamPolicy set(String parameterName, Object value) { + return (GetIamPolicy) super.set(parameterName, value); + } + } /** * Lists reasoning engines in a location. * @@ -115458,6 +115652,153 @@ public Query set(String parameterName, Object value) { return (Query) super.set(parameterName, value); } } + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can + * return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * + * Create a request for the method "reasoningEngines.setIamPolicy". + * + * This request holds the parameters needed by the aiplatform server. After setting any optional + * parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation. + * + * @param resource REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleIamV1SetIamPolicyRequest} + * @return the request + */ + public SetIamPolicy setIamPolicy(java.lang.String resource, com.google.api.services.aiplatform.v1.model.GoogleIamV1SetIamPolicyRequest content) throws java.io.IOException { + SetIamPolicy result = new SetIamPolicy(resource, content); + initialize(result); + return result; + } + + public class SetIamPolicy extends AiplatformRequest { + + private static final String REST_PATH = "v1/{+resource}:setIamPolicy"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can + * return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * + * Create a request for the method "reasoningEngines.setIamPolicy". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote + * operation.

    {@link + * SetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} + * must be called to initialize this instance immediately after invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleIamV1SetIamPolicyRequest} + * @since 1.13 + */ + protected SetIamPolicy(java.lang.String resource, com.google.api.services.aiplatform.v1.model.GoogleIamV1SetIamPolicyRequest content) { + super(Aiplatform.this, "POST", REST_PATH, content, com.google.api.services.aiplatform.v1.model.GoogleIamV1Policy.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public SetIamPolicy set$Xgafv(java.lang.String $Xgafv) { + return (SetIamPolicy) super.set$Xgafv($Xgafv); + } + + @Override + public SetIamPolicy setAccessToken(java.lang.String accessToken) { + return (SetIamPolicy) super.setAccessToken(accessToken); + } + + @Override + public SetIamPolicy setAlt(java.lang.String alt) { + return (SetIamPolicy) super.setAlt(alt); + } + + @Override + public SetIamPolicy setCallback(java.lang.String callback) { + return (SetIamPolicy) super.setCallback(callback); + } + + @Override + public SetIamPolicy setFields(java.lang.String fields) { + return (SetIamPolicy) super.setFields(fields); + } + + @Override + public SetIamPolicy setKey(java.lang.String key) { + return (SetIamPolicy) super.setKey(key); + } + + @Override + public SetIamPolicy setOauthToken(java.lang.String oauthToken) { + return (SetIamPolicy) super.setOauthToken(oauthToken); + } + + @Override + public SetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) { + return (SetIamPolicy) super.setPrettyPrint(prettyPrint); + } + + @Override + public SetIamPolicy setQuotaUser(java.lang.String quotaUser) { + return (SetIamPolicy) super.setQuotaUser(quotaUser); + } + + @Override + public SetIamPolicy setUploadType(java.lang.String uploadType) { + return (SetIamPolicy) super.setUploadType(uploadType); + } + + @Override + public SetIamPolicy setUploadProtocol(java.lang.String uploadProtocol) { + return (SetIamPolicy) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy is being specified. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public SetIamPolicy setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + @Override + public SetIamPolicy set(String parameterName, Object value) { + return (SetIamPolicy) super.set(parameterName, value); + } + } /** * Streams queries using a reasoning engine. * @@ -115598,6 +115939,181 @@ public StreamQuery set(String parameterName, Object value) { return (StreamQuery) super.set(parameterName, value); } } + /** + * Returns permissions that a caller has on the specified resource. If the resource does not exist, + * this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is + * designed to be used for building permission-aware UIs and command-line tools, not for + * authorization checking. This operation may "fail open" without warning. + * + * Create a request for the method "reasoningEngines.testIamPermissions". + * + * This request holds the parameters needed by the aiplatform server. After setting any optional + * parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote operation. + * + * @param resource REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @return the request + */ + public TestIamPermissions testIamPermissions(java.lang.String resource) throws java.io.IOException { + TestIamPermissions result = new TestIamPermissions(resource); + initialize(result); + return result; + } + + public class TestIamPermissions extends AiplatformRequest { + + private static final String REST_PATH = "v1/{+resource}:testIamPermissions"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Returns permissions that a caller has on the specified resource. If the resource does not + * exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This + * operation is designed to be used for building permission-aware UIs and command-line tools, not + * for authorization checking. This operation may "fail open" without warning. + * + * Create a request for the method "reasoningEngines.testIamPermissions". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote + * operation.

    {@link TestIamPermissions#initialize(com.google.api.client.googleapis.services.A + * bstractGoogleClientRequest)} must be called to initialize this instance immediately after + * invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @since 1.13 + */ + protected TestIamPermissions(java.lang.String resource) { + super(Aiplatform.this, "POST", REST_PATH, null, com.google.api.services.aiplatform.v1.model.GoogleIamV1TestIamPermissionsResponse.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public TestIamPermissions set$Xgafv(java.lang.String $Xgafv) { + return (TestIamPermissions) super.set$Xgafv($Xgafv); + } + + @Override + public TestIamPermissions setAccessToken(java.lang.String accessToken) { + return (TestIamPermissions) super.setAccessToken(accessToken); + } + + @Override + public TestIamPermissions setAlt(java.lang.String alt) { + return (TestIamPermissions) super.setAlt(alt); + } + + @Override + public TestIamPermissions setCallback(java.lang.String callback) { + return (TestIamPermissions) super.setCallback(callback); + } + + @Override + public TestIamPermissions setFields(java.lang.String fields) { + return (TestIamPermissions) super.setFields(fields); + } + + @Override + public TestIamPermissions setKey(java.lang.String key) { + return (TestIamPermissions) super.setKey(key); + } + + @Override + public TestIamPermissions setOauthToken(java.lang.String oauthToken) { + return (TestIamPermissions) super.setOauthToken(oauthToken); + } + + @Override + public TestIamPermissions setPrettyPrint(java.lang.Boolean prettyPrint) { + return (TestIamPermissions) super.setPrettyPrint(prettyPrint); + } + + @Override + public TestIamPermissions setQuotaUser(java.lang.String quotaUser) { + return (TestIamPermissions) super.setQuotaUser(quotaUser); + } + + @Override + public TestIamPermissions setUploadType(java.lang.String uploadType) { + return (TestIamPermissions) super.setUploadType(uploadType); + } + + @Override + public TestIamPermissions setUploadProtocol(java.lang.String uploadProtocol) { + return (TestIamPermissions) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy detail is being requested. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public TestIamPermissions setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + /** + * The set of permissions to check for the `resource`. Permissions with wildcards (such as + * `*` or `storage.*`) are not allowed. For more information see [IAM + * Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + @com.google.api.client.util.Key + private java.util.List permissions; + + /** The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or + `storage.*`) are not allowed. For more information see [IAM + Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + public java.util.List getPermissions() { + return permissions; + } + + /** + * The set of permissions to check for the `resource`. Permissions with wildcards (such as + * `*` or `storage.*`) are not allowed. For more information see [IAM + * Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + public TestIamPermissions setPermissions(java.util.List permissions) { + this.permissions = permissions; + return this; + } + + @Override + public TestIamPermissions set(String parameterName, Object value) { + return (TestIamPermissions) super.set(parameterName, value); + } + } /** * An accessor for creating requests from the Memories collection. @@ -140280,19 +140796,19 @@ public TuningJobs tuningJobs() { public class TuningJobs { /** - * Cancels a TuningJob. Starts asynchronous cancellation on the TuningJob. The server makes a best - * effort to cancel the job, but success is not guaranteed. Clients can use - * GenAiTuningService.GetTuningJob or other methods to check whether the cancellation succeeded or - * whether the job completed despite cancellation. On successful cancellation, the TuningJob is not - * deleted; instead it becomes a job with a TuningJob.error value with a google.rpc.Status.code of - * 1, corresponding to `Code.CANCELLED`, and TuningJob.state is set to `CANCELLED`. + * Cancels a tuning job. Starts an asynchronous cancellation request. The server makes a best effort + * to cancel the job, but success is not guaranteed. Clients can use GenAiTuningService.GetTuningJob + * or other methods to check whether the cancellation succeeded or whether the job completed despite + * cancellation. On successful cancellation, the tuning job is not deleted. Instead, its state is + * set to `CANCELLED`, and `error` is set to a status with a `google.rpc.Status.code` of 1, + * corresponding to `Code.CANCELLED`. * * Create a request for the method "tuningJobs.cancel". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Cancel#execute()} method to invoke the remote operation. * - * @param name Required. The name of the TuningJob to cancel. Format: + * @param name Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1CancelTuningJobRequest} * @return the request @@ -140311,13 +140827,12 @@ public class Cancel extends AiplatformRequest * - * @param name Required. The name of the TuningJob to cancel. Format: + * @param name Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1CancelTuningJobRequest} * @since 1.13 @@ -140398,13 +140913,13 @@ public Cancel setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The name of the TuningJob to cancel. Format: + * Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ @com.google.api.client.util.Key private java.lang.String name; - /** Required. The name of the TuningJob to cancel. Format: + /** Required. The name of the tuning job to cancel. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public java.lang.String getName() { @@ -140412,7 +140927,7 @@ public java.lang.String getName() { } /** - * Required. The name of the TuningJob to cancel. Format: + * Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public Cancel setName(java.lang.String name) { @@ -140431,14 +140946,15 @@ public Cancel set(String parameterName, Object value) { } } /** - * Creates a TuningJob. A created TuningJob right away will be attempted to be run. + * Creates a tuning job. A created tuning job will be subsequently executed to start the model + * tuning process. * * Create a request for the method "tuningJobs.create". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Create#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location to create the TuningJob in. Format: + * @param parent Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1TuningJob} * @return the request @@ -140457,7 +140973,8 @@ public class Create extends AiplatformRequest * - * @param parent Required. The resource name of the Location to create the TuningJob in. Format: + * @param parent Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1TuningJob} * @since 1.13 @@ -140538,13 +141055,13 @@ public Create setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location to create the TuningJob in. Format: + * Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location to create the TuningJob in. Format: + /** Required. The resource name of the location to create the tuning job in. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -140552,7 +141069,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location to create the TuningJob in. Format: + * Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` */ public Create setParent(java.lang.String parent) { @@ -140571,14 +141088,14 @@ public Create set(String parameterName, Object value) { } } /** - * Gets a TuningJob. + * Gets a tuning job. * * Create a request for the method "tuningJobs.get". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Get#execute()} method to invoke the remote operation. * - * @param name Required. The name of the TuningJob resource. Format: + * @param name Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @return the request */ @@ -140596,7 +141113,7 @@ public class Get extends AiplatformRequest * - * @param name Required. The name of the TuningJob resource. Format: + * @param name Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @since 1.13 */ @@ -140685,13 +141202,13 @@ public Get setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The name of the TuningJob resource. Format: + * Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ @com.google.api.client.util.Key private java.lang.String name; - /** Required. The name of the TuningJob resource. Format: + /** Required. The name of the tuning job to retrieve. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public java.lang.String getName() { @@ -140699,7 +141216,7 @@ public java.lang.String getName() { } /** - * Required. The name of the TuningJob resource. Format: + * Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public Get setName(java.lang.String name) { @@ -140718,14 +141235,14 @@ public Get set(String parameterName, Object value) { } } /** - * Lists TuningJobs in a Location. + * Lists tuning jobs in a location. * * Create a request for the method "tuningJobs.list". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link List#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location to list the TuningJobs from. Format: + * @param parent Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` * @return the request */ @@ -140743,7 +141260,7 @@ public class List extends AiplatformRequest * - * @param parent Required. The resource name of the Location to list the TuningJobs from. Format: + * @param parent Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` * @since 1.13 */ @@ -140832,13 +141349,13 @@ public List setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location to list the TuningJobs from. Format: + * Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location to list the TuningJobs from. Format: + /** Required. The resource name of the location to list the tuning jobs from. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -140846,7 +141363,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location to list the TuningJobs from. Format: + * Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` */ public List setParent(java.lang.String parent) { @@ -140892,24 +141409,24 @@ public List setPageSize(java.lang.Integer pageSize) { } /** - * Optional. The standard list page token. Typically obtained via + * Optional. The standard list page token. Typically obtained from * ListTuningJobsResponse.next_page_token of the previous - * GenAiTuningService.ListTuningJob][] call. + * GenAiTuningService.ListTuningJobs call. */ @com.google.api.client.util.Key private java.lang.String pageToken; - /** Optional. The standard list page token. Typically obtained via - ListTuningJobsResponse.next_page_token of the previous GenAiTuningService.ListTuningJob][] call. + /** Optional. The standard list page token. Typically obtained from + ListTuningJobsResponse.next_page_token of the previous GenAiTuningService.ListTuningJobs call. */ public java.lang.String getPageToken() { return pageToken; } /** - * Optional. The standard list page token. Typically obtained via + * Optional. The standard list page token. Typically obtained from * ListTuningJobsResponse.next_page_token of the previous - * GenAiTuningService.ListTuningJob][] call. + * GenAiTuningService.ListTuningJobs call. */ public List setPageToken(java.lang.String pageToken) { this.pageToken = pageToken; @@ -140922,14 +141439,16 @@ public List set(String parameterName, Object value) { } } /** - * Rebase a TunedModel. + * Rebase a tuned model. A rebase operation takes a model that was previously tuned on a base model + * version, and retunes it on a new base model version. The rebase operation creates a new tuning + * job and a new tuned model. * * Create a request for the method "tuningJobs.rebaseTunedModel". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link RebaseTunedModel#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location into which to rebase the Model. Format: + * @param parent Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1RebaseTunedModelRequest} * @return the request @@ -140948,7 +141467,9 @@ public class RebaseTunedModel extends AiplatformRequest * - * @param parent Required. The resource name of the Location into which to rebase the Model. Format: + * @param parent Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1.model.GoogleCloudAiplatformV1RebaseTunedModelRequest} * @since 1.13 @@ -141029,13 +141550,13 @@ public RebaseTunedModel setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location into which to rebase the Model. Format: + * Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location into which to rebase the Model. Format: + /** Required. The resource name of the location in which to rebase the Model. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -141043,7 +141564,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location into which to rebase the Model. Format: + * Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` */ public RebaseTunedModel setParent(java.lang.String parent) { @@ -159316,8 +159837,7 @@ private static String chooseEndpoint(com.google.api.client.http.HttpTransport tr * {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport} *
  • Android: {@code newCompatibleTransport} from * {@code com.google.api.client.extensions.android.http.AndroidHttp}
  • - *
  • Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()} - *
  • + *
  • Java: {@code com.google.api.client.http.javanet.NetHttpTransport}
  • * * @param jsonFactory JSON factory, which may be: *
      diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ComputationBasedMetricSpec.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ComputationBasedMetricSpec.java new file mode 100644 index 00000000000..8d74444adf4 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ComputationBasedMetricSpec.java @@ -0,0 +1,90 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * Specification for a computation based metric. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1ComputationBasedMetricSpec extends com.google.api.client.json.GenericJson { + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map parameters; + + /** + * Required. The type of the computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String type; + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @return value or {@code null} for none + */ + public java.util.Map getParameters() { + return parameters; + } + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @param parameters parameters or {@code null} for none + */ + public GoogleCloudAiplatformV1ComputationBasedMetricSpec setParameters(java.util.Map parameters) { + this.parameters = parameters; + return this; + } + + /** + * Required. The type of the computation based metric. + * @return value or {@code null} for none + */ + public java.lang.String getType() { + return type; + } + + /** + * Required. The type of the computation based metric. + * @param type type or {@code null} for none + */ + public GoogleCloudAiplatformV1ComputationBasedMetricSpec setType(java.lang.String type) { + this.type = type; + return this; + } + + @Override + public GoogleCloudAiplatformV1ComputationBasedMetricSpec set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1ComputationBasedMetricSpec) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1ComputationBasedMetricSpec clone() { + return (GoogleCloudAiplatformV1ComputationBasedMetricSpec) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstance.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstance.java index 5c8ae780859..8911f596726 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstance.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstance.java @@ -31,12 +31,19 @@ public final class GoogleCloudAiplatformV1EvaluationInstance extends com.google.api.client.json.GenericJson { /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1EvaluationInstanceAgentData agentData; + /** + * Optional. Data used for agent evaluation. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1EvaluationInstanceAgentData agentEvalData; + /** * Optional. Other data used to populate placeholders based on their key. * The value may be {@code null}. @@ -75,7 +82,7 @@ public final class GoogleCloudAiplatformV1EvaluationInstance extends com.google. private java.util.Map rubricGroups; /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceAgentData getAgentData() { @@ -83,7 +90,7 @@ public GoogleCloudAiplatformV1EvaluationInstanceAgentData getAgentData() { } /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * @param agentData agentData or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstance setAgentData(GoogleCloudAiplatformV1EvaluationInstanceAgentData agentData) { @@ -91,6 +98,23 @@ public GoogleCloudAiplatformV1EvaluationInstance setAgentData(GoogleCloudAiplatf return this; } + /** + * Optional. Data used for agent evaluation. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentData getAgentEvalData() { + return agentEvalData; + } + + /** + * Optional. Data used for agent evaluation. + * @param agentEvalData agentEvalData or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstance setAgentEvalData(GoogleCloudAiplatformV1EvaluationInstanceAgentData agentEvalData) { + this.agentEvalData = agentEvalData; + return this; + } + /** * Optional. Other data used to populate placeholders based on their key. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentConfig.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentConfig.java index a287d4dfada..642313b8805 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentConfig.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentConfig.java @@ -30,12 +30,45 @@ public final class GoogleCloudAiplatformV1EvaluationInstanceAgentConfig extends com.google.api.client.json.GenericJson { /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentId; + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentType; + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String description; + + /** + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1EvaluationInstanceInstanceData developerInstruction; + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List subAgents; + /** * List of tools. * The value may be {@code null}. @@ -52,7 +85,65 @@ public final class GoogleCloudAiplatformV1EvaluationInstanceAgentConfig extends private java.lang.String toolsText; /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @return value or {@code null} for none + */ + public java.lang.String getAgentId() { + return agentId; + } + + /** + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @param agentId agentId or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setAgentId(java.lang.String agentId) { + this.agentId = agentId; + return this; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @return value or {@code null} for none + */ + public java.lang.String getAgentType() { + return agentType; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @param agentType agentType or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setAgentType(java.lang.String agentType) { + this.agentType = agentType; + return this; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @return value or {@code null} for none + */ + public java.lang.String getDescription() { + return description; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @param description description or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setDescription(java.lang.String description) { + this.description = description; + return this; + } + + /** + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceInstanceData getDeveloperInstruction() { @@ -60,7 +151,8 @@ public GoogleCloudAiplatformV1EvaluationInstanceInstanceData getDeveloperInstruc } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * @param developerInstruction developerInstruction or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setDeveloperInstruction(GoogleCloudAiplatformV1EvaluationInstanceInstanceData developerInstruction) { @@ -68,6 +160,25 @@ public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setDeveloperInstruct return this; } + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * @return value or {@code null} for none + */ + public java.util.List getSubAgents() { + return subAgents; + } + + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * @param subAgents subAgents or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentConfig setSubAgents(java.util.List subAgents) { + this.subAgents = subAgents; + return this; + } + /** * List of tools. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentData.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentData.java index 08535802aa6..081881b0da0 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentData.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentData.java @@ -37,7 +37,23 @@ public final class GoogleCloudAiplatformV1EvaluationInstanceAgentData extends co private GoogleCloudAiplatformV1EvaluationInstanceAgentConfig agentConfig; /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map agents; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1EvaluationInstanceAgentConfig used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1EvaluationInstanceAgentConfig.class); + } + + /** + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -59,16 +75,20 @@ public final class GoogleCloudAiplatformV1EvaluationInstanceAgentData extends co /** * 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"] } ] + * description, parameters and required parameters. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String toolsText; + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List turns; + /** * Optional. Agent configuration. * @return value or {@code null} for none @@ -87,7 +107,29 @@ public GoogleCloudAiplatformV1EvaluationInstanceAgentData setAgentConfig(GoogleC } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * @return value or {@code null} for none + */ + public java.util.Map getAgents() { + return agents; + } + + /** + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * @param agents agents or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentData setAgents(java.util.Map agents) { + this.agents = agents; + return this; + } + + /** + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceInstanceData getDeveloperInstruction() { @@ -95,7 +137,8 @@ public GoogleCloudAiplatformV1EvaluationInstanceInstanceData getDeveloperInstruc } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * @param developerInstruction developerInstruction or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceAgentData setDeveloperInstruction(GoogleCloudAiplatformV1EvaluationInstanceInstanceData developerInstruction) { @@ -139,11 +182,7 @@ public GoogleCloudAiplatformV1EvaluationInstanceAgentData setTools(GoogleCloudAi /** * 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"] } ] + * description, parameters and required parameters. * @return value or {@code null} for none */ public java.lang.String getToolsText() { @@ -152,11 +191,7 @@ public java.lang.String getToolsText() { /** * 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"] } ] + * description, parameters and required parameters. * @param toolsText toolsText or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationInstanceAgentData setToolsText(java.lang.String toolsText) { @@ -164,6 +199,25 @@ public GoogleCloudAiplatformV1EvaluationInstanceAgentData setToolsText(java.lang return this; } + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * @return value or {@code null} for none + */ + public java.util.List getTurns() { + return turns; + } + + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * @param turns turns or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentData setTurns(java.util.List turns) { + this.turns = turns; + return this; + } + @Override public GoogleCloudAiplatformV1EvaluationInstanceAgentData set(String fieldName, Object value) { return (GoogleCloudAiplatformV1EvaluationInstanceAgentData) super.set(fieldName, value); diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent.java new file mode 100644 index 00000000000..bd3701237b2 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent.java @@ -0,0 +1,168 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * A single event in the execution trace. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List activeTools; + + /** + * Required. The ID of the agent or entity that generated this event. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String author; + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1Content content; + + /** + * Optional. The timestamp when the event occurred. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private String eventTime; + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map stateDelta; + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @return value or {@code null} for none + */ + public java.util.List getActiveTools() { + return activeTools; + } + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @param activeTools activeTools or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent setActiveTools(java.util.List activeTools) { + this.activeTools = activeTools; + return this; + } + + /** + * Required. The ID of the agent or entity that generated this event. + * @return value or {@code null} for none + */ + public java.lang.String getAuthor() { + return author; + } + + /** + * Required. The ID of the agent or entity that generated this event. + * @param author author or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent setAuthor(java.lang.String author) { + this.author = author; + return this; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1Content getContent() { + return content; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @param content content or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent setContent(GoogleCloudAiplatformV1Content content) { + this.content = content; + return this; + } + + /** + * Optional. The timestamp when the event occurred. + * @return value or {@code null} for none + */ + public String getEventTime() { + return eventTime; + } + + /** + * Optional. The timestamp when the event occurred. + * @param eventTime eventTime or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent setEventTime(String eventTime) { + this.eventTime = eventTime; + return this; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @return value or {@code null} for none + */ + public java.util.Map getStateDelta() { + return stateDelta; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @param stateDelta stateDelta or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent setStateDelta(java.util.Map stateDelta) { + this.stateDelta = stateDelta; + return this; + } + + @Override + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent clone() { + return (GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn.java new file mode 100644 index 00000000000..9b4b1ed424c --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn.java @@ -0,0 +1,123 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * Represents a single turn/invocation in the conversation. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of events that occurred during this turn. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List events; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1EvaluationInstanceAgentDataAgentEvent.class); + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String turnId; + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Integer turnIndex; + + /** + * Optional. The list of events that occurred during this turn. + * @return value or {@code null} for none + */ + public java.util.List getEvents() { + return events; + } + + /** + * Optional. The list of events that occurred during this turn. + * @param events events or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn setEvents(java.util.List events) { + this.events = events; + return this; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @return value or {@code null} for none + */ + public java.lang.String getTurnId() { + return turnId; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @param turnId turnId or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn setTurnId(java.lang.String turnId) { + this.turnId = turnId; + return this; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @return value or {@code null} for none + */ + public java.lang.Integer getTurnIndex() { + return turnIndex; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @param turnIndex turnIndex or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn setTurnIndex(java.lang.Integer turnIndex) { + this.turnIndex = turnIndex; + return this; + } + + @Override + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn clone() { + return (GoogleCloudAiplatformV1EvaluationInstanceAgentDataConversationTurn) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataTools.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataTools.java index e12b24693ad..98c74bd059d 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataTools.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationInstanceAgentDataTools.java @@ -17,7 +17,7 @@ package com.google.api.services.aiplatform.v1.model; /** - * Represents a list of tools for an agent. + * Deprecated. Represents a list of tools for an agent. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationPrompt.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationPrompt.java index d36db055428..6f674e780e4 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationPrompt.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationPrompt.java @@ -17,7 +17,8 @@ package com.google.api.services.aiplatform.v1.model; /** - * Prompt to be evaluated. + * Prompt to be evaluated. This can represent a single-turn prompt or a multi-turn conversation for + * agent evaluations. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRequest.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRequest.java index ef0991f6011..5b894a5f2f9 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRequest.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRequest.java @@ -17,7 +17,11 @@ package com.google.api.services.aiplatform.v1.model; /** - * Single evaluation request. + * A single evaluation request supporting input for both single-turn model generation and multi-turn + * agent execution traces. Valid input modes: 1. Inference Mode: `prompt` is set (containing text or + * AgentData context). 2. Offline Eval Mode: `prompt` is unset, and `candidate_responses` contains + * `agent_data` (the completed execution trace). Validation Rule: Either `prompt` must be set, OR at + * least one of the `candidate_responses` must contain `agent_data`. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: @@ -50,7 +54,7 @@ public final class GoogleCloudAiplatformV1EvaluationRequest extends com.google.a private GoogleCloudAiplatformV1CandidateResponse goldenResponse; /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -99,7 +103,7 @@ public GoogleCloudAiplatformV1EvaluationRequest setGoldenResponse(GoogleCloudAip } /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationPrompt getPrompt() { @@ -107,7 +111,7 @@ public GoogleCloudAiplatformV1EvaluationPrompt getPrompt() { } /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * @param prompt prompt or {@code null} for none */ public GoogleCloudAiplatformV1EvaluationRequest setPrompt(GoogleCloudAiplatformV1EvaluationPrompt prompt) { diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetric.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetric.java index 16d0279d8a0..608373bb2a3 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetric.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetric.java @@ -29,6 +29,13 @@ @SuppressWarnings("javadoc") public final class GoogleCloudAiplatformV1EvaluationRunMetric extends com.google.api.client.json.GenericJson { + /** + * Spec for a computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec computationBasedMetricSpec; + /** * Spec for an LLM based metric. * The value may be {@code null}. @@ -64,6 +71,23 @@ public final class GoogleCloudAiplatformV1EvaluationRunMetric extends com.google @com.google.api.client.util.Key private GoogleCloudAiplatformV1EvaluationRunMetricRubricBasedMetricSpec rubricBasedMetricSpec; + /** + * Spec for a computation based metric. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec getComputationBasedMetricSpec() { + return computationBasedMetricSpec; + } + + /** + * Spec for a computation based metric. + * @param computationBasedMetricSpec computationBasedMetricSpec or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationRunMetric setComputationBasedMetricSpec(GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec computationBasedMetricSpec) { + this.computationBasedMetricSpec = computationBasedMetricSpec; + return this; + } + /** * Spec for an LLM based metric. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec.java new file mode 100644 index 00000000000..d8d6754b249 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec.java @@ -0,0 +1,90 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * Specification for a computation based metric. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec extends com.google.api.client.json.GenericJson { + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map parameters; + + /** + * Required. The type of the computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String type; + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @return value or {@code null} for none + */ + public java.util.Map getParameters() { + return parameters; + } + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @param parameters parameters or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec setParameters(java.util.Map parameters) { + this.parameters = parameters; + return this; + } + + /** + * Required. The type of the computation based metric. + * @return value or {@code null} for none + */ + public java.lang.String getType() { + return type; + } + + /** + * Required. The type of the computation based metric. + * @param type type or {@code null} for none + */ + public GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec setType(java.lang.String type) { + this.type = type; + return this; + } + + @Override + public GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec clone() { + return (GoogleCloudAiplatformV1EvaluationRunMetricComputationBasedMetricSpec) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ListTuningJobsResponse.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ListTuningJobsResponse.java index 65437a23790..240853565c8 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ListTuningJobsResponse.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1ListTuningJobsResponse.java @@ -30,23 +30,23 @@ public final class GoogleCloudAiplatformV1ListTuningJobsResponse extends com.google.api.client.json.GenericJson { /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String nextPageToken; /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.util.List tuningJobs; /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * @return value or {@code null} for none */ public java.lang.String getNextPageToken() { @@ -54,8 +54,8 @@ public java.lang.String getNextPageToken() { } /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * @param nextPageToken nextPageToken or {@code null} for none */ public GoogleCloudAiplatformV1ListTuningJobsResponse setNextPageToken(java.lang.String nextPageToken) { @@ -64,7 +64,7 @@ public GoogleCloudAiplatformV1ListTuningJobsResponse setNextPageToken(java.lang. } /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * @return value or {@code null} for none */ public java.util.List getTuningJobs() { @@ -72,7 +72,7 @@ public java.util.List getTuningJobs() { } /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * @param tuningJobs tuningJobs or {@code null} for none */ public GoogleCloudAiplatformV1ListTuningJobsResponse setTuningJobs(java.util.List tuningJobs) { diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1Metric.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1Metric.java index 5174a9201c7..06cf12a639b 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1Metric.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1Metric.java @@ -43,6 +43,13 @@ public final class GoogleCloudAiplatformV1Metric extends com.google.api.client.j @com.google.api.client.util.Key private GoogleCloudAiplatformV1BleuSpec bleuSpec; + /** + * Spec for a computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1ComputationBasedMetricSpec computationBasedMetricSpec; + /** * Spec for Custom Code Execution metric. * The value may be {@code null}. @@ -126,6 +133,23 @@ public GoogleCloudAiplatformV1Metric setBleuSpec(GoogleCloudAiplatformV1BleuSpec return this; } + /** + * Spec for a computation based metric. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1ComputationBasedMetricSpec getComputationBasedMetricSpec() { + return computationBasedMetricSpec; + } + + /** + * Spec for a computation based metric. + * @param computationBasedMetricSpec computationBasedMetricSpec or {@code null} for none + */ + public GoogleCloudAiplatformV1Metric setComputationBasedMetricSpec(GoogleCloudAiplatformV1ComputationBasedMetricSpec computationBasedMetricSpec) { + this.computationBasedMetricSpec = computationBasedMetricSpec; + return this; + } + /** * Spec for Custom Code Execution metric. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1PurgeMemoriesRequest.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1PurgeMemoriesRequest.java index 526059f1ee2..63105e42e86 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1PurgeMemoriesRequest.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1PurgeMemoriesRequest.java @@ -37,6 +37,24 @@ public final class GoogleCloudAiplatformV1PurgeMemoriesRequest extends com.googl @com.google.api.client.util.Key private java.lang.String filter; + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List filterGroups; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1MemoryConjunctionFilter used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1MemoryConjunctionFilter.class); + } + /** * Optional. If true, the memories will actually be purged. If false, the purge request will be * validated but not executed. @@ -64,6 +82,33 @@ public GoogleCloudAiplatformV1PurgeMemoriesRequest setFilter(java.lang.String fi return this; } + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * @return value or {@code null} for none + */ + public java.util.List getFilterGroups() { + return filterGroups; + } + + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * @param filterGroups filterGroups or {@code null} for none + */ + public GoogleCloudAiplatformV1PurgeMemoriesRequest setFilterGroups(java.util.List filterGroups) { + this.filterGroups = filterGroups; + return this; + } + /** * Optional. If true, the memories will actually be purged. If false, the purge request will be * validated but not executed. diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfig.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfig.java index 3831865ccf7..32e7da14e58 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfig.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfig.java @@ -30,28 +30,47 @@ public final class GoogleCloudAiplatformV1RagManagedDbConfig extends com.google.api.client.json.GenericJson { /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1RagManagedDbConfigBasic basic; /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1RagManagedDbConfigScaled scaled; /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Sets the backend to be the serverless mode offered by RAG Engine. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1RagManagedDbConfigServerless serverless; + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1RagManagedDbConfigSpanner spanner; + + /** + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned unprovisioned; /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfigBasic getBasic() { @@ -59,7 +78,8 @@ public GoogleCloudAiplatformV1RagManagedDbConfigBasic getBasic() { } /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * @param basic basic or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfig setBasic(GoogleCloudAiplatformV1RagManagedDbConfigBasic basic) { @@ -68,7 +88,8 @@ public GoogleCloudAiplatformV1RagManagedDbConfig setBasic(GoogleCloudAiplatformV } /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfigScaled getScaled() { @@ -76,7 +97,8 @@ public GoogleCloudAiplatformV1RagManagedDbConfigScaled getScaled() { } /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * @param scaled scaled or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfig setScaled(GoogleCloudAiplatformV1RagManagedDbConfigScaled scaled) { @@ -85,7 +107,44 @@ public GoogleCloudAiplatformV1RagManagedDbConfig setScaled(GoogleCloudAiplatform } /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Sets the backend to be the serverless mode offered by RAG Engine. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigServerless getServerless() { + return serverless; + } + + /** + * Sets the backend to be the serverless mode offered by RAG Engine. + * @param serverless serverless or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfig setServerless(GoogleCloudAiplatformV1RagManagedDbConfigServerless serverless) { + this.serverless = serverless; + return this; + } + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner getSpanner() { + return spanner; + } + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * @param spanner spanner or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfig setSpanner(GoogleCloudAiplatformV1RagManagedDbConfigSpanner spanner) { + this.spanner = spanner; + return this; + } + + /** + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned getUnprovisioned() { @@ -93,7 +152,8 @@ public GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned getUnprovisioned() } /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * @param unprovisioned unprovisioned or {@code null} for none */ public GoogleCloudAiplatformV1RagManagedDbConfig setUnprovisioned(GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned unprovisioned) { diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigBasic.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigBasic.java index 60e689ae09c..0de3b601521 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigBasic.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigBasic.java @@ -19,7 +19,8 @@ /** * Basic tier is a cost-effective and low compute tier suitable for the following cases: * * Experimenting with RagManagedDb. * Small data size. * Latency insensitive workload. * Only using - * RAG Engine with external vector DBs. NOTE: This is the default tier if not explicitly chosen. + * RAG Engine with external vector DBs. NOTE: This is the default tier under Spanner mode if not + * explicitly chosen. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigServerless.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigServerless.java new file mode 100644 index 00000000000..0315a7e728d --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigServerless.java @@ -0,0 +1,42 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * Message to configure the serverless mode offered by RAG Engine. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1RagManagedDbConfigServerless extends com.google.api.client.json.GenericJson { + + @Override + public GoogleCloudAiplatformV1RagManagedDbConfigServerless set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1RagManagedDbConfigServerless) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1RagManagedDbConfigServerless clone() { + return (GoogleCloudAiplatformV1RagManagedDbConfigServerless) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigSpanner.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigSpanner.java new file mode 100644 index 00000000000..26fdab36d61 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RagManagedDbConfigSpanner.java @@ -0,0 +1,117 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1.model; + +/** + * Message to configure the Spanner database used by RagManagedDb. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1RagManagedDbConfigSpanner extends com.google.api.client.json.GenericJson { + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1RagManagedDbConfigBasic basic; + + /** + * Sets the RagManagedDb to the Scaled tier. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1RagManagedDbConfigScaled scaled; + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned unprovisioned; + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigBasic getBasic() { + return basic; + } + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * @param basic basic or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner setBasic(GoogleCloudAiplatformV1RagManagedDbConfigBasic basic) { + this.basic = basic; + return this; + } + + /** + * Sets the RagManagedDb to the Scaled tier. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigScaled getScaled() { + return scaled; + } + + /** + * Sets the RagManagedDb to the Scaled tier. + * @param scaled scaled or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner setScaled(GoogleCloudAiplatformV1RagManagedDbConfigScaled scaled) { + this.scaled = scaled; + return this; + } + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned getUnprovisioned() { + return unprovisioned; + } + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * @param unprovisioned unprovisioned or {@code null} for none + */ + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner setUnprovisioned(GoogleCloudAiplatformV1RagManagedDbConfigUnprovisioned unprovisioned) { + this.unprovisioned = unprovisioned; + return this; + } + + @Override + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1RagManagedDbConfigSpanner) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1RagManagedDbConfigSpanner clone() { + return (GoogleCloudAiplatformV1RagManagedDbConfigSpanner) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RebaseTunedModelRequest.java b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RebaseTunedModelRequest.java index 347d3bcf3a4..f9c2b41110e 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RebaseTunedModelRequest.java +++ b/clients/google-api-services-aiplatform/v1/2.0.0/com/google/api/services/aiplatform/v1/model/GoogleCloudAiplatformV1RebaseTunedModelRequest.java @@ -30,38 +30,38 @@ public final class GoogleCloudAiplatformV1RebaseTunedModelRequest extends com.google.api.client.json.GenericJson { /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1GcsDestination artifactDestination; /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.Boolean deployToSameEndpoint; /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1TunedModelRef tunedModelRef; /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1TuningJob tuningJob; /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1GcsDestination getArtifactDestination() { @@ -69,7 +69,7 @@ public GoogleCloudAiplatformV1GcsDestination getArtifactDestination() { } /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * @param artifactDestination artifactDestination or {@code null} for none */ public GoogleCloudAiplatformV1RebaseTunedModelRequest setArtifactDestination(GoogleCloudAiplatformV1GcsDestination artifactDestination) { @@ -78,9 +78,10 @@ public GoogleCloudAiplatformV1RebaseTunedModelRequest setArtifactDestination(Goo } /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * @return value or {@code null} for none */ public java.lang.Boolean getDeployToSameEndpoint() { @@ -88,9 +89,10 @@ public java.lang.Boolean getDeployToSameEndpoint() { } /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * @param deployToSameEndpoint deployToSameEndpoint or {@code null} for none */ public GoogleCloudAiplatformV1RebaseTunedModelRequest setDeployToSameEndpoint(java.lang.Boolean deployToSameEndpoint) { @@ -99,7 +101,7 @@ public GoogleCloudAiplatformV1RebaseTunedModelRequest setDeployToSameEndpoint(ja } /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1TunedModelRef getTunedModelRef() { @@ -107,7 +109,7 @@ public GoogleCloudAiplatformV1TunedModelRef getTunedModelRef() { } /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * @param tunedModelRef tunedModelRef or {@code null} for none */ public GoogleCloudAiplatformV1RebaseTunedModelRequest setTunedModelRef(GoogleCloudAiplatformV1TunedModelRef tunedModelRef) { @@ -116,8 +118,7 @@ public GoogleCloudAiplatformV1RebaseTunedModelRequest setTunedModelRef(GoogleClo } /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1TuningJob getTuningJob() { @@ -125,8 +126,7 @@ public GoogleCloudAiplatformV1TuningJob getTuningJob() { } /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * @param tuningJob tuningJob or {@code null} for none */ public GoogleCloudAiplatformV1RebaseTunedModelRequest setTuningJob(GoogleCloudAiplatformV1TuningJob tuningJob) { diff --git a/clients/google-api-services-aiplatform/v1/2.0.0/pom.xml b/clients/google-api-services-aiplatform/v1/2.0.0/pom.xml index 3efa48d7895..f2f75cfe1e6 100644 --- a/clients/google-api-services-aiplatform/v1/2.0.0/pom.xml +++ b/clients/google-api-services-aiplatform/v1/2.0.0/pom.xml @@ -8,8 +8,8 @@ com.google.apis google-api-services-aiplatform - v1-rev20260116-2.0.0 - Vertex AI API v1-rev20260116-2.0.0 + v1-rev20260201-2.0.0 + Vertex AI API v1-rev20260201-2.0.0 jar 2011 diff --git a/clients/google-api-services-aiplatform/v1/README.md b/clients/google-api-services-aiplatform/v1/README.md index b9d91ff410e..3ac10e8bf86 100644 --- a/clients/google-api-services-aiplatform/v1/README.md +++ b/clients/google-api-services-aiplatform/v1/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-aiplatform - v1-rev20260116-2.0.0 + v1-rev20260201-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-aiplatform:v1-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-aiplatform:v1-rev20260201-2.0.0' } ``` diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/README.md b/clients/google-api-services-aiplatform/v1beta1/2.0.0/README.md index 6c7d90cd138..b137dc6a97a 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/README.md +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-aiplatform - v1beta1-rev20260116-2.0.0 + v1beta1-rev20260201-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-aiplatform:v1beta1-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-aiplatform:v1beta1-rev20260201-2.0.0' } ``` diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/Aiplatform.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/Aiplatform.java index e1d93123745..9db1b354599 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/Aiplatform.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/Aiplatform.java @@ -103,7 +103,7 @@ public class Aiplatform extends com.google.api.client.googleapis.services.json.A * {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport} *
    • Android: {@code newCompatibleTransport} from * {@code com.google.api.client.extensions.android.http.AndroidHttp}
    • - *
    • Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()} + *
    • Java: {@code com.google.api.client.http.javanet.NetHttpTransport}
    • * *
    * @param jsonFactory JSON factory, which may be: @@ -42681,7 +42681,10 @@ public GetRagEngineConfig set(String parameterName, Object value) { } } /** - * Lists information about the supported locations for this service. + * Lists information about the supported locations for this service. This method can be called in + * two ways: * **List all public locations:** Use the path `GET /v1/locations`. * **List project- + * visible locations:** Use the path `GET /v1/projects/{project_id}/locations`. This may include + * public locations as well as private or other locations specifically visible to the project. * * Create a request for the method "locations.list". * @@ -42705,7 +42708,10 @@ public class List extends AiplatformRequest { + + private static final String REST_PATH = "v1beta1/{+resource}:getIamPolicy"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Gets the access control policy for a resource. Returns an empty policy if the resource exists + * and does not have a policy set. + * + * Create a request for the method "reasoningEngines.getIamPolicy". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link GetIamPolicy#execute()} method to invoke the remote + * operation.

    {@link + * GetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} + * must be called to initialize this instance immediately after invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @since 1.13 + */ + protected GetIamPolicy(java.lang.String resource) { + super(Aiplatform.this, "POST", REST_PATH, null, com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1Policy.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public GetIamPolicy set$Xgafv(java.lang.String $Xgafv) { + return (GetIamPolicy) super.set$Xgafv($Xgafv); + } + + @Override + public GetIamPolicy setAccessToken(java.lang.String accessToken) { + return (GetIamPolicy) super.setAccessToken(accessToken); + } + + @Override + public GetIamPolicy setAlt(java.lang.String alt) { + return (GetIamPolicy) super.setAlt(alt); + } + + @Override + public GetIamPolicy setCallback(java.lang.String callback) { + return (GetIamPolicy) super.setCallback(callback); + } + + @Override + public GetIamPolicy setFields(java.lang.String fields) { + return (GetIamPolicy) super.setFields(fields); + } + + @Override + public GetIamPolicy setKey(java.lang.String key) { + return (GetIamPolicy) super.setKey(key); + } + + @Override + public GetIamPolicy setOauthToken(java.lang.String oauthToken) { + return (GetIamPolicy) super.setOauthToken(oauthToken); + } + + @Override + public GetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) { + return (GetIamPolicy) super.setPrettyPrint(prettyPrint); + } + + @Override + public GetIamPolicy setQuotaUser(java.lang.String quotaUser) { + return (GetIamPolicy) super.setQuotaUser(quotaUser); + } + + @Override + public GetIamPolicy setUploadType(java.lang.String uploadType) { + return (GetIamPolicy) super.setUploadType(uploadType); + } + + @Override + public GetIamPolicy setUploadProtocol(java.lang.String uploadProtocol) { + return (GetIamPolicy) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy is being requested. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public GetIamPolicy setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + /** + * Optional. The maximum policy version that will be used to format the policy. Valid + * values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests + * for policies with any conditional role bindings must specify version 3. Policies with + * no conditional role bindings may specify any valid value or leave the field unset. The + * policy in the response might use the policy version that you specified, or it might use + * a lower policy version. For example, if you specify version 3, but the policy has no + * conditional role bindings, the response uses version 1. To learn which resources + * support conditions in their IAM policies, see the [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + @com.google.api.client.util.Key("options.requestedPolicyVersion") + private java.lang.Integer optionsRequestedPolicyVersion; + + /** Optional. The maximum policy version that will be used to format the policy. Valid values are 0, 1, + and 3. Requests specifying an invalid value will be rejected. Requests for policies with any + conditional role bindings must specify version 3. Policies with no conditional role bindings may + specify any valid value or leave the field unset. The policy in the response might use the policy + version that you specified, or it might use a lower policy version. For example, if you specify + version 3, but the policy has no conditional role bindings, the response uses version 1. To learn + which resources support conditions in their IAM policies, see the [IAM + documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + public java.lang.Integer getOptionsRequestedPolicyVersion() { + return optionsRequestedPolicyVersion; + } + + /** + * Optional. The maximum policy version that will be used to format the policy. Valid + * values are 0, 1, and 3. Requests specifying an invalid value will be rejected. Requests + * for policies with any conditional role bindings must specify version 3. Policies with + * no conditional role bindings may specify any valid value or leave the field unset. The + * policy in the response might use the policy version that you specified, or it might use + * a lower policy version. For example, if you specify version 3, but the policy has no + * conditional role bindings, the response uses version 1. To learn which resources + * support conditions in their IAM policies, see the [IAM + * documentation](https://cloud.google.com/iam/help/conditions/resource-policies). + */ + public GetIamPolicy setOptionsRequestedPolicyVersion(java.lang.Integer optionsRequestedPolicyVersion) { + this.optionsRequestedPolicyVersion = optionsRequestedPolicyVersion; + return this; + } + + @Override + public GetIamPolicy set(String parameterName, Object value) { + return (GetIamPolicy) super.set(parameterName, value); + } + } /** * Lists reasoning engines in a location. * @@ -143036,6 +143253,153 @@ public Query set(String parameterName, Object value) { return (Query) super.set(parameterName, value); } } + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can + * return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * + * Create a request for the method "reasoningEngines.setIamPolicy". + * + * This request holds the parameters needed by the aiplatform server. After setting any optional + * parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote operation. + * + * @param resource REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1SetIamPolicyRequest} + * @return the request + */ + public SetIamPolicy setIamPolicy(java.lang.String resource, com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1SetIamPolicyRequest content) throws java.io.IOException { + SetIamPolicy result = new SetIamPolicy(resource, content); + initialize(result); + return result; + } + + public class SetIamPolicy extends AiplatformRequest { + + private static final String REST_PATH = "v1beta1/{+resource}:setIamPolicy"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Sets the access control policy on the specified resource. Replaces any existing policy. Can + * return `NOT_FOUND`, `INVALID_ARGUMENT`, and `PERMISSION_DENIED` errors. + * + * Create a request for the method "reasoningEngines.setIamPolicy". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link SetIamPolicy#execute()} method to invoke the remote + * operation.

    {@link + * SetIamPolicy#initialize(com.google.api.client.googleapis.services.AbstractGoogleClientRequest)} + * must be called to initialize this instance immediately after invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1SetIamPolicyRequest} + * @since 1.13 + */ + protected SetIamPolicy(java.lang.String resource, com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1SetIamPolicyRequest content) { + super(Aiplatform.this, "POST", REST_PATH, content, com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1Policy.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public SetIamPolicy set$Xgafv(java.lang.String $Xgafv) { + return (SetIamPolicy) super.set$Xgafv($Xgafv); + } + + @Override + public SetIamPolicy setAccessToken(java.lang.String accessToken) { + return (SetIamPolicy) super.setAccessToken(accessToken); + } + + @Override + public SetIamPolicy setAlt(java.lang.String alt) { + return (SetIamPolicy) super.setAlt(alt); + } + + @Override + public SetIamPolicy setCallback(java.lang.String callback) { + return (SetIamPolicy) super.setCallback(callback); + } + + @Override + public SetIamPolicy setFields(java.lang.String fields) { + return (SetIamPolicy) super.setFields(fields); + } + + @Override + public SetIamPolicy setKey(java.lang.String key) { + return (SetIamPolicy) super.setKey(key); + } + + @Override + public SetIamPolicy setOauthToken(java.lang.String oauthToken) { + return (SetIamPolicy) super.setOauthToken(oauthToken); + } + + @Override + public SetIamPolicy setPrettyPrint(java.lang.Boolean prettyPrint) { + return (SetIamPolicy) super.setPrettyPrint(prettyPrint); + } + + @Override + public SetIamPolicy setQuotaUser(java.lang.String quotaUser) { + return (SetIamPolicy) super.setQuotaUser(quotaUser); + } + + @Override + public SetIamPolicy setUploadType(java.lang.String uploadType) { + return (SetIamPolicy) super.setUploadType(uploadType); + } + + @Override + public SetIamPolicy setUploadProtocol(java.lang.String uploadProtocol) { + return (SetIamPolicy) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy is being specified. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy is being specified. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public SetIamPolicy setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + @Override + public SetIamPolicy set(String parameterName, Object value) { + return (SetIamPolicy) super.set(parameterName, value); + } + } /** * Streams queries using a reasoning engine. * @@ -143176,6 +143540,181 @@ public StreamQuery set(String parameterName, Object value) { return (StreamQuery) super.set(parameterName, value); } } + /** + * Returns permissions that a caller has on the specified resource. If the resource does not exist, + * this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This operation is + * designed to be used for building permission-aware UIs and command-line tools, not for + * authorization checking. This operation may "fail open" without warning. + * + * Create a request for the method "reasoningEngines.testIamPermissions". + * + * This request holds the parameters needed by the aiplatform server. After setting any optional + * parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote operation. + * + * @param resource REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @return the request + */ + public TestIamPermissions testIamPermissions(java.lang.String resource) throws java.io.IOException { + TestIamPermissions result = new TestIamPermissions(resource); + initialize(result); + return result; + } + + public class TestIamPermissions extends AiplatformRequest { + + private static final String REST_PATH = "v1beta1/{+resource}:testIamPermissions"; + + private final java.util.regex.Pattern RESOURCE_PATTERN = + java.util.regex.Pattern.compile("^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + + /** + * Returns permissions that a caller has on the specified resource. If the resource does not + * exist, this will return an empty set of permissions, not a `NOT_FOUND` error. Note: This + * operation is designed to be used for building permission-aware UIs and command-line tools, not + * for authorization checking. This operation may "fail open" without warning. + * + * Create a request for the method "reasoningEngines.testIamPermissions". + * + * This request holds the parameters needed by the the aiplatform server. After setting any + * optional parameters, call the {@link TestIamPermissions#execute()} method to invoke the remote + * operation.

    {@link TestIamPermissions#initialize(com.google.api.client.googleapis.services.A + * bstractGoogleClientRequest)} must be called to initialize this instance immediately after + * invoking the constructor.

    + * + * @param resource REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for + * this field. + * @since 1.13 + */ + protected TestIamPermissions(java.lang.String resource) { + super(Aiplatform.this, "POST", REST_PATH, null, com.google.api.services.aiplatform.v1beta1.model.GoogleIamV1TestIamPermissionsResponse.class); + this.resource = com.google.api.client.util.Preconditions.checkNotNull(resource, "Required parameter resource must be specified."); + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + } + + @Override + public TestIamPermissions set$Xgafv(java.lang.String $Xgafv) { + return (TestIamPermissions) super.set$Xgafv($Xgafv); + } + + @Override + public TestIamPermissions setAccessToken(java.lang.String accessToken) { + return (TestIamPermissions) super.setAccessToken(accessToken); + } + + @Override + public TestIamPermissions setAlt(java.lang.String alt) { + return (TestIamPermissions) super.setAlt(alt); + } + + @Override + public TestIamPermissions setCallback(java.lang.String callback) { + return (TestIamPermissions) super.setCallback(callback); + } + + @Override + public TestIamPermissions setFields(java.lang.String fields) { + return (TestIamPermissions) super.setFields(fields); + } + + @Override + public TestIamPermissions setKey(java.lang.String key) { + return (TestIamPermissions) super.setKey(key); + } + + @Override + public TestIamPermissions setOauthToken(java.lang.String oauthToken) { + return (TestIamPermissions) super.setOauthToken(oauthToken); + } + + @Override + public TestIamPermissions setPrettyPrint(java.lang.Boolean prettyPrint) { + return (TestIamPermissions) super.setPrettyPrint(prettyPrint); + } + + @Override + public TestIamPermissions setQuotaUser(java.lang.String quotaUser) { + return (TestIamPermissions) super.setQuotaUser(quotaUser); + } + + @Override + public TestIamPermissions setUploadType(java.lang.String uploadType) { + return (TestIamPermissions) super.setUploadType(uploadType); + } + + @Override + public TestIamPermissions setUploadProtocol(java.lang.String uploadProtocol) { + return (TestIamPermissions) super.setUploadProtocol(uploadProtocol); + } + + /** + * REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + @com.google.api.client.util.Key + private java.lang.String resource; + + /** REQUIRED: The resource for which the policy detail is being requested. See [Resource + names](https://cloud.google.com/apis/design/resource_names) for the appropriate value for this + field. + */ + public java.lang.String getResource() { + return resource; + } + + /** + * REQUIRED: The resource for which the policy detail is being requested. See [Resource + * names](https://cloud.google.com/apis/design/resource_names) for the appropriate value + * for this field. + */ + public TestIamPermissions setResource(java.lang.String resource) { + if (!getSuppressPatternChecks()) { + com.google.api.client.util.Preconditions.checkArgument(RESOURCE_PATTERN.matcher(resource).matches(), + "Parameter resource must conform to the pattern " + + "^projects/[^/]+/locations/[^/]+/reasoningEngines/[^/]+$"); + } + this.resource = resource; + return this; + } + + /** + * The set of permissions to check for the `resource`. Permissions with wildcards (such as + * `*` or `storage.*`) are not allowed. For more information see [IAM + * Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + @com.google.api.client.util.Key + private java.util.List permissions; + + /** The set of permissions to check for the `resource`. Permissions with wildcards (such as `*` or + `storage.*`) are not allowed. For more information see [IAM + Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + public java.util.List getPermissions() { + return permissions; + } + + /** + * The set of permissions to check for the `resource`. Permissions with wildcards (such as + * `*` or `storage.*`) are not allowed. For more information see [IAM + * Overview](https://cloud.google.com/iam/docs/overview#permissions). + */ + public TestIamPermissions setPermissions(java.util.List permissions) { + this.permissions = permissions; + return this; + } + + @Override + public TestIamPermissions set(String parameterName, Object value) { + return (TestIamPermissions) super.set(parameterName, value); + } + } /** * An accessor for creating requests from the A2a collection. @@ -170883,19 +171422,19 @@ public TuningJobs tuningJobs() { public class TuningJobs { /** - * Cancels a TuningJob. Starts asynchronous cancellation on the TuningJob. The server makes a best - * effort to cancel the job, but success is not guaranteed. Clients can use - * GenAiTuningService.GetTuningJob or other methods to check whether the cancellation succeeded or - * whether the job completed despite cancellation. On successful cancellation, the TuningJob is not - * deleted; instead it becomes a job with a TuningJob.error value with a google.rpc.Status.code of - * 1, corresponding to `Code.CANCELLED`, and TuningJob.state is set to `CANCELLED`. + * Cancels a tuning job. Starts an asynchronous cancellation request. The server makes a best effort + * to cancel the job, but success is not guaranteed. Clients can use GenAiTuningService.GetTuningJob + * or other methods to check whether the cancellation succeeded or whether the job completed despite + * cancellation. On successful cancellation, the tuning job is not deleted. Instead, its state is + * set to `CANCELLED`, and `error` is set to a status with a `google.rpc.Status.code` of 1, + * corresponding to `Code.CANCELLED`. * * Create a request for the method "tuningJobs.cancel". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Cancel#execute()} method to invoke the remote operation. * - * @param name Required. The name of the TuningJob to cancel. Format: + * @param name Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1CancelTuningJobRequest} * @return the request @@ -170914,13 +171453,12 @@ public class Cancel extends AiplatformRequest * - * @param name Required. The name of the TuningJob to cancel. Format: + * @param name Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1CancelTuningJobRequest} * @since 1.13 @@ -171001,13 +171539,13 @@ public Cancel setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The name of the TuningJob to cancel. Format: + * Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ @com.google.api.client.util.Key private java.lang.String name; - /** Required. The name of the TuningJob to cancel. Format: + /** Required. The name of the tuning job to cancel. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public java.lang.String getName() { @@ -171015,7 +171553,7 @@ public java.lang.String getName() { } /** - * Required. The name of the TuningJob to cancel. Format: + * Required. The name of the tuning job to cancel. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public Cancel setName(java.lang.String name) { @@ -171034,14 +171572,15 @@ public Cancel set(String parameterName, Object value) { } } /** - * Creates a TuningJob. A created TuningJob right away will be attempted to be run. + * Creates a tuning job. A created tuning job will be subsequently executed to start the model + * tuning process. * * Create a request for the method "tuningJobs.create". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Create#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location to create the TuningJob in. Format: + * @param parent Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1TuningJob} * @return the request @@ -171060,7 +171599,8 @@ public class Create extends AiplatformRequest * - * @param parent Required. The resource name of the Location to create the TuningJob in. Format: + * @param parent Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1TuningJob} * @since 1.13 @@ -171141,13 +171681,13 @@ public Create setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location to create the TuningJob in. Format: + * Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location to create the TuningJob in. Format: + /** Required. The resource name of the location to create the tuning job in. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -171155,7 +171695,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location to create the TuningJob in. Format: + * Required. The resource name of the location to create the tuning job in. Format: * `projects/{project}/locations/{location}` */ public Create setParent(java.lang.String parent) { @@ -171174,14 +171714,14 @@ public Create set(String parameterName, Object value) { } } /** - * Gets a TuningJob. + * Gets a tuning job. * * Create a request for the method "tuningJobs.get". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link Get#execute()} method to invoke the remote operation. * - * @param name Required. The name of the TuningJob resource. Format: + * @param name Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @return the request */ @@ -171199,7 +171739,7 @@ public class Get extends AiplatformRequest * - * @param name Required. The name of the TuningJob resource. Format: + * @param name Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` * @since 1.13 */ @@ -171288,13 +171828,13 @@ public Get setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The name of the TuningJob resource. Format: + * Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ @com.google.api.client.util.Key private java.lang.String name; - /** Required. The name of the TuningJob resource. Format: + /** Required. The name of the tuning job to retrieve. Format: `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public java.lang.String getName() { @@ -171302,7 +171842,7 @@ public java.lang.String getName() { } /** - * Required. The name of the TuningJob resource. Format: + * Required. The name of the tuning job to retrieve. Format: * `projects/{project}/locations/{location}/tuningJobs/{tuning_job}` */ public Get setName(java.lang.String name) { @@ -171321,14 +171861,14 @@ public Get set(String parameterName, Object value) { } } /** - * Lists TuningJobs in a Location. + * Lists tuning jobs in a location. * * Create a request for the method "tuningJobs.list". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link List#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location to list the TuningJobs from. Format: + * @param parent Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` * @return the request */ @@ -171346,7 +171886,7 @@ public class List extends AiplatformRequest * - * @param parent Required. The resource name of the Location to list the TuningJobs from. Format: + * @param parent Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` * @since 1.13 */ @@ -171435,13 +171975,13 @@ public List setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location to list the TuningJobs from. Format: + * Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location to list the TuningJobs from. Format: + /** Required. The resource name of the location to list the tuning jobs from. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -171449,7 +171989,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location to list the TuningJobs from. Format: + * Required. The resource name of the location to list the tuning jobs from. Format: * `projects/{project}/locations/{location}` */ public List setParent(java.lang.String parent) { @@ -171495,24 +172035,24 @@ public List setPageSize(java.lang.Integer pageSize) { } /** - * Optional. The standard list page token. Typically obtained via + * Optional. The standard list page token. Typically obtained from * ListTuningJobsResponse.next_page_token of the previous - * GenAiTuningService.ListTuningJob][] call. + * GenAiTuningService.ListTuningJobs call. */ @com.google.api.client.util.Key private java.lang.String pageToken; - /** Optional. The standard list page token. Typically obtained via - ListTuningJobsResponse.next_page_token of the previous GenAiTuningService.ListTuningJob][] call. + /** Optional. The standard list page token. Typically obtained from + ListTuningJobsResponse.next_page_token of the previous GenAiTuningService.ListTuningJobs call. */ public java.lang.String getPageToken() { return pageToken; } /** - * Optional. The standard list page token. Typically obtained via + * Optional. The standard list page token. Typically obtained from * ListTuningJobsResponse.next_page_token of the previous - * GenAiTuningService.ListTuningJob][] call. + * GenAiTuningService.ListTuningJobs call. */ public List setPageToken(java.lang.String pageToken) { this.pageToken = pageToken; @@ -171525,14 +172065,15 @@ public List set(String parameterName, Object value) { } } /** - * Optimizes a prompt. + * Optimizes a prompt. Given a prompt, this method returns a stream of optimized prompts expanded + * from the original prompt. * * Create a request for the method "tuningJobs.optimizePrompt". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link OptimizePrompt#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location to optimize the prompt in. Format: + * @param parent Required. The resource name of the location to optimize the prompt in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1OptimizePromptRequest} * @return the request @@ -171551,7 +172092,8 @@ public class OptimizePrompt extends AiplatformRequest * - * @param parent Required. The resource name of the Location to optimize the prompt in. Format: + * @param parent Required. The resource name of the location to optimize the prompt in. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1OptimizePromptRequest} * @since 1.13 @@ -171632,13 +172174,13 @@ public OptimizePrompt setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location to optimize the prompt in. Format: + * Required. The resource name of the location to optimize the prompt in. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location to optimize the prompt in. Format: + /** Required. The resource name of the location to optimize the prompt in. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -171646,7 +172188,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location to optimize the prompt in. Format: + * Required. The resource name of the location to optimize the prompt in. Format: * `projects/{project}/locations/{location}` */ public OptimizePrompt setParent(java.lang.String parent) { @@ -171665,14 +172207,16 @@ public OptimizePrompt set(String parameterName, Object value) { } } /** - * Rebase a TunedModel. + * Rebase a tuned model. A rebase operation takes a model that was previously tuned on a base model + * version, and retunes it on a new base model version. The rebase operation creates a new tuning + * job and a new tuned model. * * Create a request for the method "tuningJobs.rebaseTunedModel". * * This request holds the parameters needed by the aiplatform server. After setting any optional * parameters, call the {@link RebaseTunedModel#execute()} method to invoke the remote operation. * - * @param parent Required. The resource name of the Location into which to rebase the Model. Format: + * @param parent Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1RebaseTunedModelRequest} * @return the request @@ -171691,7 +172235,9 @@ public class RebaseTunedModel extends AiplatformRequest * - * @param parent Required. The resource name of the Location into which to rebase the Model. Format: + * @param parent Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` * @param content the {@link com.google.api.services.aiplatform.v1beta1.model.GoogleCloudAiplatformV1beta1RebaseTunedModelRequest} * @since 1.13 @@ -171772,13 +172318,13 @@ public RebaseTunedModel setUploadProtocol(java.lang.String uploadProtocol) { } /** - * Required. The resource name of the Location into which to rebase the Model. Format: + * Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` */ @com.google.api.client.util.Key private java.lang.String parent; - /** Required. The resource name of the Location into which to rebase the Model. Format: + /** Required. The resource name of the location in which to rebase the Model. Format: `projects/{project}/locations/{location}` */ public java.lang.String getParent() { @@ -171786,7 +172332,7 @@ public java.lang.String getParent() { } /** - * Required. The resource name of the Location into which to rebase the Model. Format: + * Required. The resource name of the location in which to rebase the Model. Format: * `projects/{project}/locations/{location}` */ public RebaseTunedModel setParent(java.lang.String parent) { @@ -195884,8 +196430,7 @@ private static String chooseEndpoint(com.google.api.client.http.HttpTransport tr * {@code com.google.api.client.extensions.appengine.http.UrlFetchTransport} *
  • Android: {@code newCompatibleTransport} from * {@code com.google.api.client.extensions.android.http.AndroidHttp}
  • - *
  • Java: {@link com.google.api.client.googleapis.javanet.GoogleNetHttpTransport#newTrustedTransport()} - *
  • + *
  • Java: {@code com.google.api.client.http.javanet.NetHttpTransport}
  • * * @param jsonFactory JSON factory, which may be: *
      diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentConfig.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentConfig.java new file mode 100644 index 00000000000..7dc934166b1 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentConfig.java @@ -0,0 +1,204 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Represents configuration for an Agent. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1AgentConfig extends com.google.api.client.json.GenericJson { + + /** + * Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentId; + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentType; + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String description; + + /** + * Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static + * or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be + * resolved at runtime using the `AgentEvent.state_delta` field. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String instruction; + + /** + * Optional. The list of valid agent IDs that this agent can delegate to. This defines the + * directed edges in the multi-agent system graph topology. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List subAgents; + + /** + * Optional. The list of tools available to this agent. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List tools; + + /** + * Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @return value or {@code null} for none + */ + public java.lang.String getAgentId() { + return agentId; + } + + /** + * Required. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @param agentId agentId or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setAgentId(java.lang.String agentId) { + this.agentId = agentId; + return this; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @return value or {@code null} for none + */ + public java.lang.String getAgentType() { + return agentType; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @param agentType agentType or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setAgentType(java.lang.String agentType) { + this.agentType = agentType; + return this; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @return value or {@code null} for none + */ + public java.lang.String getDescription() { + return description; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @param description description or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setDescription(java.lang.String description) { + this.description = description; + return this; + } + + /** + * Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static + * or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be + * resolved at runtime using the `AgentEvent.state_delta` field. + * @return value or {@code null} for none + */ + public java.lang.String getInstruction() { + return instruction; + } + + /** + * Optional. Provides instructions for the LLM model, guiding the agent's behavior. Can be static + * or dynamic. Dynamic instructions can contain placeholders like {variable_name} that will be + * resolved at runtime using the `AgentEvent.state_delta` field. + * @param instruction instruction or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setInstruction(java.lang.String instruction) { + this.instruction = instruction; + return this; + } + + /** + * Optional. The list of valid agent IDs that this agent can delegate to. This defines the + * directed edges in the multi-agent system graph topology. + * @return value or {@code null} for none + */ + public java.util.List getSubAgents() { + return subAgents; + } + + /** + * Optional. The list of valid agent IDs that this agent can delegate to. This defines the + * directed edges in the multi-agent system graph topology. + * @param subAgents subAgents or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setSubAgents(java.util.List subAgents) { + this.subAgents = subAgents; + return this; + } + + /** + * Optional. The list of tools available to this agent. + * @return value or {@code null} for none + */ + public java.util.List getTools() { + return tools; + } + + /** + * Optional. The list of tools available to this agent. + * @param tools tools or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentConfig setTools(java.util.List tools) { + this.tools = tools; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1AgentConfig set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1AgentConfig) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1AgentConfig clone() { + return (GoogleCloudAiplatformV1beta1AgentConfig) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentData.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentData.java new file mode 100644 index 00000000000..5b691cdeaac --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentData.java @@ -0,0 +1,102 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Represents data specific to multi-turn agent evaluations. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1AgentData extends com.google.api.client.json.GenericJson { + + /** + * Optional. A map containing the static configurations for each agent in the system. Key: + * agent_id (matches the `author` field in events). Value: The static configuration of the agent. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map agents; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1beta1AgentConfig used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1beta1AgentConfig.class); + } + + /** + * Optional. A chronological list of conversation turns. Each turn represents a logical execution + * cycle (e.g., User Input -> Agent Response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List turns; + + /** + * Optional. A map containing the static configurations for each agent in the system. Key: + * agent_id (matches the `author` field in events). Value: The static configuration of the agent. + * @return value or {@code null} for none + */ + public java.util.Map getAgents() { + return agents; + } + + /** + * Optional. A map containing the static configurations for each agent in the system. Key: + * agent_id (matches the `author` field in events). Value: The static configuration of the agent. + * @param agents agents or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentData setAgents(java.util.Map agents) { + this.agents = agents; + return this; + } + + /** + * Optional. A chronological list of conversation turns. Each turn represents a logical execution + * cycle (e.g., User Input -> Agent Response). + * @return value or {@code null} for none + */ + public java.util.List getTurns() { + return turns; + } + + /** + * Optional. A chronological list of conversation turns. Each turn represents a logical execution + * cycle (e.g., User Input -> Agent Response). + * @param turns turns or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentData setTurns(java.util.List turns) { + this.turns = turns; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1AgentData set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1AgentData) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1AgentData clone() { + return (GoogleCloudAiplatformV1beta1AgentData) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentEvent.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentEvent.java new file mode 100644 index 00000000000..383c40751a6 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1AgentEvent.java @@ -0,0 +1,171 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Represents a single event in the execution trace. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1AgentEvent extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List activeTools; + + /** + * Required. The ID of the agent or entity that generated this event. Use "user" to denote events + * generated by the end-user. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String author; + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1Content content; + + /** + * Optional. The timestamp when the event occurred. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private String eventTime; + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map stateDelta; + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @return value or {@code null} for none + */ + public java.util.List getActiveTools() { + return activeTools; + } + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @param activeTools activeTools or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentEvent setActiveTools(java.util.List activeTools) { + this.activeTools = activeTools; + return this; + } + + /** + * Required. The ID of the agent or entity that generated this event. Use "user" to denote events + * generated by the end-user. + * @return value or {@code null} for none + */ + public java.lang.String getAuthor() { + return author; + } + + /** + * Required. The ID of the agent or entity that generated this event. Use "user" to denote events + * generated by the end-user. + * @param author author or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentEvent setAuthor(java.lang.String author) { + this.author = author; + return this; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1Content getContent() { + return content; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @param content content or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentEvent setContent(GoogleCloudAiplatformV1beta1Content content) { + this.content = content; + return this; + } + + /** + * Optional. The timestamp when the event occurred. + * @return value or {@code null} for none + */ + public String getEventTime() { + return eventTime; + } + + /** + * Optional. The timestamp when the event occurred. + * @param eventTime eventTime or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentEvent setEventTime(String eventTime) { + this.eventTime = eventTime; + return this; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @return value or {@code null} for none + */ + public java.util.Map getStateDelta() { + return stateDelta; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @param stateDelta stateDelta or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentEvent setStateDelta(java.util.Map stateDelta) { + this.stateDelta = stateDelta; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1AgentEvent set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1AgentEvent) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1AgentEvent clone() { + return (GoogleCloudAiplatformV1beta1AgentEvent) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1CandidateResponse.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1CandidateResponse.java index a42232aa13e..55dbe977d6d 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1CandidateResponse.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1CandidateResponse.java @@ -29,6 +29,15 @@ @SuppressWarnings("javadoc") public final class GoogleCloudAiplatformV1beta1CandidateResponse extends com.google.api.client.json.GenericJson { + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This field is used to provide the full output of an agent's + * run, including all turns and events, for direct evaluation. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1AgentData agentData; + /** * Required. The name of the candidate that produced the response. * The value may be {@code null}. @@ -58,6 +67,27 @@ public final class GoogleCloudAiplatformV1beta1CandidateResponse extends com.goo @com.google.api.client.util.Key private java.lang.Object value; + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This field is used to provide the full output of an agent's + * run, including all turns and events, for direct evaluation. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentData getAgentData() { + return agentData; + } + + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This field is used to provide the full output of an agent's + * run, including all turns and events, for direct evaluation. + * @param agentData agentData or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1CandidateResponse setAgentData(GoogleCloudAiplatformV1beta1AgentData agentData) { + this.agentData = agentData; + return this; + } + /** * Required. The name of the candidate that produced the response. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec.java new file mode 100644 index 00000000000..ffbd9cb7bd9 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec.java @@ -0,0 +1,90 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Specification for a computation based metric. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec extends com.google.api.client.json.GenericJson { + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map parameters; + + /** + * Required. The type of the computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String type; + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @return value or {@code null} for none + */ + public java.util.Map getParameters() { + return parameters; + } + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @param parameters parameters or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec setParameters(java.util.Map parameters) { + this.parameters = parameters; + return this; + } + + /** + * Required. The type of the computation based metric. + * @return value or {@code null} for none + */ + public java.lang.String getType() { + return type; + } + + /** + * Required. The type of the computation based metric. + * @param type type or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec setType(java.lang.String type) { + this.type = type; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec clone() { + return (GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ConversationTurn.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ConversationTurn.java new file mode 100644 index 00000000000..4464ef0c2e4 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ConversationTurn.java @@ -0,0 +1,123 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Represents a single turn/invocation in the conversation. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1ConversationTurn extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of events that occurred during this turn. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List events; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1beta1AgentEvent used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1beta1AgentEvent.class); + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String turnId; + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Integer turnIndex; + + /** + * Optional. The list of events that occurred during this turn. + * @return value or {@code null} for none + */ + public java.util.List getEvents() { + return events; + } + + /** + * Optional. The list of events that occurred during this turn. + * @param events events or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ConversationTurn setEvents(java.util.List events) { + this.events = events; + return this; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @return value or {@code null} for none + */ + public java.lang.String getTurnId() { + return turnId; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @param turnId turnId or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ConversationTurn setTurnId(java.lang.String turnId) { + this.turnId = turnId; + return this; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @return value or {@code null} for none + */ + public java.lang.Integer getTurnIndex() { + return turnIndex; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @param turnIndex turnIndex or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ConversationTurn setTurnIndex(java.lang.Integer turnIndex) { + this.turnIndex = turnIndex; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1ConversationTurn set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1ConversationTurn) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1ConversationTurn clone() { + return (GoogleCloudAiplatformV1beta1ConversationTurn) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstance.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstance.java index 07d8f392c02..853b579ec3f 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstance.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstance.java @@ -31,12 +31,19 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstance extends com.google.api.client.json.GenericJson { /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData agentData; + /** + * Optional. Data used for agent evaluation. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData agentEvalData; + /** * Optional. Other data used to populate placeholders based on their key. * The value may be {@code null}. @@ -75,7 +82,7 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstance extends com.go private java.util.Map rubricGroups; /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData getAgentData() { @@ -83,7 +90,7 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData getAgentData() { } /** - * Optional. Data used for agent evaluation. + * Optional. Deprecated. Use `agent_eval_data` instead. Data used for agent evaluation. * @param agentData agentData or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstance setAgentData(GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData agentData) { @@ -91,6 +98,23 @@ public GoogleCloudAiplatformV1beta1EvaluationInstance setAgentData(GoogleCloudAi return this; } + /** + * Optional. Data used for agent evaluation. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData getAgentEvalData() { + return agentEvalData; + } + + /** + * Optional. Data used for agent evaluation. + * @param agentEvalData agentEvalData or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstance setAgentEvalData(GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData agentEvalData) { + this.agentEvalData = agentEvalData; + return this; + } + /** * Optional. Other data used to populate placeholders based on their key. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig.java index d2e2f4a5af9..c09058733d6 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig.java @@ -30,12 +30,45 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig extends com.google.api.client.json.GenericJson { /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentId; + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String agentType; + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String description; + + /** + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData developerInstruction; + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List subAgents; + /** * List of tools. * The value may be {@code null}. @@ -52,7 +85,65 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig ext private java.lang.String toolsText; /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @return value or {@code null} for none + */ + public java.lang.String getAgentId() { + return agentId; + } + + /** + * Optional. Unique identifier of the agent. This ID is used to refer to this agent, e.g., in + * AgentEvent.author, or in the `sub_agents` field. It must be unique within the `agents` map. + * @param agentId agentId or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setAgentId(java.lang.String agentId) { + this.agentId = agentId; + return this; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @return value or {@code null} for none + */ + public java.lang.String getAgentType() { + return agentType; + } + + /** + * Optional. The type or class of the agent (e.g., "LlmAgent", "RouterAgent", "ToolUseAgent"). + * Useful for the autorater to understand the expected behavior of the agent. + * @param agentType agentType or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setAgentType(java.lang.String agentType) { + this.agentType = agentType; + return this; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @return value or {@code null} for none + */ + public java.lang.String getDescription() { + return description; + } + + /** + * Optional. A high-level description of the agent's role and responsibilities. Critical for + * evaluating if the agent is routing tasks correctly. + * @param description description or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setDescription(java.lang.String description) { + this.description = description; + return this; + } + + /** + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData getDeveloperInstruction() { @@ -60,7 +151,8 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData getDeveloperIn } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Contains instructions from the developer for the agent. Can be static or a dynamic + * prompt template used with the `AgentEvent.state_delta` field. * @param developerInstruction developerInstruction or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setDeveloperInstruction(GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData developerInstruction) { @@ -68,6 +160,25 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setDeveloperIns return this; } + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * @return value or {@code null} for none + */ + public java.util.List getSubAgents() { + return subAgents; + } + + /** + * Optional. The list of valid agent IDs (names) that this agent can delegate to. This defines the + * directed edges in the agent system graph topology. + * @param subAgents subAgents or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig setSubAgents(java.util.List subAgents) { + this.subAgents = subAgents; + return this; + } + /** * List of tools. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData.java index 7e6d5afe710..f716ee727f2 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData.java @@ -37,7 +37,23 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData exten private GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig agentConfig; /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map agents; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1beta1EvaluationInstanceAgentConfig.class); + } + + /** + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -59,16 +75,20 @@ public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData exten /** * 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"] } ] + * description, parameters and required parameters. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String toolsText; + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List turns; + /** * Optional. Agent configuration. * @return value or {@code null} for none @@ -87,7 +107,29 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setAgentConfig(Go } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * @return value or {@code null} for none + */ + public java.util.Map getAgents() { + return agents; + } + + /** + * Optional. The static Agent Configuration. This map defines the graph structure of the agent + * system. Key: agent_id (matches the `author` field in events). Value: The static configuration + * of the agent (tools, instructions, sub-agents). + * @param agents agents or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setAgents(java.util.Map agents) { + this.agents = agents; + return this; + } + + /** + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData getDeveloperInstruction() { @@ -95,7 +137,8 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData getDeveloperIn } /** - * Optional. A field containing instructions from the developer for the agent. + * Optional. Deprecated. A field containing instructions from the developer for the agent. Please + * use `agents.developer_instruction` or `turns.events.active_instruction` instead. * @param developerInstruction developerInstruction or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setDeveloperInstruction(GoogleCloudAiplatformV1beta1EvaluationInstanceInstanceData developerInstruction) { @@ -139,11 +182,7 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setTools(GoogleCl /** * 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"] } ] + * description, parameters and required parameters. * @return value or {@code null} for none */ public java.lang.String getToolsText() { @@ -152,11 +191,7 @@ public java.lang.String getToolsText() { /** * 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"] } ] + * description, parameters and required parameters. * @param toolsText toolsText or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setToolsText(java.lang.String toolsText) { @@ -164,6 +199,25 @@ public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setToolsText(java return this; } + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * @return value or {@code null} for none + */ + public java.util.List getTurns() { + return turns; + } + + /** + * Optional. The chronological list of conversation turns. Each turn represents a logical + * execution cycle (e.g., User Input -> Agent Response). + * @param turns turns or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData setTurns(java.util.List turns) { + this.turns = turns; + return this; + } + @Override public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData set(String fieldName, Object value) { return (GoogleCloudAiplatformV1beta1EvaluationInstanceAgentData) super.set(fieldName, value); diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent.java new file mode 100644 index 00000000000..e46a9ae6760 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent.java @@ -0,0 +1,168 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * A single event in the execution trace. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List activeTools; + + /** + * Required. The ID of the agent or entity that generated this event. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String author; + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1Content content; + + /** + * Optional. The timestamp when the event occurred. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private String eventTime; + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map stateDelta; + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @return value or {@code null} for none + */ + public java.util.List getActiveTools() { + return activeTools; + } + + /** + * Optional. The list of tools that were active/available to the agent at the time of this event. + * This overrides the `AgentConfig.tools` if set. + * @param activeTools activeTools or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent setActiveTools(java.util.List activeTools) { + this.activeTools = activeTools; + return this; + } + + /** + * Required. The ID of the agent or entity that generated this event. + * @return value or {@code null} for none + */ + public java.lang.String getAuthor() { + return author; + } + + /** + * Required. The ID of the agent or entity that generated this event. + * @param author author or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent setAuthor(java.lang.String author) { + this.author = author; + return this; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1Content getContent() { + return content; + } + + /** + * Required. The content of the event (e.g., text response, tool call, tool response). + * @param content content or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent setContent(GoogleCloudAiplatformV1beta1Content content) { + this.content = content; + return this; + } + + /** + * Optional. The timestamp when the event occurred. + * @return value or {@code null} for none + */ + public String getEventTime() { + return eventTime; + } + + /** + * Optional. The timestamp when the event occurred. + * @param eventTime eventTime or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent setEventTime(String eventTime) { + this.eventTime = eventTime; + return this; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @return value or {@code null} for none + */ + public java.util.Map getStateDelta() { + return stateDelta; + } + + /** + * Optional. The change in the session state caused by this event. This is a key-value map of + * fields that were modified or added by the event. + * @param stateDelta stateDelta or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent setStateDelta(java.util.Map stateDelta) { + this.stateDelta = stateDelta; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent clone() { + return (GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn.java new file mode 100644 index 00000000000..6e9df3622e8 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn.java @@ -0,0 +1,123 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Represents a single turn/invocation in the conversation. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn extends com.google.api.client.json.GenericJson { + + /** + * Optional. The list of events that occurred during this turn. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List events; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataAgentEvent.class); + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String turnId; + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.Integer turnIndex; + + /** + * Optional. The list of events that occurred during this turn. + * @return value or {@code null} for none + */ + public java.util.List getEvents() { + return events; + } + + /** + * Optional. The list of events that occurred during this turn. + * @param events events or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn setEvents(java.util.List events) { + this.events = events; + return this; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @return value or {@code null} for none + */ + public java.lang.String getTurnId() { + return turnId; + } + + /** + * Optional. A unique identifier for the turn. Useful for referencing specific turns across + * systems. + * @param turnId turnId or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn setTurnId(java.lang.String turnId) { + this.turnId = turnId; + return this; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @return value or {@code null} for none + */ + public java.lang.Integer getTurnIndex() { + return turnIndex; + } + + /** + * Required. The 0-based index of the turn in the conversation sequence. + * @param turnIndex turnIndex or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn setTurnIndex(java.lang.Integer turnIndex) { + this.turnIndex = turnIndex; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn clone() { + return (GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataConversationTurn) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools.java index 01a4522ba48..b868eb90284 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationInstanceAgentDataTools.java @@ -17,7 +17,7 @@ package com.google.api.services.aiplatform.v1beta1.model; /** - * Represents a list of tools for an agent. + * Deprecated. Represents a list of tools for an agent. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationPrompt.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationPrompt.java index 1433674a01d..4bb1968166c 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationPrompt.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationPrompt.java @@ -17,7 +17,8 @@ package com.google.api.services.aiplatform.v1beta1.model; /** - * Prompt to be evaluated. + * Prompt to be evaluated. This can represent a single-turn prompt or a multi-turn conversation for + * agent evaluations. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: @@ -29,6 +30,14 @@ @SuppressWarnings("javadoc") public final class GoogleCloudAiplatformV1beta1EvaluationPrompt extends com.google.api.client.json.GenericJson { + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This serves as the input context for agent scraping. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1AgentData agentData; + /** * Prompt template data. * The value may be {@code null}. @@ -50,6 +59,25 @@ public final class GoogleCloudAiplatformV1beta1EvaluationPrompt extends com.goog @com.google.api.client.util.Key private java.lang.Object value; + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This serves as the input context for agent scraping. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1AgentData getAgentData() { + return agentData; + } + + /** + * Optional. Represents the complete execution trace of a multi-turn conversation, which can + * involve single or multiple agents. This serves as the input context for agent scraping. + * @param agentData agentData or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationPrompt setAgentData(GoogleCloudAiplatformV1beta1AgentData agentData) { + this.agentData = agentData; + return this; + } + /** * Prompt template data. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRequest.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRequest.java index fa7ad36ea18..f4d399cd239 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRequest.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRequest.java @@ -17,7 +17,11 @@ package com.google.api.services.aiplatform.v1beta1.model; /** - * Single evaluation request. + * A single evaluation request supporting input for both single-turn model generation and multi-turn + * agent execution traces. Valid input modes: 1. Inference Mode: `prompt` is set (containing text or + * AgentData context). 2. Offline Eval Mode: `prompt` is unset, and `candidate_responses` contains + * `agent_data` (the completed execution trace). Validation Rule: Either `prompt` must be set, OR at + * least one of the `candidate_responses` must contain `agent_data`. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: @@ -50,7 +54,7 @@ public final class GoogleCloudAiplatformV1beta1EvaluationRequest extends com.goo private GoogleCloudAiplatformV1beta1CandidateResponse goldenResponse; /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -99,7 +103,7 @@ public GoogleCloudAiplatformV1beta1EvaluationRequest setGoldenResponse(GoogleClo } /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationPrompt getPrompt() { @@ -107,7 +111,7 @@ public GoogleCloudAiplatformV1beta1EvaluationPrompt getPrompt() { } /** - * Required. The request/prompt to evaluate. + * Optional. The request/prompt to evaluate. * @param prompt prompt or {@code null} for none */ public GoogleCloudAiplatformV1beta1EvaluationRequest setPrompt(GoogleCloudAiplatformV1beta1EvaluationPrompt prompt) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetric.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetric.java index d8728eb14a8..428d3a2aba9 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetric.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetric.java @@ -29,6 +29,13 @@ @SuppressWarnings("javadoc") public final class GoogleCloudAiplatformV1beta1EvaluationRunMetric extends com.google.api.client.json.GenericJson { + /** + * Spec for a computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec computationBasedMetricSpec; + /** * Spec for an LLM based metric. * The value may be {@code null}. @@ -64,6 +71,23 @@ public final class GoogleCloudAiplatformV1beta1EvaluationRunMetric extends com.g @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1EvaluationRunMetricRubricBasedMetricSpec rubricBasedMetricSpec; + /** + * Spec for a computation based metric. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec getComputationBasedMetricSpec() { + return computationBasedMetricSpec; + } + + /** + * Spec for a computation based metric. + * @param computationBasedMetricSpec computationBasedMetricSpec or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationRunMetric setComputationBasedMetricSpec(GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec computationBasedMetricSpec) { + this.computationBasedMetricSpec = computationBasedMetricSpec; + return this; + } + /** * Spec for an LLM based metric. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec.java new file mode 100644 index 00000000000..2f8a7a83cc4 --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec.java @@ -0,0 +1,90 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Specification for a computation based metric. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec extends com.google.api.client.json.GenericJson { + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.Map parameters; + + /** + * Required. The type of the computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.lang.String type; + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @return value or {@code null} for none + */ + public java.util.Map getParameters() { + return parameters; + } + + /** + * Optional. A map of parameters for the metric, e.g. {"rouge_type": "rougeL"}. + * @param parameters parameters or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec setParameters(java.util.Map parameters) { + this.parameters = parameters; + return this; + } + + /** + * Required. The type of the computation based metric. + * @return value or {@code null} for none + */ + public java.lang.String getType() { + return type; + } + + /** + * Required. The type of the computation based metric. + * @param type type or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec setType(java.lang.String type) { + this.type = type; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec clone() { + return (GoogleCloudAiplatformV1beta1EvaluationRunMetricComputationBasedMetricSpec) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ListTuningJobsResponse.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ListTuningJobsResponse.java index 17a5e74a9d1..39bbb6a2a57 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ListTuningJobsResponse.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1ListTuningJobsResponse.java @@ -30,23 +30,23 @@ public final class GoogleCloudAiplatformV1beta1ListTuningJobsResponse extends com.google.api.client.json.GenericJson { /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String nextPageToken; /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.util.List tuningJobs; /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * @return value or {@code null} for none */ public java.lang.String getNextPageToken() { @@ -54,8 +54,8 @@ public java.lang.String getNextPageToken() { } /** - * A token to retrieve the next page of results. Pass to ListTuningJobsRequest.page_token to - * obtain that page. + * A token to retrieve the next page of results. Pass this token in a subsequent + * [GenAiTuningService.ListTuningJobs] call to retrieve the next page of results. * @param nextPageToken nextPageToken or {@code null} for none */ public GoogleCloudAiplatformV1beta1ListTuningJobsResponse setNextPageToken(java.lang.String nextPageToken) { @@ -64,7 +64,7 @@ public GoogleCloudAiplatformV1beta1ListTuningJobsResponse setNextPageToken(java. } /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * @return value or {@code null} for none */ public java.util.List getTuningJobs() { @@ -72,7 +72,7 @@ public java.util.List getTuningJobs() { } /** - * List of TuningJobs in the requested page. + * The tuning jobs that match the request. * @param tuningJobs tuningJobs or {@code null} for none */ public GoogleCloudAiplatformV1beta1ListTuningJobsResponse setTuningJobs(java.util.List tuningJobs) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1Metric.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1Metric.java index 0b010046614..dde3b524207 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1Metric.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1Metric.java @@ -43,6 +43,13 @@ public final class GoogleCloudAiplatformV1beta1Metric extends com.google.api.cli @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1BleuSpec bleuSpec; + /** + * Spec for a computation based metric. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec computationBasedMetricSpec; + /** * Spec for Custom Code Execution metric. * The value may be {@code null}. @@ -126,6 +133,23 @@ public GoogleCloudAiplatformV1beta1Metric setBleuSpec(GoogleCloudAiplatformV1bet return this; } + /** + * Spec for a computation based metric. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec getComputationBasedMetricSpec() { + return computationBasedMetricSpec; + } + + /** + * Spec for a computation based metric. + * @param computationBasedMetricSpec computationBasedMetricSpec or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1Metric setComputationBasedMetricSpec(GoogleCloudAiplatformV1beta1ComputationBasedMetricSpec computationBasedMetricSpec) { + this.computationBasedMetricSpec = computationBasedMetricSpec; + return this; + } + /** * Spec for Custom Code Execution metric. * @return value or {@code null} for none diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptRequest.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptRequest.java index bef7b313eef..27bffcb8245 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptRequest.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptRequest.java @@ -30,21 +30,21 @@ public final class GoogleCloudAiplatformV1beta1OptimizePromptRequest extends com.google.api.client.json.GenericJson { /** - * Required. The content to optimize. + * Required. The content of the prompt to optimize. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1Content content; /** - * Optional. The optimization strategy for prompt optimization. + * Optional. The optimization strategy to use. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.String optimizationTarget; /** - * Required. The content to optimize. + * Required. The content of the prompt to optimize. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1Content getContent() { @@ -52,7 +52,7 @@ public GoogleCloudAiplatformV1beta1Content getContent() { } /** - * Required. The content to optimize. + * Required. The content of the prompt to optimize. * @param content content or {@code null} for none */ public GoogleCloudAiplatformV1beta1OptimizePromptRequest setContent(GoogleCloudAiplatformV1beta1Content content) { @@ -61,7 +61,7 @@ public GoogleCloudAiplatformV1beta1OptimizePromptRequest setContent(GoogleCloudA } /** - * Optional. The optimization strategy for prompt optimization. + * Optional. The optimization strategy to use. * @return value or {@code null} for none */ public java.lang.String getOptimizationTarget() { @@ -69,7 +69,7 @@ public java.lang.String getOptimizationTarget() { } /** - * Optional. The optimization strategy for prompt optimization. + * Optional. The optimization strategy to use. * @param optimizationTarget optimizationTarget or {@code null} for none */ public GoogleCloudAiplatformV1beta1OptimizePromptRequest setOptimizationTarget(java.lang.String optimizationTarget) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptResponse.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptResponse.java index 9385b359f1b..aff97e3e09e 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptResponse.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1OptimizePromptResponse.java @@ -30,14 +30,14 @@ public final class GoogleCloudAiplatformV1beta1OptimizePromptResponse extends com.google.api.client.json.GenericJson { /** - * Output only. The optimized prompt content. + * Output only. The optimized prompt. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1Content content; /** - * Output only. The optimized prompt content. + * Output only. The optimized prompt. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1Content getContent() { @@ -45,7 +45,7 @@ public GoogleCloudAiplatformV1beta1Content getContent() { } /** - * Output only. The optimized prompt content. + * Output only. The optimized prompt. * @param content content or {@code null} for none */ public GoogleCloudAiplatformV1beta1OptimizePromptResponse setContent(GoogleCloudAiplatformV1beta1Content content) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1PurgeMemoriesRequest.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1PurgeMemoriesRequest.java index 40ce151f635..73cdd02a88b 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1PurgeMemoriesRequest.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1PurgeMemoriesRequest.java @@ -37,6 +37,24 @@ public final class GoogleCloudAiplatformV1beta1PurgeMemoriesRequest extends com. @com.google.api.client.util.Key private java.lang.String filter; + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private java.util.List filterGroups; + + static { + // hack to force ProGuard to consider GoogleCloudAiplatformV1beta1MemoryConjunctionFilter used, since otherwise it would be stripped out + // see https://github.com/google/google-api-java-client/issues/543 + com.google.api.client.util.Data.nullOf(GoogleCloudAiplatformV1beta1MemoryConjunctionFilter.class); + } + /** * Optional. If true, the memories will actually be purged. If false, the purge request will be * validated but not executed. @@ -64,6 +82,33 @@ public GoogleCloudAiplatformV1beta1PurgeMemoriesRequest setFilter(java.lang.Stri return this; } + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * @return value or {@code null} for none + */ + public java.util.List getFilterGroups() { + return filterGroups; + } + + /** + * Optional. Metadata filters that will be applied to the memories to be purged. Filters are + * defined using disjunctive normal form (OR of ANDs). For example: `filter_groups: [{filters: + * [{key: "author", value: {string_value: "agent 123"}, op: EQUAL}]}, {filters: [{key: "label", + * value: {string_value: "travel"}, op: EQUAL}, {key: "author", value: {string_value: "agent + * 321"}, op: EQUAL}]}]` would be equivalent to the logical expression: `(metadata.author = "agent + * 123" OR (metadata.label = "travel" AND metadata.author = "agent 321"))`. + * @param filterGroups filterGroups or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1PurgeMemoriesRequest setFilterGroups(java.util.List filterGroups) { + this.filterGroups = filterGroups; + return this; + } + /** * Optional. If true, the memories will actually be purged. If false, the purge request will be * validated but not executed. diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfig.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfig.java index 5cba599a3a3..42376016173 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfig.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfig.java @@ -30,7 +30,8 @@ public final class GoogleCloudAiplatformV1beta1RagManagedDbConfig extends com.google.api.client.json.GenericJson { /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * The value may be {@code null}. */ @com.google.api.client.util.Key @@ -44,21 +45,39 @@ public final class GoogleCloudAiplatformV1beta1RagManagedDbConfig extends com.go private GoogleCloudAiplatformV1beta1RagManagedDbConfigEnterprise enterprise; /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled scaled; /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Sets the backend to be the serverless mode offered by RAG Engine. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless serverless; + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner spanner; + + /** + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned unprovisioned; /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic getBasic() { @@ -66,7 +85,8 @@ public GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic getBasic() { } /** - * Sets the RagManagedDb to the Basic tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Basic tier. * @param basic basic or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfig setBasic(GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic basic) { @@ -92,7 +112,8 @@ public GoogleCloudAiplatformV1beta1RagManagedDbConfig setEnterprise(GoogleCloudA } /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled getScaled() { @@ -100,7 +121,8 @@ public GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled getScaled() { } /** - * Sets the RagManagedDb to the Scaled tier. This is the default tier if not explicitly chosen. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Scaled tier. * @param scaled scaled or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfig setScaled(GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled scaled) { @@ -109,7 +131,44 @@ public GoogleCloudAiplatformV1beta1RagManagedDbConfig setScaled(GoogleCloudAipla } /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Sets the backend to be the serverless mode offered by RAG Engine. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless getServerless() { + return serverless; + } + + /** + * Sets the backend to be the serverless mode offered by RAG Engine. + * @param serverless serverless or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfig setServerless(GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless serverless) { + this.serverless = serverless; + return this; + } + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner getSpanner() { + return spanner; + } + + /** + * Sets the RAG Engine backend to be RagManagedDb, built on top of Spanner. NOTE: This is the + * default mode (w/ Basic Tier) if not explicitly chosen. + * @param spanner spanner or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfig setSpanner(GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner spanner) { + this.spanner = spanner; + return this; + } + + /** + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned getUnprovisioned() { @@ -117,7 +176,8 @@ public GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned getUnprovisio } /** - * Sets the RagManagedDb to the Unprovisioned tier. + * Deprecated: Use `mode` instead to set the tier under Spanner. Sets the RagManagedDb to the + * Unprovisioned tier. * @param unprovisioned unprovisioned or {@code null} for none */ public GoogleCloudAiplatformV1beta1RagManagedDbConfig setUnprovisioned(GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned unprovisioned) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic.java index ae30ad3ae74..11f74e021e9 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic.java @@ -19,7 +19,8 @@ /** * Basic tier is a cost-effective and low compute tier suitable for the following cases: * * Experimenting with RagManagedDb. * Small data size. * Latency insensitive workload. * Only using - * RAG Engine with external vector DBs. NOTE: This is the default tier if not explicitly chosen. + * RAG Engine with external vector DBs. NOTE: This is the default tier under Spanner mode if not + * explicitly chosen. * *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless.java new file mode 100644 index 00000000000..023a5f86eaf --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless.java @@ -0,0 +1,42 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Message to configure the serverless mode offered by RAG Engine. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless extends com.google.api.client.json.GenericJson { + + @Override + public GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless clone() { + return (GoogleCloudAiplatformV1beta1RagManagedDbConfigServerless) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner.java new file mode 100644 index 00000000000..5869db07c2f --- /dev/null +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner.java @@ -0,0 +1,117 @@ +/* + * 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 + * + * http://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. + */ +/* + * This code was generated by https://github.com/googleapis/google-api-java-client-services/ + * Modify at your own risk. + */ + +package com.google.api.services.aiplatform.v1beta1.model; + +/** + * Message to configure the Spanner database used by RagManagedDb. + * + *

      This is the Java data model class that specifies how to parse/serialize into the JSON that is + * transmitted over HTTP when working with the Vertex AI API. For a detailed explanation see: + * https://developers.google.com/api-client-library/java/google-http-java-client/json + *

      + * + * @author Google, Inc. + */ +@SuppressWarnings("javadoc") +public final class GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner extends com.google.api.client.json.GenericJson { + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic basic; + + /** + * Sets the RagManagedDb to the Scaled tier. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled scaled; + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * The value may be {@code null}. + */ + @com.google.api.client.util.Key + private GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned unprovisioned; + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic getBasic() { + return basic; + } + + /** + * Sets the RagManagedDb to the Basic tier. This is the default tier for Spanner mode if not + * explicitly chosen. + * @param basic basic or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner setBasic(GoogleCloudAiplatformV1beta1RagManagedDbConfigBasic basic) { + this.basic = basic; + return this; + } + + /** + * Sets the RagManagedDb to the Scaled tier. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled getScaled() { + return scaled; + } + + /** + * Sets the RagManagedDb to the Scaled tier. + * @param scaled scaled or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner setScaled(GoogleCloudAiplatformV1beta1RagManagedDbConfigScaled scaled) { + this.scaled = scaled; + return this; + } + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * @return value or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned getUnprovisioned() { + return unprovisioned; + } + + /** + * Sets the RagManagedDb to the Unprovisioned tier. + * @param unprovisioned unprovisioned or {@code null} for none + */ + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner setUnprovisioned(GoogleCloudAiplatformV1beta1RagManagedDbConfigUnprovisioned unprovisioned) { + this.unprovisioned = unprovisioned; + return this; + } + + @Override + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner set(String fieldName, Object value) { + return (GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner) super.set(fieldName, value); + } + + @Override + public GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner clone() { + return (GoogleCloudAiplatformV1beta1RagManagedDbConfigSpanner) super.clone(); + } + +} diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RebaseTunedModelRequest.java b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RebaseTunedModelRequest.java index ea6c96a1d5b..105feaf43f9 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RebaseTunedModelRequest.java +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/com/google/api/services/aiplatform/v1beta1/model/GoogleCloudAiplatformV1beta1RebaseTunedModelRequest.java @@ -30,38 +30,38 @@ public final class GoogleCloudAiplatformV1beta1RebaseTunedModelRequest extends com.google.api.client.json.GenericJson { /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1GcsDestination artifactDestination; /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * The value may be {@code null}. */ @com.google.api.client.util.Key private java.lang.Boolean deployToSameEndpoint; /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1TunedModelRef tunedModelRef; /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * The value may be {@code null}. */ @com.google.api.client.util.Key private GoogleCloudAiplatformV1beta1TuningJob tuningJob; /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1GcsDestination getArtifactDestination() { @@ -69,7 +69,7 @@ public GoogleCloudAiplatformV1beta1GcsDestination getArtifactDestination() { } /** - * Optional. The Google Cloud Storage location to write the artifacts. + * Optional. The Google Cloud Storage location to write the artifacts to. * @param artifactDestination artifactDestination or {@code null} for none */ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setArtifactDestination(GoogleCloudAiplatformV1beta1GcsDestination artifactDestination) { @@ -78,9 +78,10 @@ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setArtifactDestinatio } /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * @return value or {@code null} for none */ public java.lang.Boolean getDeployToSameEndpoint() { @@ -88,9 +89,10 @@ public java.lang.Boolean getDeployToSameEndpoint() { } /** - * Optional. By default, bison to gemini migration will always create new model/endpoint, but for - * gemini-1.0 to gemini-1.5 migration, we default deploy to the same endpoint. See details in this - * Section. + * Optional. By default, rebasing a model creates a new endpoint for the new model. If this flag + * is set to true, the new model will be deployed to the same endpoint as the original model. + * WARNING: If you deploy to the same endpoint, the original model will be un-deployed and + * replaced by the new model. * @param deployToSameEndpoint deployToSameEndpoint or {@code null} for none */ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setDeployToSameEndpoint(java.lang.Boolean deployToSameEndpoint) { @@ -99,7 +101,7 @@ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setDeployToSameEndpoi } /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1TunedModelRef getTunedModelRef() { @@ -107,7 +109,7 @@ public GoogleCloudAiplatformV1beta1TunedModelRef getTunedModelRef() { } /** - * Required. TunedModel reference to retrieve the legacy model information. + * Required. A reference to the tuned model to rebase. * @param tunedModelRef tunedModelRef or {@code null} for none */ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setTunedModelRef(GoogleCloudAiplatformV1beta1TunedModelRef tunedModelRef) { @@ -116,8 +118,7 @@ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setTunedModelRef(Goog } /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * @return value or {@code null} for none */ public GoogleCloudAiplatformV1beta1TuningJob getTuningJob() { @@ -125,8 +126,7 @@ public GoogleCloudAiplatformV1beta1TuningJob getTuningJob() { } /** - * Optional. The TuningJob to be updated. Users can use this TuningJob field to overwrite tuning - * configs. + * Optional. The tuning job to be updated. Users can use this field to overwrite tuning configs. * @param tuningJob tuningJob or {@code null} for none */ public GoogleCloudAiplatformV1beta1RebaseTunedModelRequest setTuningJob(GoogleCloudAiplatformV1beta1TuningJob tuningJob) { diff --git a/clients/google-api-services-aiplatform/v1beta1/2.0.0/pom.xml b/clients/google-api-services-aiplatform/v1beta1/2.0.0/pom.xml index 941bb14a22c..5adc0006f48 100644 --- a/clients/google-api-services-aiplatform/v1beta1/2.0.0/pom.xml +++ b/clients/google-api-services-aiplatform/v1beta1/2.0.0/pom.xml @@ -8,8 +8,8 @@ com.google.apis google-api-services-aiplatform - v1beta1-rev20260116-2.0.0 - Vertex AI API v1beta1-rev20260116-2.0.0 + v1beta1-rev20260201-2.0.0 + Vertex AI API v1beta1-rev20260201-2.0.0 jar 2011 diff --git a/clients/google-api-services-aiplatform/v1beta1/README.md b/clients/google-api-services-aiplatform/v1beta1/README.md index 6c7d90cd138..b137dc6a97a 100644 --- a/clients/google-api-services-aiplatform/v1beta1/README.md +++ b/clients/google-api-services-aiplatform/v1beta1/README.md @@ -22,7 +22,7 @@ Add the following lines to your `pom.xml` file: com.google.apis google-api-services-aiplatform - v1beta1-rev20260116-2.0.0 + v1beta1-rev20260201-2.0.0 @@ -35,7 +35,7 @@ repositories { mavenCentral() } dependencies { - implementation 'com.google.apis:google-api-services-aiplatform:v1beta1-rev20260116-2.0.0' + implementation 'com.google.apis:google-api-services-aiplatform:v1beta1-rev20260201-2.0.0' } ```