REST Resource: projects.locations.collections.engines.sessions.alphaEvolveExperiments

Ressource : AlphaEvolveExperiment

Un test correspond à une seule exécution de l'agent AlphaEvolve, un agent de codage évolutif optimisé par LLM pour la découverte et l'optimisation d'algorithmes.

Représentation JSON 
{
  "name": string,
  "createTime": string,
  "config": {
    object (AlphaEvolveExperimentConfig)
  },
  "stats": {
    object (AlphaEvolveExperimentStats)
  },
  "state": enum (State),
  "initialAlphaEvolveProgram": string
}
Champs
name

string

Identifiant. Nom complet de la ressource du test. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création du test.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
config

object (AlphaEvolveExperimentConfig)

Obligatoire. Configuration du test.
stats

object (AlphaEvolveExperimentStats)

Résultats uniquement. Statistiques de l'expérience.
state

enum (State)

Uniquement en sortie. État du test.
initialAlphaEvolveProgram

string

Uniquement en sortie. Indique le nom du programme source utilisé pour démarrer le test.

AlphaEvolveExperimentConfig

Configuration d'un test.

Représentation JSON 
{
  "title": string,
  "problemDescription": string,
  "programLanguage": string,
  "runSettings": {
    object (RunSettings)
  },
  "generationSettings": {
    object (GenerationSettings)
  },
  "evolutionSettings": {
    object (EvolutionSettings)
  }
}
Champs
title

string

Obligatoire. Titre du test.
problemDescription

string

Obligatoire. Description du problème à résoudre par le test.
programLanguage

string

Obligatoire. Langage de programmation principal du code optimisé.
runSettings

object (RunSettings)

Obligatoire. Paramètres d'exécution du test, qui contrôlent le comportement global de l'exécution du test.
generationSettings

object (GenerationSettings)

Facultatif. Paramètres de génération du test, qui contrôlent la façon dont les nouveaux candidats au programme sont générés, y compris les paramètres LLM, ainsi que le contexte et les requêtes fournis par l'utilisateur.
evolutionSettings

object (EvolutionSettings)

Facultatif. Paramètres d'évolution du test.

RunSettings

Paramètres d'exécution du test.

Représentation JSON 
{
  "maxPrograms": integer,
  "concurrency": integer,
  "maxDuration": string
}
Champs
maxPrograms

integer

Obligatoire. Nombre maximal de programmes à générer lors de l'exécution du test. Le programme initial est comptabilisé dans cette limite. La valeur doit être supérieure à 1.
concurrency

integer

Obligatoire. Nombre maximal de programmes pouvant être générés en parallèle. Doit être positive.
maxDuration

string (Duration format)

Facultatif. Durée maximale du test. Si elle n'est pas spécifiée, la valeur par défaut est de 24 heures.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

GenerationSettings

Paramètres de génération du test.

Représentation JSON 
{
  "context": string,
  "includeFullProgramInPrompt": boolean,
  "models": [
    {
      object (ModelConfig)
    }
  ]
}
Champs
context

string

Facultatif. Contexte supplémentaire fourni par l'utilisateur à utiliser lors de la génération.
includeFullProgramInPrompt

boolean

Facultatif. Si la valeur est "true", l'invite LLM inclut le texte complet du programme (à la fois les régions EVOLVE-BLOCK modifiables et le boilerplate immuable). Si la valeur est "false" (valeur par défaut), seules les régions EVOLVE-BLOCK modifiables sont affichées, ce qui permet d'économiser la fenêtre de contexte.
models[]

object (ModelConfig)

Facultatif. Configuration par modèle. Pour en savoir plus, consultez ModelConfig. Si ce champ n'est pas défini, le serveur sélectionne un modèle par défaut.

ModelConfig

Configuration par modèle. Exclusion mutuelle avec modelMixture et model : lorsque models est défini, modelMixture et model doivent être laissés non définis.

La même liste de modèles autorisés et la même règle de 2 modèles maximum que pour modelMixture s'appliquent. De plus, chaque entrée peut spécifier un temperature par modèle pour l'échantillonnage LLM. Contrairement à modelMixture, les pondérations sont relatives : seuls leurs ratios comptent (le serveur les normalise). Les appelants peuvent donc utiliser n'importe quel nombre positif sans avoir à s'assurer qu'ils totalisent 1.

Représentation JSON 
{
  "name": string,
  "thinkingLevel": enum (ThinkingLevel),
  "weight": number
}
Champs
name

string

Obligatoire. Nom du modèle (par exemple, gemini-2.5-flash ou gemini-3.1-pro-preview). Consultez modelMixture pour obtenir la liste des modèles autorisés.
thinkingLevel

enum (ThinkingLevel)

Facultatif. Envoyé en tant que Vertex ThinkingConfig.thinking_level.
weight

number

Facultatif. Pondération relative de ce modèle dans le mélange. Doit être une valeur finie et strictement positive. Les pondérations de toutes les entrées sont normalisées côté serveur.Elles ne doivent donc pas être égales à 1. La valeur par défaut est 1.0 lorsqu'elle n'est pas définie, ce qui est pratique pour configurer un seul modèle ou un mélange uniforme.

Certains modèles de niveau Pro sont limités à 50% maximum du poids total. Les requêtes qui ne respectent pas cette limite sont refusées et renvoient INVALID_ARGUMENT.

ThinkingLevel

Niveau de réflexion du modèle, sous la forme d'un niveau portable plutôt que d'un budget de jetons. Les niveaux nécessitent un modèle Gemini 3 : Gemini 2.5 et les versions antérieures budgétisent la réflexion en jetons et refusent un niveau d'emblée.

Les niveaux qu'un modèle donné accepte et ceux qu'il utilise lorsque ce paramètre n'est pas défini sont spécifiques à chaque modèle et sont documentés avec le modèle plutôt qu'ici.

Enums
THINKING_LEVEL_UNSPECIFIED Non défini. Le modèle applique sa propre valeur par défaut, qui n'est pas la même pour tous les modèles.
MINIMAL Le moins de réflexion possible. Non disponible sur tous les modèles.
LOW Vertex LOW.
MEDIUM Vertex MEDIUM.
HIGH Vertex HIGH.

EvolutionSettings

Paramètres d'évolution du test.

Représentation JSON 
{
  "parentSamplingConfig": {
    object (ParentSamplingConfig)
  }
}
Champs
parentSamplingConfig

object (ParentSamplingConfig)

Facultatif. Configuration de l'échantillonnage parent.

ParentSamplingConfig

Configuration de l'échantillonnage parent.

Représentation JSON 
{
  "paretoSamplingConfig": {
    object (ParetoSamplingConfig)
  }
}
Champs
paretoSamplingConfig

object (ParetoSamplingConfig)

Facultatif. Configuration de l'échantillonnage de Pareto.

ParetoSamplingConfig

Configuration pour l'échantillonnage Pareto.

Représentation JSON 
{
  "paretoSamplingProbability": number
}
Champs
paretoSamplingProbability

number

Facultatif. Probabilité [0.0, 1.0] d'échantillonner les programmes parents à partir de la frontière de Pareto au lieu de l'échantillonnage normal basé sur la forme physique lors de la génération des candidats. Utile pour optimiser plusieurs métriques simultanément. La valeur par défaut est 0.0 (désactivé). N'est efficace que lorsque l'évaluation renvoie plusieurs métriques dans scores_to_optimize.

AlphaEvolveExperimentStats

Statistiques sur le test.

Représentation JSON 
{
  "candidatesCount": integer,
  "evaluatedCandidatesCount": integer,
  "inputTokenCount": string,
  "outputTokenCount": string
}
Champs
candidatesCount

integer

Uniquement en sortie. Nombre de candidats générés.
evaluatedCandidatesCount

integer

Uniquement en sortie. Nombre de candidats évalués.
inputTokenCount

string (int64 format)

Uniquement en sortie. Nombre de jetons d'entrée facturés consommés par le test.
outputTokenCount

string (int64 format)

Uniquement en sortie. Nombre de jetons de sortie facturés consommés par le test.

État

les valeurs d'état du test.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
CREATED Le test est créé.
RUNNING Le test est en cours.
PAUSED Le test est suspendu.
COMPLETED Le test est terminé.
FAILED Le test a échoué.

Méthodes

acquirePrograms

 Acquiert un ou plusieurs AlphaEvolveProgram à partir de la file d'attente de programmes générée pour l'évaluation.

create

 Crée un objet AlphaEvolveExperiment.

delete

 Supprime un test à condition qu'il soit dans un état final (par exemple,

get

 Obtenez un AlphaEvolveExperiment existant.

list

 Répertoriez tous les AlphaEvolveExperiment d'une session donnée.

resume

 Reprend un workflow pour traiter le AlphaEvolveExperiment.

start

 Démarre un workflow pour traiter le AlphaEvolveExperiment.

submitProgramsEvaluations

 Ajoute un AlphaEvolveProgramEvaluation au test.