Skip to content

Document createHttpOptions on the Kotlin context cache config #2115

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
happyhuman merged 4 commits into from
Aug 17, 2026
Merged

Document createHttpOptions on the Kotlin context cache config #2115

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
08627c1
Document createHttpOptions on the Kotlin context cache config
happyhuman Aug 11, 2026
8b64a08
docs: add create_http_options parameter documentation for cache confi…
happyhuman Aug 14, 2026
fcf41ac
Merge branch 'main' into docs-kotlin-cache-http-options
happyhuman Aug 14, 2026
9cd95da
Merge branch 'main' into docs-kotlin-cache-http-options
happyhuman Aug 17, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions docs/context/caching.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -72,7 +72,9 @@ these settings, as shown in the following code sample:
import com.google.adk.kt.annotations.ExperimentalContextCachingFeature
import com.google.adk.kt.apps.App
import com.google.adk.kt.models.Gemini
import com.google.adk.kt.types.HttpOptions
import kotlin.time.Duration.Companion.minutes
import kotlin.time.Duration.Companion.seconds

val rootAgent =
LlmAgent(
Expand All @@ -93,6 +95,8 @@ these settings, as shown in the following code sample:
minTokens = 8192,
ttl = 10.minutes, // Store for up to 10 minutes
cacheIntervals = 5, // Refresh after 5 uses
// On timeout the create fails and the request proceeds uncached.
createHttpOptions = HttpOptions(timeout = 10.seconds),
),
)
```
Expand All @@ -114,6 +118,10 @@ all agents within your app.
content can be used before it expires. This setting allows you to
control how frequently the cache is updated, even if the TTL has not
expired. Defaults to `10`.
- **`create_http_options`** (HttpOptions): The HTTP options for the cache
creation call, which lets you set a timeout on it. If the call times out,
it fails and the request proceeds without caching. Available in Python and
Kotlin; defaults to none.

## Next steps

Expand Down
Loading