google-adk-kotlin-core/com.google.adk.kt.models/LlmRequest

LlmRequest

data class LlmRequest(val model: Model? = null, val contents: List<Content> = emptyList(), val config: GenerateContentConfig = GenerateContentConfig(), toolsDict: List<BaseTool> = emptyList(), val cacheConfig: ContextCacheConfig? = null, val cacheMetadata: CacheMetadata? = null, val cacheableContentsTokenCount: Int? = null)

LlmRequest represents a request to an LLM.

Constructors

LlmRequest

constructor(model: Model? = null, contents: List<Content> = emptyList(), config: GenerateContentConfig = GenerateContentConfig(), toolsDict: List<BaseTool> = emptyList(), cacheConfig: ContextCacheConfig? = null, cacheMetadata: CacheMetadata? = null, cacheableContentsTokenCount: Int? = null)

Types

Builder

class Builder

Fluent builder for LlmRequest, provided primarily for Java callers. Any property left unset falls back to the same default as the constructor. The internal toolsDict is request-processing state populated by appendTools, not a caller input, so it has no public setter; LlmRequest.toBuilder carries it over.

Companion

object Companion

Properties

cacheableContentsTokenCount

val cacheableContentsTokenCount: Int?

Prompt token count from the previous request, used to gate cache creation on a minimum size.

cacheConfig

val cacheConfig: ContextCacheConfig?

Context cache configuration for this request. When null, context caching is disabled for the request.

cacheMetadata

val cacheMetadata: CacheMetadata?

Cache metadata carried over from previous requests, used to validate and reuse an existing cache.

config

val config: GenerateContentConfig

The configuration for generating content.

contents

val contents: List<Content>

The contents of the request.

model

val model: Model?

The model to use for the request.

Functions

appendContent

fun appendContent(content: Content): LlmRequest

Appends a content block to the request.

appendInstructions

fun appendInstructions(instructions: Content): LlmRequest

Appends instructions to the system instruction.

appendTools

fun appendTools(tools: List<BaseTool>): LlmRequest

Appends tools to the request and merges any new function declarations.

toBuilder

fun toBuilder(): LlmRequest.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.