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

Recurso: AlphaEvolveProgram

Representa un solo programa que se usará en el contexto de un experimento de AlphaEvolve.

Representación JSON
{
  "name": string,
  "createTime": string,
  "content": {
    object (AlphaEvolveProgramContent)
  },
  "evaluation": {
    object (AlphaEvolveProgramEvaluation)
  },
  "parentPrograms": [
    string
  ],
  "lockToken": string,
  "state": enum (ProgramState)
}
Campos
name

string

Es el identificador. Es el identificador único del programa. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}

createTime

string (Timestamp format)

Solo salida. Es la fecha y hora en que se creó el programa.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".

content

object (AlphaEvolveProgramContent)

Es opcional. Es el contenido del programa.

evaluation

object (AlphaEvolveProgramEvaluation)

Es opcional. Son los resultados de la evaluación del programa.

parentPrograms[]

string

Solo salida. Especifica de forma opcional a partir de qué programas principales evolucionó este programa. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}

lockToken

string

Es opcional. Es el token de bloqueo del programa.

state

enum (ProgramState)

Solo salida. Es el estado del programa.

AlphaEvolveProgramContent

Es un mensaje independiente que contiene el contenido de un programa. Puede representar una colección de archivos.

Representación JSON
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Campos
description

string

Opcional. Es la descripción del programa.

files[]

object (AlphaEvolveSourceFile)

Obligatorio. Es una lista de los archivos fuente que componen el programa general.

AlphaEvolveSourceFile

Es un solo archivo fuente con su ruta de acceso, contenido y metadatos.

Representación JSON
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Campos
path

string

Obligatorio. Ruta de acceso relativa del archivo, incluido el nombre del archivo, p. ej., "src/main.py", "utils/helpers.js", "README.md"

content

string

Obligatorio. Es el contenido sin procesar del archivo. Es una cadena y no bytes, ya que, en última instancia, el LLM debería procesarla como texto.

programLanguage

string

Es opcional. Es el lenguaje de programación del archivo.

description

string

Es opcional. Es una descripción adicional del archivo.

AlphaEvolveProgramEvaluation

Son los resultados de la evaluación de un candidato del programa.

Representación JSON
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Campos
scores

object (AlphaEvolveEvaluationScores)

Es opcional. Contiene las puntuaciones de evaluación de las métricas objetivo que se optimizarán.

insights

object (AlphaEvolveEvaluationInsights)

Es opcional. Representa varias estadísticas sobre el candidato, que no se utilizan directamente como objetivo de optimización, pero que se pueden usar para mejorar las generaciones posteriores y, por lo tanto, se pueden usar para construir la instrucción de evolución.

AlphaEvolveEvaluationScores

Contiene las puntuaciones de evaluación de las métricas objetivo que se optimizarán.

Representación JSON
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Campos
scores[]

object (AlphaEvolveEvaluationScore)

Obligatorio. Es una lista de las puntuaciones de evaluación.

AlphaEvolveEvaluationScore

Es la puntuación de una sola métrica.

Representación JSON
{
  "metric": string,
  "score": number
}
Campos
metric

string

Obligatorio. Es el nombre de la métrica.

score

number

Obligatorio. Es la puntuación de un programa para esta métrica.

AlphaEvolveEvaluationInsights

Son las estadísticas de evaluación de un programa.

Representación JSON
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Campos
insights[]

object (AlphaEvolveEvaluationInsight)

Es opcional. Es la lista de estadísticas de evaluación.

AlphaEvolveEvaluationInsight

Es una sola estadística de evaluación.

Representación JSON
{
  "label": string,
  "text": string
}
Campos
label

string

Es opcional y representa la etiqueta de la estadística.

text

string

Es opcional. Es el texto de la estadística.

ProgramState

Es el estado de un programa en un experimento.

Enums
PROGRAM_STATE_UNSPECIFIED Valor predeterminado. Este valor no se usa.
INITIALIZED Se inicializó el programa.
GENERATING El programa está en proceso de generación.
EVALUATING El programa está pendiente de evaluación.
COMPLETED Se completó el programa.

Métodos

create

Crea una AlphaEvolveProgram nueva.

get

Obtiene un AlphaEvolveProgram existente.

list

Enumera todos los AlphaEvolvePrograms de un experimento determinado que cumplen con los criterios proporcionados en la solicitud.