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

Resource: AlphaEvolveExperiment

Eksperimen adalah satu kali menjalankan agen AlphaEvolve, agen coding evolusioner yang didukung oleh LLM untuk penemuan dan pengoptimalan algoritma.

Representasi JSON 
{
  "name": string,
  "createTime": string,
  "config": {
    object (AlphaEvolveExperimentConfig)
  },
  "stats": {
    object (AlphaEvolveExperimentStats)
  },
  "state": enum (State),
  "initialAlphaEvolveProgram": string
}
Kolom
name

string

ID. Nama lengkap resource eksperimen. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}
createTime

string (Timestamp format)

Hanya output. Waktu saat eksperimen 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".
config

object (AlphaEvolveExperimentConfig)

Wajib. Konfigurasi eksperimen.
stats

object (AlphaEvolveExperimentStats)

Hanya output. Statistik eksperimen.
state

enum (State)

Hanya output. Status eksperimen.
initialAlphaEvolveProgram

string

Hanya output. Menentukan nama program awal yang digunakan untuk memulai eksperimen.

AlphaEvolveExperimentConfig

Konfigurasi eksperimen.

Representasi JSON 
{
  "title": string,
  "problemDescription": string,
  "programLanguage": string,
  "runSettings": {
    object (RunSettings)
  },
  "generationSettings": {
    object (GenerationSettings)
  },
  "evolutionSettings": {
    object (EvolutionSettings)
  }
}
Kolom
title

string

Wajib diisi. Judul eksperimen.
problemDescription

string

Wajib diisi. Deskripsi masalah yang akan diselesaikan oleh eksperimen.
programLanguage

string

Wajib. Bahasa pemrograman utama kode yang dioptimalkan.
runSettings

object (RunSettings)

Wajib. Setelan operasi untuk eksperimen, yang mengontrol keseluruhan perilaku operasi eksperimen.
generationSettings

object (GenerationSettings)

Opsional. Setelan pembuatan untuk eksperimen, yang mengontrol cara kandidat program baru dibuat, termasuk parameter LLM dan konteks serta perintah yang disediakan pengguna.
evolutionSettings

object (EvolutionSettings)

Opsional. Setelan evolusi untuk eksperimen.

RunSettings

Setelan jalankan untuk eksperimen.

Representasi JSON 
{
  "maxPrograms": integer,
  "concurrency": integer,
  "maxDuration": string
}
Kolom
maxPrograms

integer

Wajib. Jumlah maksimum program yang akan dibuat selama menjalankan eksperimen. Program awal dihitung dalam batas ini. Harus lebih besar dari 1.
concurrency

integer

Wajib. Jumlah maksimum program yang dapat dibuat secara paralel. Harus positif.
maxDuration

string (Duration format)

Opsional. Durasi maksimum eksperimen. Jika tidak disetel, defaultnya adalah 24 jam.

Durasi dalam detik dengan maksimal sembilan digit pecahan, yang diakhiri dengan 's'. Contoh: "3.5s".

GenerationSettings

Setelan pembuatan untuk eksperimen.

Representasi JSON 
{
  "context": string,
  "includeFullProgramInPrompt": boolean,
  "models": [
    {
      object (ModelConfig)
    }
  ]
}
Kolom
context

string

Opsional. Konteks tambahan yang disediakan pengguna untuk digunakan selama pembuatan.
includeFullProgramInPrompt

boolean

Opsional. Jika benar (true), perintah LLM menyertakan teks program lengkap (baik wilayah EVOLVE-BLOCK yang dapat diubah maupun boilerplate yang tidak dapat diubah). Jika salah (default), hanya wilayah EVOLVE-BLOCK yang dapat diubah yang ditampilkan, sehingga menghemat jendela konteks.
models[]

object (ModelConfig)

Opsional. Konfigurasi per model. Lihat ModelConfig untuk mengetahui detailnya. Jika tidak disetel, server akan memilih model default.

ModelConfig

Konfigurasi per model. Tidak dapat muncul bersamaan dengan modelMixture dan model: saat models disetel, modelMixture dan model tidak boleh disetel.

Daftar model yang diizinkan dan aturan maksimal 2 model yang sama seperti untuk modelMixture berlaku. Selain itu, setiap entri dapat menentukan temperature per model untuk pengambilan sampel LLM. Tidak seperti modelMixture, bobot di sini bersifat relatif: hanya rasio yang penting (server menormalisasinya), sehingga pemanggil dapat menggunakan angka positif apa pun tanpa harus memastikan jumlahnya 1,0.

Representasi JSON 
{
  "name": string,
  "thinkingLevel": enum (ThinkingLevel),
  "weight": number
}
Kolom
name

string

Wajib. Nama model (misalnya, gemini-2.5-flash, gemini-3.1-pro-preview). Lihat modelMixture untuk mengetahui daftar model yang diizinkan.
thinkingLevel

enum (ThinkingLevel)

Opsional. Dikirim sebagai Vertex ThinkingConfig.thinking_level.
weight

number

Opsional. Bobot relatif untuk model ini dalam campuran. Harus berupa nilai positif terbatas. Bobot di semua entri dinormalisasi di sisi server, sehingga tidak perlu berjumlah 1,0. Nilai defaultnya adalah 1.0 jika tidak ditetapkan, yang berguna saat mengonfigurasi satu model atau campuran yang seimbang.

Beberapa model tingkat Pro dibatasi hingga maksimal 50% dari total bobot; permintaan yang melanggar batas tersebut akan ditolak dengan INVALID_ARGUMENT.

ThinkingLevel

Seberapa keras model harus berpikir, sebagai tingkat portabel, bukan anggaran token. Tingkat memerlukan model Gemini 3: Gemini 2.5 dan model penalaran dengan anggaran token yang lebih lama akan menolak tingkat secara langsung.

Tingkat yang diterima oleh model tertentu, dan tingkat yang digunakan saat tidak disetel, adalah per model dan didokumentasikan dengan model, bukan di sini.

Enum
THINKING_LEVEL_UNSPECIFIED Tidak disetel. Model menerapkan defaultnya sendiri, yang tidak sama untuk setiap model.
MINIMAL Paling sedikit berpikir. Tidak ditawarkan oleh setiap model.
LOW Vertex LOW.
MEDIUM Vertex MEDIUM.
HIGH Vertex HIGH.

EvolutionSettings

Setelan evolusi untuk eksperimen.

Representasi JSON 
{
  "parentSamplingConfig": {
    object (ParentSamplingConfig)
  }
}
Kolom
parentSamplingConfig

object (ParentSamplingConfig)

Opsional. Konfigurasi pengambilan sampel induk.

ParentSamplingConfig

Konfigurasi untuk pengambilan sampel induk.

Representasi JSON 
{
  "paretoSamplingConfig": {
    object (ParetoSamplingConfig)
  }
}
Kolom
paretoSamplingConfig

object (ParetoSamplingConfig)

Opsional. Konfigurasi pengambilan sampel Pareto.

ParetoSamplingConfig

Konfigurasi untuk pengambilan sampel Pareto.

Representasi JSON 
{
  "paretoSamplingProbability": number
}
Kolom
paretoSamplingProbability

number

Opsional. Probabilitas [0.0, 1.0] pengambilan sampel program induk dari batas Pareto, bukan pengambilan sampel berbasis kebugaran normal selama pembuatan kandidat. Berguna saat mengoptimalkan beberapa metrik secara bersamaan. Default 0.0 (dinonaktifkan). Hanya efektif jika evaluasi menampilkan beberapa metrik dalam scores_to_optimize.

AlphaEvolveExperimentStats

Statistik tentang eksperimen.

Representasi JSON 
{
  "candidatesCount": integer,
  "evaluatedCandidatesCount": integer,
  "inputTokenCount": string,
  "outputTokenCount": string
}
Kolom
candidatesCount

integer

Hanya output. Jumlah kandidat yang dihasilkan.
evaluatedCandidatesCount

integer

Hanya output. Jumlah kandidat yang dievaluasi.
inputTokenCount

string (int64 format)

Hanya output. Jumlah token input yang ditagih yang digunakan oleh eksperimen.
outputTokenCount

string (int64 format)

Hanya output. Jumlah token output yang ditagih yang digunakan oleh eksperimen.

Negara Bagian

nilai status eksperimen.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
CREATED Eksperimen dibuat.
RUNNING Eksperimen sedang berjalan.
PAUSED Eksperimen dijeda.
COMPLETED Eksperimen selesai.
FAILED Eksperimen gagal.

Metode

acquirePrograms

 Mendapatkan satu atau beberapa AlphaEvolveProgram dari antrean program yang dihasilkan untuk evaluasi.

create

 Membuat AlphaEvolveExperiment baru.

delete

 Menghapus eksperimen jika eksperimen berada dalam status akhir (mis.

get

 Dapatkan AlphaEvolveExperiment yang ada.

list

 Mencantumkan semua AlphaEvolveExperiment dalam sesi tertentu.

resume

 Melanjutkan alur kerja untuk memproses AlphaEvolveExperiment.

start

 Memulai alur kerja untuk memproses AlphaEvolveExperiment.

submitProgramsEvaluations

 Menambahkan AlphaEvolveProgramEvaluation ke eksperimen.