google-adk-kotlin-core/com.google.adk.kt.agents

Package-level declarations

Types

Interface for agent-specific state classes in ADK.

abstract class BaseAgent(name: String, description: String = "", val subAgents: List<BaseAgent> = emptyList(), val beforeAgentCallbacks: List<BeforeAgentCallback> = emptyList(), val afterAgentCallbacks: List<AfterAgentCallback> = emptyList(), val disallowTransferToParent: Boolean = false, val disallowTransferToPeers: Boolean = false) : BaseNode

Base class for all agents.

CallbackContext

class CallbackContext(invocationContext: InvocationContext, eventActions: EventActions? = null) : Context

Context passed to agent and model callbacks.

Context

open class Context(val invocationContext: InvocationContext, actions: EventActions? = null, val functionCallId: String? = null, val toolConfirmation: ToolConfirmation? = null, val eventId: String? = null) : ReadonlyContext, ReadonlyToolContext

Execution context passed to agent callbacks, model callbacks, tools, and workflow nodes during an invocation.

ContextCacheConfig

data class ContextCacheConfig @ExperimentalContextCachingFeature constructor(val cacheIntervals: Int = 10, val ttl: Duration = 1800.seconds, val minTokens: Int = 0, val createHttpOptions: HttpOptions? = null)

Configuration for context caching across all agents in an app.

ContextFrameworkData

data class ContextFrameworkData(val callbackContextData: MutableMap<String, Any> = concurrentMutableMapOf())

Framework-internal per-invocation data holder. Groups scratch state used by ADK's own machinery and the ADK Java interop so it stays off InvocationContext's public constructor. The type itself needs no opt-in; its members are marked FrameworkInternalApi.

Instruction

sealed interface Instruction

A unit of instruction provided to an LlmAgent.

InvocationContext

data class InvocationContext(val session: Session, val runConfig: RunConfig? = null, val agent: BaseAgent, val branch: String? = null, val invocationId: String = "e-" + Uuid.random(), val artifactService: ArtifactService? = null, val memoryService: MemoryService? = null, val sessionService: SessionService? = null, val resumabilityConfig: ResumabilityConfig? = null, val eventsCompactionConfig: EventsCompactionConfig? = null, val contextCacheConfig: ContextCacheConfig? = null, val userContent: Content? = null, val agentStates: MutableMap<String, TypedData> = concurrentMutableMapOf(), val endOfAgents: MutableMap<String, Boolean> = concurrentMutableMapOf(), val extraTools: MutableMap<String, BaseTool> = concurrentMutableMapOf(), val frameworkData: ContextFrameworkData = ContextFrameworkData(), var isEndOfInvocation: Boolean = false, val pluginManager: PluginManager = PluginManager(), invocationCostManager: InvocationCostManager = InvocationCostManager(), val node: Node? = null)

An invocation context represents the data of a single invocation of an agent.

InvocationCostManager

class InvocationCostManager

Per-invocation LLM-call counter for enforcing RunConfig.maxLlmCalls. The type is public only because it is an InvocationContext constructor-property type; its constructor and members are non-public.

LlmAgent

class LlmAgent(name: String, val model: Model, description: String = "", subAgents: List<BaseAgent> = emptyList(), beforeAgentCallbacks: List<BeforeAgentCallback> = emptyList(), afterAgentCallbacks: List<AfterAgentCallback> = emptyList(), disallowTransferToParent: Boolean = false, disallowTransferToPeers: Boolean = false, val tools: List<BaseTool> = emptyList(), val toolsets: List<Toolset> = emptyList(), val generateContentConfig: GenerateContentConfig? = null, val instruction: Instruction? = null, val staticInstruction: Content? = null, val beforeModelCallbacks: List<BeforeModelCallback> = emptyList(), val afterModelCallbacks: List<AfterModelCallback> = emptyList(), val beforeToolCallbacks: List<BeforeToolCallback> = emptyList(), val afterToolCallbacks: List<AfterToolCallback> = emptyList(), val inputSchema: Schema? = null, val outputSchema: Schema? = null, val outputKey: String? = null, val onModelErrorCallbacks: List<OnModelErrorCallback> = emptyList(), val onToolErrorCallbacks: List<OnToolErrorCallback> = emptyList(), val includeContents: LlmAgent.IncludeContents = IncludeContents.DEFAULT, val maxSteps: Int? = null) : BaseAgent

LLM-based Agent.

LlmCallsLimitExceededException

class LlmCallsLimitExceededException(message: String) : Exception

Thrown when an invocation exceeds RunConfig.maxLlmCalls.

LoopAgent

class LoopAgent(name: String, val maxIterations: Int? = null, description: String = "", subAgents: List<BaseAgent> = emptyList(), beforeAgentCallbacks: List<BeforeAgentCallback> = emptyList(), afterAgentCallbacks: List<AfterAgentCallback> = emptyList()) : BaseAgent

A shell agent that runs its sub-agents in a loop.

LoopAgentState

data class LoopAgentState(val currentSubAgent: String, val timesLooped: Int) : AgentState

Persistent state of a LoopAgent.

ParallelAgent

class ParallelAgent(name: String, description: String = "", subAgents: List<BaseAgent> = emptyList(), beforeAgentCallbacks: List<BeforeAgentCallback> = emptyList(), afterAgentCallbacks: List<AfterAgentCallback> = emptyList()) : BaseAgent

A shell agent that runs its sub-agents in parallel in an isolated manner.

ReadonlyContext

interface ReadonlyContext

A readonly view of the invocation context.

ResumabilityConfig

data class ResumabilityConfig(val isResumable: Boolean = false)

Configuration for resumability in ADK.

RunConfig

data class RunConfig(val streamingMode: StreamingMode = StreamingMode.NONE, val maxLlmCalls: Int = 500, val customMetadata: Map<String, Any>? = null)

Configs for runtime behavior of agents.

SequentialAgent

class SequentialAgent(name: String, description: String = "", subAgents: List<BaseAgent> = emptyList(), beforeAgentCallbacks: List<BeforeAgentCallback> = emptyList(), afterAgentCallbacks: List<AfterAgentCallback> = emptyList()) : BaseAgent

A shell agent that runs its sub-agents in sequence.

SequentialAgentState

data class SequentialAgentState(val currentSubAgent: String) : AgentState

Persistent state of a SequentialAgent.

StreamingMode

enum StreamingMode : Enum<StreamingMode>

Streaming modes for agent execution.

TypedData

@Serializable

sealed class TypedData

A type-safe hierarchy for agent state variables, ensuring primitives don't collapse.

Functions

findAgent

fun BaseAgent.findAgent(targetName: String): BaseAgent?

Finds an agent with the given name in this agent's subtree (including itself).