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

リソース: AlphaEvolveExperiment

テストは、AlphaEvolve エージェントの 1 回の実行です。これは、アルゴリズムの検出と最適化のために LLM を活用した進化型コーディング エージェントです。

JSON 表現 
{
  "name": string,
  "createTime": string,
  "config": {
    object (AlphaEvolveExperimentConfig)
  },
  "stats": {
    object (AlphaEvolveExperimentStats)
  },
  "state": enum (State),
  "initialAlphaEvolveProgram": string
}
フィールド
name

string

ID。実験の完全なリソース名。形式: projects/{project}/locations/{location}/collections/{collection}/engines/{engine}/sessions/{session}/alphaEvolveExperiments/{alphaEvolveExperiment}
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"。
config

object (AlphaEvolveExperimentConfig)

必須。テストの設定。
stats

object (AlphaEvolveExperimentStats)

出力専用。テストの統計情報。
state

enum (State)

出力専用。テストの状態。
initialAlphaEvolveProgram

string

出力専用。テストの開始に使用されるシード プログラムの名前を指定します。

AlphaEvolveExperimentConfig

実験の設定。

JSON 表現 
{
  "title": string,
  "problemDescription": string,
  "programLanguage": string,
  "runSettings": {
    object (RunSettings)
  },
  "generationSettings": {
    object (GenerationSettings)
  },
  "evolutionSettings": {
    object (EvolutionSettings)
  }
}
フィールド
title

string

必須。テストのタイトル。
problemDescription

string

必須。試験で解決する問題の説明。
programLanguage

string

必須。最適化するコードの主要なプログラミング言語。
runSettings

object (RunSettings)

必須。テストの実行設定。テスト実行の全体的な動作を制御します。
generationSettings

object (GenerationSettings)

省略可。テストの生成設定。LLM パラメータやユーザーが提供したコンテキストとプロンプトなど、新しいプログラム候補の生成方法を制御します。
evolutionSettings

object (EvolutionSettings)

省略可。テストの進化設定。

RunSettings

テストの実行設定。

JSON 表現 
{
  "maxPrograms": integer,
  "concurrency": integer,
  "maxDuration": string
}
フィールド
maxPrograms

integer

必須。テスト実行中に生成するプログラムの最大数。初期プログラムはこの上限にカウントされます。1 より大きくする必要があります。
concurrency

integer

必須。並行して生成できるプログラムの最大数。正の値である必要があります。
maxDuration

string (Duration format)

省略可。テストの最大期間。設定しなかった場合、デフォルトは 24 時間です。

s で終わる小数 9 桁までの秒単位の期間。例: "3.5s"。

GenerationSettings

テストの生成設定。

JSON 表現 
{
  "context": string,
  "includeFullProgramInPrompt": boolean,
  "models": [
    {
      object (ModelConfig)
    }
  ]
}
フィールド
context

string

省略可。生成時に使用されるユーザー提供の追加コンテキスト。
includeFullProgramInPrompt

boolean

省略可。true の場合、LLM プロンプトにはプログラム テキスト全体（変更可能な EVOLVE-BLOCK リージョンと変更不可能なボイラープレートの両方）が含まれます。false（デフォルト）の場合、変更可能な EVOLVE-BLOCK リージョンのみが表示され、コンテキスト ウィンドウが保存されます。
models[]

object (ModelConfig)

省略可。モデルごとの構成。詳しくは、ModelConfig をご覧ください。設定しない場合、サーバーはデフォルトのモデルを選択します。

ModelConfig

モデルごとの構成。modelMixture、model とは相互に排他的です。models が設定されている場合、modelMixture と model の両方を設定解除する必要があります。

modelMixture と同じ許可モデルのリストと最大 2 つのモデルのルールが適用されます。また、各エントリで、LLM サンプリングのモデルごとの temperature を指定できます。modelMixture とは異なり、ここでの重みは相対的です。比率のみが重要です（サーバーが正規化します）。そのため、呼び出し元は、合計が 1.0 になることを確認する必要なく、任意の正の数を使用できます。

JSON 表現 
{
  "name": string,
  "thinkingLevel": enum (ThinkingLevel),
  "weight": number
}
フィールド
name

string

必須。モデル名（gemini-2.5-flash、gemini-3.1-pro-preview など）。使用できるモデルのリストについては、modelMixture をご覧ください。
thinkingLevel

enum (ThinkingLevel)

省略可。頂点ThinkingConfig.thinking_levelとして送信されました。
weight

number

省略可。混合におけるこのモデルの相対重み。有限の正の値である必要があります。すべてのエントリの重みはサーバーサイドで正規化されるため、合計が 1.0 になる必要はありません。設定されていない場合、デフォルトは 1.0 です。これは、単一のモデルまたは均等な混合を構成する場合に便利です。

一部の Pro ティアモデルでは、合計重みの最大 50% に上限が設定されています。この上限を超えるリクエストは INVALID_ARGUMENT で拒否されます。

ThinkingLevel

モデルがどれだけ思考すべきかを、トークン予算ではなくポータブル レベルとして指定します。レベルには Gemini 3 モデルが必要です。Gemini 2.5 以前のモデルでは、トークンで思考予算を計算し、レベルを完全に拒否します。

特定のモデルが受け入れるレベルと、このレベルが設定されていない場合に使用するレベルは、モデルごとに異なり、ここでは説明しません。モデルとともにドキュメント化されています。

列挙型
THINKING_LEVEL_UNSPECIFIED 設定解除。モデルは独自のデフォルトを適用します。これは、すべてのモデルで同じレベルではありません。
MINIMAL 考える必要が少ない。すべてのモデルで提供されているわけではありません。
LOW Vertex LOW。
MEDIUM Vertex MEDIUM。
HIGH Vertex HIGH。

EvolutionSettings

テストの進化設定。

JSON 表現 
{
  "parentSamplingConfig": {
    object (ParentSamplingConfig)
  }
}
フィールド
parentSamplingConfig

object (ParentSamplingConfig)

省略可。親サンプリング構成。

ParentSamplingConfig

親サンプリングの構成。

JSON 表現 
{
  "paretoSamplingConfig": {
    object (ParetoSamplingConfig)
  }
}
フィールド
paretoSamplingConfig

object (ParetoSamplingConfig)

省略可。パレート サンプリングの構成。

ParetoSamplingConfig

パレート サンプリングの構成。

JSON 表現 
{
  "paretoSamplingProbability": number
}
フィールド
paretoSamplingProbability

number

省略可。候補の生成時に、通常の適合度ベースのサンプリングではなく、パレート フロンティアから親プログラムをサンプリングする確率 [0.0, 1.0]。複数の指標を同時に最適化する場合に役立ちます。デフォルトは 0.0（無効）です。複数の指標が scores_to_optimize に返される場合にのみ有効です。

AlphaEvolveExperimentStats

テストに関する統計情報。

JSON 表現 
{
  "candidatesCount": integer,
  "evaluatedCandidatesCount": integer,
  "inputTokenCount": string,
  "outputTokenCount": string
}
フィールド
candidatesCount

integer

出力専用。生成された候補者の数。
evaluatedCandidatesCount

integer

出力専用。評価された候補の数。
inputTokenCount

string (int64 format)

出力専用。実験で消費された課金対象入力トークンの数。
outputTokenCount

string (int64 format)

出力専用。テストで使用された課金対象の出力トークンの数。

状態

テストの状態値。

列挙型
STATE_UNSPECIFIED デフォルト値。この値は使用されません。
CREATED テストが作成されます。
RUNNING テストを実施中です。
PAUSED テストが一時停止されています。
COMPLETED テストが完了しました。
FAILED テストが失敗しました。

メソッド

acquirePrograms

 評価のために、生成されたプログラムのキューから 1 つ以上の AlphaEvolveProgram を取得します。

create

 新しい AlphaEvolveExperiment を作成します。

delete

 テストが終了状態（

get

 既存の AlphaEvolveExperiment を取得します。

list

 指定されたセッション内のすべての AlphaEvolveExperiment を一覧表示します。

resume

 ワークフローを再開して AlphaEvolveExperiment を処理します。

start

 AlphaEvolveExperiment を処理するワークフローを開始します。

submitProgramsEvaluations

 テストに AlphaEvolveProgramEvaluation を追加します。