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)

출력 전용입니다. 프로그램이 생성된 시간입니다.

생성된 출력은 항상 Z-정규화되고 소수점 이하 0, 3, 6 또는 9자리인 RFC 3339를 사용합니다. '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

실험의 프로그램 상태입니다.

열거형
PROGRAM_STATE_UNSPECIFIED 기본값 이 값은 사용되지 않습니다.
INITIALIZED 프로그램이 초기화됩니다.
GENERATING 프로그램이 생성 중입니다.
EVALUATING 프로그램이 평가 대기 중입니다.
COMPLETED 프로그램이 완료되었습니다.

메서드

create

 새 AlphaEvolveProgram를 만듭니다.

get

 기존 AlphaEvolveProgram를 가져옵니다.

list

 요청에 제공된 기준을 따르는 특정 실험의 모든 AlphaEvolveProgram를 나열합니다.