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

Risorsa: AlphaEvolveProgram

Rappresenta un singolo programma da utilizzare nel contesto di un esperimento AlphaEvolve.

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

string

Identificatore. Identificatore univoco del programma. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

Solo output. Ora in cui è stato creato il programma.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
content

object (AlphaEvolveProgramContent)

Facoltativo. Contenuti del programma.
evaluation

object (AlphaEvolveProgramEvaluation)

Facoltativo. Risultati della valutazione del programma.
parentPrograms[]

string

Solo output. Specifica facoltativamente da quali programmi principali si è evoluto questo programma. Formato: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
lockToken

string

Facoltativo. Token di blocco per il programma.
state

enum (ProgramState)

Solo output. Stato del programma.

AlphaEvolveProgramContent

Un messaggio autonomo contenente i contenuti di un programma. Può rappresentare una raccolta di file.

Rappresentazione JSON 
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Campi
description

string

(Facoltativo) Descrizione del programma.
files[]

object (AlphaEvolveSourceFile)

Obbligatorio. Un elenco dei file di origine che compongono il programma complessivo.

AlphaEvolveSourceFile

Un unico file di origine con il relativo percorso, contenuti e metadati.

Rappresentazione JSON 
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Campi
path

string

Obbligatorio. Il percorso relativo del file, incluso il nome file. Ad es. "src/main.py", "utils/helpers.js", "README.md"
content

string

Obbligatorio. I contenuti non elaborati del file. Si tratta di una stringa e non di byte, perché alla fine deve essere elaborata dal modello LLM come testo.
programLanguage

string

Facoltativo. Il linguaggio di programmazione del file.
description

string

Facoltativo. Descrizione aggiuntiva del file.

AlphaEvolveProgramEvaluation

Risultati della valutazione per un candidato al programma.

Rappresentazione JSON 
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Campi
scores

object (AlphaEvolveEvaluationScores)

Facoltativo. Contiene i punteggi di valutazione per le metriche target da ottimizzare.
insights

object (AlphaEvolveEvaluationInsights)

Facoltativo. Rappresenta varie informazioni sul candidato, che non vengono utilizzate direttamente come target di ottimizzazione, ma che possono essere utilizzate per migliorare le generazioni successive e, pertanto, possono essere utilizzate per costruire il prompt di evoluzione.

AlphaEvolveEvaluationScores

Contiene i punteggi di valutazione per le metriche target da ottimizzare.

Rappresentazione JSON 
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Campi
scores[]

object (AlphaEvolveEvaluationScore)

Obbligatorio. Elenco dei punteggi di valutazione.

AlphaEvolveEvaluationScore

Punteggio per una singola metrica.

Rappresentazione JSON 
{
  "metric": string,
  "score": number
}
Campi
metric

string

Obbligatorio. Il nome della metrica.
score

number

Obbligatorio. Punteggio di un programma per questa metrica.

AlphaEvolveEvaluationInsights

Insight sulla valutazione di un programma.

Rappresentazione JSON 
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Campi
insights[]

object (AlphaEvolveEvaluationInsight)

Facoltativo. Elenco degli insight sulla valutazione.

AlphaEvolveEvaluationInsight

Un singolo insight di valutazione.

Rappresentazione JSON 
{
  "label": string,
  "text": string
}
Campi
label

string

(Facoltativo) Etichetta dell'approfondimento.
text

string

Facoltativo. Il testo dell'insight.

ProgramState

stato di un programma in un esperimento.

Enum
PROGRAM_STATE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
INITIALIZED Il programma è inizializzato.
GENERATING Il programma è in fase di generazione.
EVALUATING Il programma è in attesa di valutazione.
COMPLETED Il programma è stato completato.

Metodi

create

 Crea un nuovo AlphaEvolveProgram.

get

 Recupera un AlphaEvolveProgram esistente.

list

 Elenca tutti i AlphaEvolveProgram in un determinato esperimento che soddisfano i criteri forniti nella richiesta.