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

Resource: AlphaEvolveProgram

Mewakili satu program yang akan digunakan dalam konteks eksperimen AlphaEvolve.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "content": {
    object (AlphaEvolveProgramContent)
  },
  "evaluation": {
    object (AlphaEvolveProgramEvaluation)
  },
  "parentPrograms": [
    string
  ],
  "lockToken": string,
  "state": enum (ProgramState)
}
Kolom
name

string

ID. ID unik untuk program. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

Khusus output. Waktu saat program dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
content

object (AlphaEvolveProgramContent)

Opsional. Konten program.
evaluation

object (AlphaEvolveProgramEvaluation)

Opsional. Hasil evaluasi untuk program.
parentPrograms[]

string

Hanya output. Secara opsional menentukan program induk yang menjadi dasar pengembangan program ini. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
lockToken

string

Opsional. Token kunci untuk program.
state

enum (ProgramState)

Hanya output. status program.

AlphaEvolveProgramContent

Pesan mandiri yang berisi konten program. Dapat merepresentasikan kumpulan file.

Representasi JSON 
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Kolom
description

string

Opsional. Deskripsi program.
files[]

object (AlphaEvolveSourceFile)

Wajib. Daftar file sumber yang membentuk keseluruhan program.

AlphaEvolveSourceFile

Satu file sumber dengan jalur, konten, dan metadatanya.

Representasi JSON 
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Kolom
path

string

Wajib. Jalur relatif file, termasuk nama file. Misalnya, "src/main.py", "utils/helpers.js", "README.md"
content

string

Wajib. Konten mentah file. Ini adalah string, bukan byte, karena pada akhirnya harus diproses oleh LLM sebagai teks.
programLanguage

string

Opsional. Bahasa pemrograman file.
description

string

Opsional. Deskripsi tambahan file.

AlphaEvolveProgramEvaluation

Hasil evaluasi untuk kandidat program.

Representasi JSON 
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Kolom
scores

object (AlphaEvolveEvaluationScores)

Opsional. Berisi skor evaluasi untuk metrik target yang akan dioptimalkan.
insights

object (AlphaEvolveEvaluationInsights)

Opsional. Mewakili berbagai insight tentang kandidat, yang tidak digunakan secara langsung sebagai target pengoptimalan, tetapi dapat digunakan untuk meningkatkan generasi berikutnya, dan dengan demikian dapat digunakan untuk menyusun perintah evolusi.

AlphaEvolveEvaluationScores

Berisi skor evaluasi untuk metrik target yang akan dioptimalkan.

Representasi JSON 
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Kolom
scores[]

object (AlphaEvolveEvaluationScore)

Wajib. Daftar skor evaluasi.

AlphaEvolveEvaluationScore

Skor untuk satu metrik.

Representasi JSON 
{
  "metric": string,
  "score": number
}
Kolom
metric

string

Wajib diisi. Nama metrik.
score

number

Wajib. Skor program untuk metrik ini.

AlphaEvolveEvaluationInsights

Insight evaluasi untuk program.

Representasi JSON 
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Kolom
insights[]

object (AlphaEvolveEvaluationInsight)

Opsional. Daftar insight evaluasi.

AlphaEvolveEvaluationInsight

Insight evaluasi tunggal.

Representasi JSON 
{
  "label": string,
  "text": string
}
Kolom
label

string

Opsional. Label insight.
text

string

Opsional. Teks insight.

ProgramState

status program dalam eksperimen.

Enum
PROGRAM_STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
INITIALIZED Program diinisialisasi.
GENERATING Program sedang dalam proses pembuatan.
EVALUATING Program sedang menunggu evaluasi.
COMPLETED Program selesai.

Metode

create

 Membuat AlphaEvolveProgram baru.

get

 Mendapatkan AlphaEvolveProgram yang ada.

list

 Mencantumkan semua AlphaEvolveProgram dalam eksperimen tertentu yang mengikuti kriteria yang diberikan dalam permintaan.