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

מזהה. מזהה ייחודי של התוכנית. פורמט: 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

המצב של תוכנית בניסוי.

טיפוסים בני מנייה (enum)
PROGRAM_STATE_UNSPECIFIED ערך ברירת המחדל. הערך הזה לא בשימוש.
INITIALIZED התוכנית מאותחלת.
GENERATING התוכנית נמצאת בתהליך יצירה.
EVALUATING התוכנית בהמתנה להערכה.
COMPLETED התוכנית הושלמה.

Methods

create

 יוצרת AlphaEvolveProgram חדש.

get

 הפונקציה מחזירה AlphaEvolveProgram קיים.

list

 רשימה של כל ה-AlphaEvolveProgram בניסוי נתון שעומדים בקריטריונים שצוינו בבקשה.