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

资源：AlphaEvolveProgram

表示要在 AlphaEvolve 实验中使用的一个程序。

JSON 表示法 
{
  "name": string,
  "createTime": string,
  "content": {
    object (AlphaEvolveProgramContent)
  },
  "evaluation": {
    object (AlphaEvolveProgramEvaluation)
  },
  "parentPrograms": [
    string
  ],
  "lockToken": string,
  "state": enum (ProgramState)
}
字段
name

string

标识符。计划的唯一标识符。格式：projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

仅限输出。计划的创建时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
content

object (AlphaEvolveProgramContent)

可选。计划的内容。
evaluation

object (AlphaEvolveProgramEvaluation)

可选。计划的评估结果。
parentPrograms[]

string

仅限输出。（可选）指定相应计划是从哪些父计划演变而来的。格式：projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
lockToken

string

可选。相应计划的锁定令牌。
state

enum (ProgramState)

仅限输出。计划的状态。

AlphaEvolveProgramContent

包含节目内容的独立消息。可表示文件集合。

JSON 表示法 
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
字段
description

string

可选。计划的说明。
files[]

object (AlphaEvolveSourceFile)

必需。构成整个计划的源文件列表。

AlphaEvolveSourceFile

单个源文件及其路径、内容和元数据。

JSON 表示法 
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
字段
path

string

必需。文件的相对路径，包括文件名。例如，“src/main.py”“utils/helpers.js”“README.md”
content

string

必需。文件的原始内容。这是字符串而不是字节，因为最终应由 LLM 将其作为文本进行处理。
programLanguage

string

可选。文件的编程语言。
description

string

可选。文件的其他说明。

AlphaEvolveProgramEvaluation

计划候选方案的评估结果。

JSON 表示法 
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
字段
scores

object (AlphaEvolveEvaluationScores)

可选。包含要优化的目标指标的评估得分。
insights

object (AlphaEvolveEvaluationInsights)

可选。表示与候选方案相关的各种信息，这些信息不会直接用作优化目标，但可用于改进后续代，因此可用于构建进化提示。

AlphaEvolveEvaluationScores

包含要优化的目标指标的评估得分。

JSON 表示法 
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
字段
scores[]

object (AlphaEvolveEvaluationScore)

必需。评估得分列表。

AlphaEvolveEvaluationScore

单个指标的得分。

JSON 表示法 
{
  "metric": string,
  "score": number
}
字段
metric

string

必需。指标的名称。
score

number

必需。相应指标的计划得分。

AlphaEvolveEvaluationInsights

计划的评估分析洞见。

JSON 表示法 
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
字段
insights[]

object (AlphaEvolveEvaluationInsight)

可选。评估分析洞见的列表。

AlphaEvolveEvaluationInsight

单个评估数据分析。

JSON 表示法 
{
  "label": string,
  "text": string
}
字段
label

string

可选。数据分析的标签。
text

string

可选。数据分析的文本。

ProgramState

实验中计划的状态。

枚举
PROGRAM_STATE_UNSPECIFIED 默认值。此值未使用。
INITIALIZED 程序已初始化。
GENERATING 程序正在生成中。
EVALUATING 该计划尚待评估。
COMPLETED 计划已完成。

方法

create

 创建新 AlphaEvolveProgram。

get

 获取现有 AlphaEvolveProgram。

list

 列出指定实验中符合请求中提供的条件的所有 AlphaEvolveProgram。