koog-agents-optimization

0.1.0-SNAPSHOT

koog-agents-optimization/ai.koog.agents.optimization.training.metrics.impl/RetryStatsMetric

RetryStatsMetric

@Serializable

@SerialName(value = "retryStats")

data class RetryStatsMetric(val key: MetricKey<RetryStatsMetric> = KEY, val totalRetriesPerformed: Int = 0, val leavesWithRetries: Int = 0, val leavesWithRetriesRatioOfFinished: Ratio = Ratio.ZERO, val leavesResolvedAfterRetries: Int = 0, val leavesResolvedAfterRetriesRatioOfLeavesWithRetries: Ratio = Ratio.ZERO, val avgRetriesPerLeafWithRetries: Double? = null, val completedLeavesByRetryCount: Map<Int, Int> = emptyMap(), val leavesUnresolvedAfterRetries: Int = 0) : Metric

Counts retries performed below this stage and how often they resolve a failure.

Present on every stage. All fields are omitted when at their default, so a retries-free stage serializes to an empty "retryStats": {} object.

Constructors

RetryStatsMetric

constructor(key: MetricKey<RetryStatsMetric> = KEY, totalRetriesPerformed: Int = 0, leavesWithRetries: Int = 0, leavesWithRetriesRatioOfFinished: Ratio = Ratio.ZERO, leavesResolvedAfterRetries: Int = 0, leavesResolvedAfterRetriesRatioOfLeavesWithRetries: Ratio = Ratio.ZERO, avgRetriesPerLeafWithRetries: Double? = null, completedLeavesByRetryCount: Map<Int, Int> = emptyMap(), leavesUnresolvedAfterRetries: Int = 0)

Types

object Companion

Key holder for RetryStatsMetric.

Properties

avgRetriesPerLeafWithRetries

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val avgRetriesPerLeafWithRetries: Double? = null

Mean retries per leaf that retried at least once, or null when none retried.

completedLeavesByRetryCount

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val completedLeavesByRetryCount: Map<Int, Int>

Histogram of finished-Completed leaves keyed by how many retries each needed (0 included).

@Transient

open override val key: MetricKey<RetryStatsMetric>

The key that identifies this metric in a ai.koog.agents.optimization.training.metrics.MetricsMap.

leavesResolvedAfterRetries

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val leavesResolvedAfterRetries: Int = 0

Leaves that retried and ultimately completed successfully.

leavesResolvedAfterRetriesRatioOfLeavesWithRetries

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val leavesResolvedAfterRetriesRatioOfLeavesWithRetries: Ratio

leavesResolvedAfterRetries over leavesWithRetries.

leavesUnresolvedAfterRetries

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val leavesUnresolvedAfterRetries: Int = 0

Leaves that retried at least once and ended Failed.

leavesWithRetries

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val leavesWithRetries: Int = 0

Number of leaves that retried at least once.

leavesWithRetriesRatioOfFinished

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val leavesWithRetriesRatioOfFinished: Ratio

leavesWithRetries over the number of finished leaves.

totalRetriesPerformed

@EncodeDefault(mode = EncodeDefault.Mode.NEVER)

val totalRetriesPerformed: Int = 0

Total retry attempts performed by all leaves below this stage.

Functions

open override fun recompute(currentStage: StageRecord, substages: List<TrainingRecord>, isStageUpdate: Boolean): RetryStatsMetric

Recompute this metric from the full list of substages records.