Skip to content

Review and update the context section documentation #701

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
Timonwa merged 2 commits into from
May 15, 2026
Merged

Review and update the context section documentation #701

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
79bc57c
Refactor ReadonlyContext and ToolContext documentation
Timonwa May 14, 2026
dd04c13
Address PR review comments on context docs
Timonwa May 14, 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
509 changes: 111 additions & 398 deletions apps/docs/content/docs/framework/context/callback-context.mdx
View file
Open in desktop

Large diffs are not rendered by default.

29 changes: 23 additions & 6 deletions apps/docs/content/docs/framework/context/context-caching.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ title: Context Caching
description: A guide explaining how to configure and use context caching in ADK-TS with Gemini and Anthropic models to reuse large prompts efficiently, reducing latency and token costs.
---

import { Cards, Card } from "fumadocs-ui/components/card";
import { Callout } from "fumadocs-ui/components/callout";

When working with agents to complete tasks, you may want to reuse extended instructions or large sets of data across multiple agent requests to a generative AI model. Resending this data for each agent request is slow, inefficient, and can be expensive. Using context caching features in generative AI models can significantly speed up responses and lower the number of tokens sent to the model for each request.
Expand Down Expand Up @@ -140,9 +141,25 @@ Additionally, follow these best practices:

## Next steps

If your use case relies on instructions that should persist across an entire
session, consider using static or session-level instructions instead of
re-sending them on every request.

To evaluate the impact of context caching, compare latency and token usage with
and without caching enabled while running the same agent workload.
<Cards>
<Card
title="⚙️ InvocationContext"
description="Where contextCacheConfig lives — understand the full invocation data model"
href="/docs/framework/context/invocation-context"
/>
<Card
title="🤖 Agents"
description="Attach context caching to agents via AgentBuilder or LlmAgent"
href="/docs/framework/agents"
/>
<Card
title="🔁 CallbackContext"
description="Use callbacks to observe or control state around cached invocations"
href="/docs/framework/context/callback-context"
/>
<Card
title="📦 Session, State, Memory"
description="Session lifecycle and how state persists across invocations"
href="/docs/framework/session-state-memory/session"
/>
</Cards>
Loading
Loading