Method: projects.locations.studies.trials.suggest

Adds one or more trials to a study, with parameter values suggested by AI Platform Vizier. Returns a long-running operation associated with the generation of trial suggestions. When this long-running operation succeeds, it will contain a SuggestTrialsResponse.

HTTP request

POST https://us-central1-ml.googleapis.com/v1/{parent=projects/*/locations/*/studies/*}/trials:suggest

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

Required. The name of the study that the trial belongs to.

Request body

The request body contains data with the following structure:

JSON representation
{
  "suggestionCount": integer,
  "clientId": string
}
Fields
suggestionCount

integer

Required. The number of suggestions requested.

clientId

string

Required. The identifier of the client that is requesting the suggestion.

If multiple SuggestTrialsRequests have the same clientId, the service will return the identical suggested trial if the trial is pending, and provide a new trial if the last suggested trial was completed.

Response body

If successful, the response body contains an instance of Operation.

Authorization Scopes

Requires the following OAuth scope:

  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.