google-adk-kotlin-core/com.google.adk.kt.apps/App

App

data class App(val appName: String, val rootAgent: BaseAgent, val plugins: List<Plugin> = emptyList(), val resumabilityConfig: ResumabilityConfig? = null, val eventsCompactionConfig: EventsCompactionConfig? = null, val contextCacheConfig: ContextCacheConfig? = null)

Represents an LLM-backed agentic application.

An App is the top-level container for an agentic system powered by LLMs. It bundles an application name together with the rootAgent that serves as the root of the agent tree, enabling coordination and communication across all agents in the hierarchy. It also carries application-wide configuration, such as plugins and resumabilityConfig, that the runner applies to every session it runs.

appName must start with a letter and may contain only letters, digits, underscores, and hyphens, and must not be the reserved value "user", which is reserved for end-user input. Construction throws IllegalArgumentException if appName does not meet these requirements.

Constructors

App

constructor(appName: String, rootAgent: BaseAgent, plugins: List<Plugin> = emptyList(), resumabilityConfig: ResumabilityConfig? = null, eventsCompactionConfig: EventsCompactionConfig? = null, contextCacheConfig: ContextCacheConfig? = null)

Types

Builder

class Builder

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

Companion

object Companion

Properties

appName

val appName: String

The application name.

contextCacheConfig

val contextCacheConfig: ContextCacheConfig?

Optional context cache configuration that applies to all LLM agents in the app. When null, context caching is disabled.

eventsCompactionConfig

val eventsCompactionConfig: EventsCompactionConfig?

Optional configuration controlling context-compaction strategies for sessions of this application. When null, no compaction runs.

plugins

val plugins: List<Plugin>

Application-wide Plugins providing shared callbacks and services to the entire system. Defaults to an empty list.

resumabilityConfig

val resumabilityConfig: ResumabilityConfig?

Optional resumability configuration applied to the application's sessions. When null, resumability is disabled.

rootAgent

val rootAgent: BaseAgent

The root agent of the application's agent tree.