google-adk-kotlin-core/com.google.adk.kt.workflow/RetryConfig

RetryConfig

data class RetryConfig(val maxAttempts: Int = DEFAULT_MAX_ATTEMPTS, val initialDelay: Duration = DEFAULT_INITIAL_DELAY, val maxDelay: Duration = DEFAULT_MAX_DELAY, val backoffFactor: Double = DEFAULT_BACKOFF_FACTOR, val jitter: Double = DEFAULT_JITTER, val exceptions: List<String>? = null)

How a node is retried when it raises.

Constructors

RetryConfig

constructor(maxAttempts: Int = DEFAULT_MAX_ATTEMPTS, initialDelay: Duration = DEFAULT_INITIAL_DELAY, maxDelay: Duration = DEFAULT_MAX_DELAY, backoffFactor: Double = DEFAULT_BACKOFF_FACTOR, jitter: Double = DEFAULT_JITTER, exceptions: List<String>? = null)

Types

Builder

class Builder

Fluent builder for RetryConfig, provided primarily for Java callers. Any property left unset falls back to the same default as the constructor.

Companion

object Companion

Properties

backoffFactor

val backoffFactor: Double

Multiplier applied to the delay after each attempt.

exceptions

val exceptions: List<String>?

Reported type names to retry on, matched exactly with no subclass match. The reported name is the failure's own simple name, or for a NodeExecutionException the wrapped failure's type name -- so list e.g. "RuntimeError", not "NodeExecutionException". Null retries any failure; an empty list retries none.

initialDelay

val initialDelay: Duration

Delay before the first retry.

jitter

val jitter: Double

Randomness factor, not a duration: the delay is spread over delay * (1 +/- jitter). Zero removes randomness.

maxAttempts

val maxAttempts: Int

Attempts including the first, so 0 or 1 means no retry.

maxDelay

val maxDelay: Duration

Ceiling on any single delay.

Functions

initialDelayMillis

fun initialDelayMillis(): Long

Returns initialDelay in whole milliseconds. Java cannot read it (mangled).

maxDelayMillis

fun maxDelayMillis(): Long

Returns maxDelay in whole milliseconds. Java cannot read it (mangled).

toBuilder

fun toBuilder(): RetryConfig.Builder

Returns a Builder initialized with this instance's properties, primarily for Java callers. Prefer it over copy from Java: copy takes every property positionally, so its signature changes whenever a property is added.