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

Ressource: AlphaEvolveProgram

Stellt ein einzelnes Programm dar, das im Rahmen eines AlphaEvolve-Tests verwendet werden soll.

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

string

ID. Eindeutige Kennung für das Programm. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
createTime

string (Timestamp format)

Nur Ausgabe. Der Zeitpunkt, zu dem das Programm erstellt wurde.

Verwendet RFC 3339, wobei die generierte Ausgabe immer Z-normalisiert ist und 0, 3, 6 oder 9 Nachkommastellen verwendet. Andere Offsets als „Z“ werden ebenfalls akzeptiert. Beispiele: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" oder "2014-10-02T15:01:23+05:30".
content

object (AlphaEvolveProgramContent)

Optional. Inhalt des Programms.
evaluation

object (AlphaEvolveProgramEvaluation)

Optional. Bewertungsergebnisse für das Programm.
parentPrograms[]

string

Nur Ausgabe. Gibt optional an, aus welchen übergeordneten Programmen dieses Programm hervorgegangen ist. Format: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}/alphaEvolvePrograms/{alphaEvolveProgram}
lockToken

string

Optional. Sperren Sie das Token für das Programm.
state

enum (ProgramState)

Nur Ausgabe. Status des Programms.

AlphaEvolveProgramContent

Eine in sich geschlossene Nachricht mit dem Inhalt eines Programms. Kann eine Sammlung von Dateien darstellen.

JSON-Darstellung 
{
  "description": string,
  "files": [
    {
      object (AlphaEvolveSourceFile)
    }
  ]
}
Felder
description

string

Optional. Beschreibung des Programms.
files[]

object (AlphaEvolveSourceFile)

Erforderlich. Eine Liste der Quelldateien, aus denen das Gesamtprogramm besteht.

AlphaEvolveSourceFile

Eine einzelne Quelldatei mit ihrem Pfad, Inhalt und Metadaten.

JSON-Darstellung 
{
  "path": string,
  "content": string,
  "programLanguage": string,
  "description": string
}
Felder
path

string

Erforderlich. Der relative Pfad der Datei, einschließlich des Dateinamens, z. B. „src/main.py“, „utils/helpers.js“, „README.md“
content

string

Erforderlich. Der Rohinhalt der Datei. Dies ist ein String und keine Bytes, da er letztendlich vom LLM als Text verarbeitet werden soll.
programLanguage

string

Optional. Die Programmiersprache der Datei.
description

string

Optional. Zusätzliche Beschreibung der Datei.

AlphaEvolveProgramEvaluation

Bewertungsergebnisse für einen Programmkandidaten.

JSON-Darstellung 
{
  "scores": {
    object (AlphaEvolveEvaluationScores)
  },
  "insights": {
    object (AlphaEvolveEvaluationInsights)
  }
}
Felder
scores

object (AlphaEvolveEvaluationScores)

Optional. Enthält die Bewertungsfaktoren für die zu optimierenden Zielmesswerte.
insights

object (AlphaEvolveEvaluationInsights)

Optional. Stellt verschiedene Informationen zum Kandidaten dar, die nicht direkt als Optimierungsziel verwendet werden, aber zur Verbesserung nachfolgender Generationen genutzt werden können. Daher können sie auch zum Erstellen des Evolutionsprompts verwendet werden.

AlphaEvolveEvaluationScores

Enthält die Bewertungsfaktoren für die zu optimierenden Zielmesswerte.

JSON-Darstellung 
{
  "scores": [
    {
      object (AlphaEvolveEvaluationScore)
    }
  ]
}
Felder
scores[]

object (AlphaEvolveEvaluationScore)

Erforderlich. Liste der Bewertungs-Scores.

AlphaEvolveEvaluationScore

Ergebnis für einen einzelnen Messwert.

JSON-Darstellung 
{
  "metric": string,
  "score": number
}
Felder
metric

string

Erforderlich. Name des Messwerts.
score

number

Erforderlich. Punktzahl eines Programms für diesen Messwert.

AlphaEvolveEvaluationInsights

Bewertungs-Insights für ein Programm.

JSON-Darstellung 
{
  "insights": [
    {
      object (AlphaEvolveEvaluationInsight)
    }
  ]
}
Felder
insights[]

object (AlphaEvolveEvaluationInsight)

Optional. Liste der Bewertungs-Insights.

AlphaEvolveEvaluationInsight

Eine einzelne Statistik zur Auswertung.

JSON-Darstellung 
{
  "label": string,
  "text": string
}
Felder
label

string

Optional. Label des Insights.
text

string

Optional. Der Text der Statistik.

ProgramState

Status eines Programms in einem Test.

Enums
PROGRAM_STATE_UNSPECIFIED Standardwert. Dieser Wert wird nicht verwendet.
INITIALIZED Das Programm wird initialisiert.
GENERATING Das Programm wird generiert.
EVALUATING Die Bewertung des Programms steht noch aus.
COMPLETED Das Programm ist abgeschlossen.

Methoden

create

 Erstellt einen neuen AlphaEvolveProgram

get

 Ruft ein vorhandenes AlphaEvolveProgram ab.

list

 Listet alle AlphaEvolveProgram in einem bestimmten Test auf, die den in der Anfrage angegebenen Kriterien entsprechen.