- [Resource: AlphaEvolveExperiment](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment.SCHEMA_REPRESENTATION)
- [AlphaEvolveExperimentConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentConfig.SCHEMA_REPRESENTATION)
- [RunSettings](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#RunSettings)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#RunSettings.SCHEMA_REPRESENTATION)
- [GenerationSettings](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#GenerationSettings)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#GenerationSettings.SCHEMA_REPRESENTATION)
- [ModelConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ModelConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ModelConfig.SCHEMA_REPRESENTATION)
- [ThinkingLevel](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ThinkingLevel)
- [EvolutionSettings](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#EvolutionSettings)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#EvolutionSettings.SCHEMA_REPRESENTATION)
- [ParentSamplingConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParentSamplingConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParentSamplingConfig.SCHEMA_REPRESENTATION)
- [ParetoSamplingConfig](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParetoSamplingConfig)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParetoSamplingConfig.SCHEMA_REPRESENTATION)
- [AlphaEvolveExperimentStats](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentStats)
  - [JSON representation](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentStats.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#State)
- [Methods](https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#METHODS_SUMMARY)

## Resource: AlphaEvolveExperiment

An experiment is a single run of the AlphaEvolve agent, an evolutionary coding agent powered by LLM for algorithm discovery and optimization.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "config": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentConfig`) }, "stats": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentStats`) }, "state": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#State`), "initialAlphaEvolveProgram": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The full resource name of the experiment. Format: `projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}` |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. time when the experiment was created. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `config` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentConfig`)`` Required. experiment configuration. |
| `stats` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperimentStats`)`` Output only. experiment stats. |
| `state` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#State`)`` Output only. The state of the experiment. |
| `initialAlphaEvolveProgram` | `string` Output only. Specifies the name of the seed program used to start the experiment. |

## AlphaEvolveExperimentConfig

Configuration of an experiment.

| JSON representation |
|---|
| ``` { "title": string, "problemDescription": string, "programLanguage": string, "runSettings": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#RunSettings`) }, "generationSettings": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#GenerationSettings`) }, "evolutionSettings": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#EvolutionSettings`) } } ``` |

| Fields ||
|---|---|
| `title` | `string` Required. title of the experiment. |
| `problemDescription` | `string` Required. description of the problem to be solved by the experiment. |
| `programLanguage` | `string` Required. Primary programming language of the code being optimized. |
| `runSettings` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#RunSettings`)`` Required. Run settings for the experiment, controlling the overall behavior of the experiment run. |
| `generationSettings` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#GenerationSettings`)`` Optional. Generation settings for the experiment, controlling how new program candidates are generated, including things LLM parameters and user-provided context and prompts. |
| `evolutionSettings` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#EvolutionSettings`)`` Optional. Evolution settings for the experiment. |

## RunSettings

Run settings for the experiment.

| JSON representation |
|---|
| ``` { "maxPrograms": integer, "concurrency": integer, "maxDuration": string } ``` |

| Fields ||
|---|---|
| `maxPrograms` | `integer` Required. Maximum number of programs to generate during the experiment run. The initial program counts towards this limit. Must be greater than 1. |
| `concurrency` | `integer` Required. Maximum number of programs that can be generated in parallel. Must be positive. |
| `maxDuration` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#duration` format)`` Optional. Maximum duration of the experiment. If unset, defaults to 24 hours. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `"3.5s"`. |

## GenerationSettings

Generation settings for the experiment.

| JSON representation |
|---|
| ``` { "context": string, "includeFullProgramInPrompt": boolean, "models": [ { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ModelConfig`) } ] } ``` |

| Fields ||
|---|---|
| `context` | `string` Optional. Additional user-provided context to be used during generation. |
| `includeFullProgramInPrompt` | `boolean` Optional. When true, the LLM prompt includes the full program text (both mutable EVOLVE-BLOCK regions and immutable boilerplate). When false (default), only the mutable EVOLVE-BLOCK regions are shown, saving context window. |
| `models[]` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ModelConfig`)`` Optional. Per-model configuration. See `ModelConfig` for details. If left unset, the server selects a default model. |

## ModelConfig

Per-model configuration. Mutually exclusive with `modelMixture` and `model`: when `models` is set, both `modelMixture` and `model` must be left unset.

The same allowed-model list and at-most-2-models rule as for `modelMixture` apply. In addition, each entry may specify a per-model `temperature` for LLM sampling. Unlike `modelMixture`, weights here are *relative*: only their ratios matter (the server normalizes them), so callers may use any positive numbers without having to ensure they sum to 1.0.

| JSON representation |
|---|
| ``` { "name": string, "thinkingLevel": enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ThinkingLevel`), "weight": number } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. Model name (e.g. `gemini-2.5-flash`, `gemini-3.1-pro-preview`). See `modelMixture` for the list of allowed models. |
| `thinkingLevel` | ``enum (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ThinkingLevel`)`` Optional. Sent as Vertex `ThinkingConfig.thinking_level`. |
| `weight` | `number` Optional. Relative weight for this model in the mixture. Must be a finite, strictly positive value. Weights across all entries are normalized server-side, so they need not sum to 1.0. Defaults to 1.0 when unset, which is convenient when configuring a single model or an even mixture. Some Pro-tier models are capped at most 50% of the total weight; requests violating that cap are rejected with INVALID_ARGUMENT. |

## ThinkingLevel

How hard the model should think, as a portable level rather than a token budget. Levels need a Gemini 3 model: Gemini 2.5 and earlier budget thinking in tokens and reject a level outright.

Which levels a given model accepts, and which it uses when this is unset, are per-model and documented with the model rather than here.

| Enums ||
|---|---|
| `THINKING_LEVEL_UNSPECIFIED` | Unset. The model applies its own default, which is not the same level for every model. |
| `MINIMAL` | Least thinking. Not offered by every model. |
| `LOW` | Vertex `LOW`. |
| `MEDIUM` | Vertex `MEDIUM`. |
| `HIGH` | Vertex `HIGH`. |

## EvolutionSettings

Evolution settings for the experiment.

| JSON representation |
|---|
| ``` { "parentSamplingConfig": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParentSamplingConfig`) } } ``` |

| Fields ||
|---|---|
| `parentSamplingConfig` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParentSamplingConfig`)`` Optional. Parent sampling configuration. |

## ParentSamplingConfig

Configuration for parent sampling.

| JSON representation |
|---|
| ``` { "paretoSamplingConfig": { object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParetoSamplingConfig`) } } ``` |

| Fields ||
|---|---|
| `paretoSamplingConfig` | ``object (`https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#ParetoSamplingConfig`)`` Optional. Pareto sampling configuration. |

## ParetoSamplingConfig

Configuration for Pareto sampling.

| JSON representation |
|---|
| ``` { "paretoSamplingProbability": number } ``` |

| Fields ||
|---|---|
| `paretoSamplingProbability` | `number` Optional. probability \[0.0, 1.0\] of sampling parent programs from the Pareto frontier instead of normal fitness-based sampling during candidate generation. Useful when optimizing multiple metrics simultaneously. Default 0.0 (disabled). Only effective when evaluation returns multiple metrics in scores_to_optimize. |

## AlphaEvolveExperimentStats

Stats about the experiment.

| JSON representation |
|---|
| ``` { "candidatesCount": integer, "evaluatedCandidatesCount": integer, "inputTokenCount": string, "outputTokenCount": string } ``` |

| Fields ||
|---|---|
| `candidatesCount` | `integer` Output only. Number of candidates generated. |
| `evaluatedCandidatesCount` | `integer` Output only. Number of candidates evaluated. |
| `inputTokenCount` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. Number of billed input tokens consumed by the experiment. |
| `outputTokenCount` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. Number of billed output tokens consumed by the experiment. |

## State

experiment state values.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Default value. This value is unused. |
| `CREATED` | The experiment is created. |
| `RUNNING` | The experiment is running. |
| `PAUSED` | The experiment is paused. |
| `COMPLETED` | The experiment is completed. |
| `FAILED` | The experiment has failed. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/acquirePrograms` | Acquires one or more `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms#AlphaEvolveProgram` from the generated queue of programs for evaluation. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/create` | Creates a new `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/delete` | Deletes an experiment provided the experiment is in an end state (e.g. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/get` | Get an existing `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/list` | List all `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment`s in a given session. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/resume` | Resumes a workflow to process the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/start` | Starts a workflow to process the `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments#AlphaEvolveExperiment`. |
| ### `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments/submitProgramsEvaluations` | Adds an `https://docs.cloud.google.com/gemini/enterprise/docs/reference/rest/v1alpha/projects.locations.collections.engines.sessions.alphaEvolveExperiments.alphaEvolvePrograms#AlphaEvolveProgramEvaluation` to the experiment. |