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

Ressource : AlphaEvolveProgram

Représente un programme unique à utiliser dans le contexte d'un test AlphaEvolve.

Représentation JSON
{
  "name": string,
  "createTime": string,
  "content": {
    object (AlphaEvolveProgramContent)
  },
  "evaluation": {
    object (AlphaEvolveProgramEvaluation)
  },
  "parentPrograms": [
    string
  ],
  "lockToken": string,
  "state": enum (ProgramState)
}
Champs
name

string

Identifiant. Identifiant unique du programme. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}

createTime

string (Timestamp format)

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

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".

content

object (AlphaEvolveProgramContent)

Facultatif. Contenu du programme.

evaluation

object (AlphaEvolveProgramEvaluation)

Facultatif. Résultats de l'évaluation du programme.

parentPrograms[]

string

Uniquement en sortie. Indique éventuellement les programmes parents à partir desquels ce programme a été développé. Format : projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}

lockToken

string

Facultatif. Jeton de verrouillage pour le programme.

state

enum (ProgramState)

Uniquement en sortie. État du programme.

AlphaEvolveProgramContent

Message autonome contenant le contenu d'un programme. Peut représenter une collection de fichiers.

Représentation JSON
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Champs
description

string

Facultatif. Description du programme.

files[]

object (AlphaEvolveSourceFile)

Obligatoire. Liste des fichiers sources qui composent le programme global.

AlphaEvolveSourceFile

Un fichier source unique avec son chemin d'accès, son contenu et ses métadonnées.

Représentation JSON
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Champs
path

string

Obligatoire. Chemin d'accès relatif au fichier, y compris le nom du fichier (par exemple, "src/main.py", "utils/helpers.js", "README.md").

content

string

Obligatoire. Contenu brut du fichier. Il s'agit d'une chaîne et non d'octets, car elle doit être traitée par le LLM en tant que texte.

programLanguage

string

Facultatif. Langage de programmation du fichier.

description

string

Facultatif. Description supplémentaire du fichier.

AlphaEvolveProgramEvaluation

Résultats de l'évaluation pour un candidat au programme.

Représentation JSON
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Champs
scores

object (AlphaEvolveEvaluationScores)

Facultatif. Contient les scores d'évaluation pour les métriques cibles à optimiser.

insights

object (AlphaEvolveEvaluationInsights)

Facultatif. Représente différents insights sur le candidat, qui ne sont pas directement utilisés comme cible d'optimisation, mais qui peuvent être utilisés pour améliorer les générations ultérieures et, par conséquent, pour construire la requête d'évolution.

AlphaEvolveEvaluationScores

Contient les scores d'évaluation pour les métriques cibles à optimiser.

Représentation JSON
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Champs
scores[]

object (AlphaEvolveEvaluationScore)

Obligatoire. Liste des scores d'évaluation.

AlphaEvolveEvaluationScore

Score pour une seule métrique.

Représentation JSON
{
  "metric": string,
  "score": number
}
Champs
metric

string

Obligatoire. Nom de la métrique.

score

number

Obligatoire. Score d'un programme pour cette métrique.

AlphaEvolveEvaluationInsights

Insights sur l'évaluation d'un programme.

Représentation JSON
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Champs
insights[]

object (AlphaEvolveEvaluationInsight)

Facultatif. Liste des insights sur l'évaluation.

AlphaEvolveEvaluationInsight

Insight d'évaluation unique.

Représentation JSON
{
  "label": string,
  "text": string
}
Champs
label

string

Facultatif. Libellé de l'insight.

text

string

Facultatif. Texte de l'insight.

ProgramState

état d'un programme dans un test.

Enums
PROGRAM_STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
INITIALIZED Le programme est initialisé.
GENERATING Le programme est en cours de génération.
EVALUATING Le programme est en attente d'évaluation.
COMPLETED Le programme est terminé.

Méthodes

create

Crée un objet AlphaEvolveProgram.

get

Récupère un AlphaEvolveProgram existant.

list

Lister tous les AlphaEvolveProgram d'un test donné qui répondent aux critères fournis dans la requête.