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

CallbackContext

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

The context provided to agents and tools during a callback, such as when a tool is run.

It provides access to the current invocation context, event actions, and state.

Constructors

CallbackContext

constructor(invocationContext: InvocationContext, eventActions: EventActions? = null)

Properties

val agent: BaseAgent

open override val agentName: String

The name of the agent that is being invoked.

artifactService

open override val artifactService: ArtifactService?

The ArtifactService instance.

open override val branch: String?

The branch of the invocation context.

var eventActions: EventActions

open override val invocationId: String

The unique ID of this invocation.

open override val memoryService: MemoryService?

The MemoryService instance.

open override val runConfig: RunConfig?

The run configuration for this invocation.

open override val session: Session

The session that this invocation is a part of.

open override val state: Map<String, Any>

The state of the session.

open override val userContent: Content?

The user content that this invocation is processing.

open override val userId: String

The user ID of the user that initiated the session.

Functions

addSessionToMemory

suspend fun addSessionToMemory()

Triggers memory generation for the current session.

fun endInvocation()

Requests the current LLM agent to stop after the current step completes.

open suspend override fun getEvents(currentInvocation: Boolean, currentBranch: Boolean): List<Event>

Returns the events from the current session.

suspend fun listArtifacts(): List<String>

Lists the artifact names visible to this invocation. Returns an empty list if no artifact service is configured.

suspend fun loadArtifact(name: String, version: Int? = null): Part?

Loads an artifact by name from the invocation's com.google.adk.kt.artifacts.ArtifactService. Returns null if no artifact service is configured or the artifact is not found.

mergeEventActions

fun mergeEventActions(actions: EventActions)

Merges the given event actions into the current event actions.

suspend fun saveArtifact(name: String, artifact: Part): Int

Saves artifact under name on the invocation's com.google.adk.kt.artifacts.ArtifactService, records the new version into eventActions' artifactDelta, and returns the version.

fun updateState(key: String, value: Any)

Updates the state delta in the event actions.