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

ID。計畫的專屬 ID。格式：projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

僅供輸出。節目建立時間。

使用 RFC 3339，產生的輸出內容一律會經過 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。