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

Recurso: AlphaEvolveProgram

Representa um único programa a ser usado no contexto de um experimento do AlphaEvolve.

Representação JSON 
{
  "name": string,
  "createTime": string,
  "content": {
    object (AlphaEvolveProgramContent)
  },
  "evaluation": {
    object (AlphaEvolveProgramEvaluation)
  },
  "parentPrograms": [
    string
  ],
  "lockToken": string,
  "state": enum (ProgramState)
}
Campos
name

string

Identificador. Identificador exclusivo do programa. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

Somente saída. Horário em que o programa foi criado.

Usa o padrão RFC 3339, em que a saída gerada é sempre convertida em Z e tem 0, 3, 6 ou 9 dígitos fracionários. Além de Z, outros ajustes também são aceitos. Exemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
content

object (AlphaEvolveProgramContent)

Opcional. Conteúdo do programa.
evaluation

object (AlphaEvolveProgramEvaluation)

Opcional. Resultados da avaliação do programa.
parentPrograms[]

string

Apenas saída. Especifica opcionalmente quais programas principais deram origem a este programa. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
lockToken

string

Opcional. Token de bloqueio do programa.
state

enum (ProgramState)

Somente saída. Estado do programa.

AlphaEvolveProgramContent

Uma mensagem independente que contém o conteúdo de um programa. Pode representar uma coleção de arquivos.

Representação JSON 
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Campos
description

string

Opcional. Descrição do programa.
files[]

object (AlphaEvolveSourceFile)

Obrigatório. Uma lista de arquivos de origem que compõem o programa geral.

AlphaEvolveSourceFile

Um único arquivo de origem com caminho, conteúdo e metadados.

Representação JSON 
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Campos
path

string

Obrigatório. O caminho relativo do arquivo, incluindo o nome do arquivo. Por exemplo, "src/main.py", "utils/helpers.js", "README.md"
content

string

Obrigatório. O conteúdo bruto do arquivo. É uma string, não bytes, porque precisa ser processada pelo LLM como texto.
programLanguage

string

Opcional. A linguagem de programação do arquivo.
description

string

Opcional. Descrição adicional do arquivo.

AlphaEvolveProgramEvaluation

Resultados da avaliação de um candidato a programa.

Representação JSON 
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Campos
scores

object (AlphaEvolveEvaluationScores)

Opcional. Contém as pontuações de avaliação das métricas de destino a serem otimizadas.
insights

object (AlphaEvolveEvaluationInsights)

Opcional. Representa vários insights sobre o candidato, que não são usados diretamente como meta de otimização, mas podem ser usados para melhorar as gerações subsequentes e, portanto, podem ser usados para criar o comando de evolução.

AlphaEvolveEvaluationScores

Contém as pontuações de avaliação das métricas de destino a serem otimizadas.

Representação JSON 
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Campos
scores[]

object (AlphaEvolveEvaluationScore)

Obrigatório. Lista de pontuações de avaliação.

AlphaEvolveEvaluationScore

Pontuação de uma única métrica.

Representação JSON 
{
  "metric": string,
  "score": number
}
Campos
metric

string

Obrigatório. Nome da métrica.
score

number

Obrigatório. Pontuação de um programa para essa métrica.

AlphaEvolveEvaluationInsights

Insights de avaliação de um programa.

Representação JSON 
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Campos
insights[]

object (AlphaEvolveEvaluationInsight)

Opcional. Lista de insights da avaliação.

AlphaEvolveEvaluationInsight

Um único insight de avaliação.

Representação JSON 
{
  "label": string,
  "text": string
}
Campos
label

string

Opcional. Rótulo do insight.
text

string

Opcional. Texto do insight.

ProgramState

estado de um programa em um experimento.

Tipos enumerados
PROGRAM_STATE_UNSPECIFIED Valor padrão. Esse valor não é usado.
INITIALIZED O programa é inicializado.
GENERATING O programa está em geração.
EVALUATING O programa está com avaliação pendente.
COMPLETED O programa é concluído.

Métodos

create

 Cria uma AlphaEvolveProgram.

get

 Recebe um AlphaEvolveProgram atual.

list

 Liste todos os AlphaEvolvePrograms em um determinado experimento que seguem os critérios fornecidos na solicitação.