Page 1 of 8~96 min topic

Prompt caching

Build the mental model

Prompt caching reuses computation for an identical stable prefix (system prompt, shared docs). It is not caching the final answer string.

~12 min this pageHook and intuition

1Try it yourself

Decision drill

Prompt cache lab

Reuse identical prefix tokens — cut cost and latency when system prompt or RAG block repeats.

Prefix efficiency58%

1/3The same system prompt is sent on every request.

2Learn the idea

Read

Analogy for this concept only

Think of keeping a pre-set stage for a play so each night you only rehearse the new scenes. Use the analogy to name the moving parts for prompt caching, then drop it when you need numbers. For the policy-manual assistant, the enduring idea is not a vendor feature name; it is the decision prompt caching changes and the evidence that decision leaves behind.

Prompt caching reuses computation for an identical stable prefix (system prompt, shared docs). It is not caching the final answer string.

Beginners often blur neighboring ideas when discussing prompt caching. Keep it distinct by asking what artifact would still exist if model weights were frozen and only this layer changed on the policy-manual assistant. If you cannot name that artifact, you are still describing “the AI” in general.

Read

Case lens: policy-manual assistant

Pin a stable prefix, enable provider or explicit cache, send only varying suffixes, bill/read cache hits differently, invalidate when prefix bytes change. In day-to-day language for prompt caching: someone brings a need, the system inspects allowed evidence, this layer contributes a judgment or structure, and a consequence reaches a user or downstream system. Deterministic guards—permissions, schemas, arithmetic—still belong to the application around the policy-manual assistant.

Uncertainty is normal for prompt caching. Incomplete inputs and probabilistic behavior mean the policy-manual assistant needs an escape hatch (retry, fallback, escalate) rather than fake certainty in fluent prose.

Read

Make it operational

When you explain prompt caching to a new teammate on the policy-manual assistant, forbid the sentence “the AI just knows.” Replace it with the artifact that moves and the evidence you would file for prompt caching. If they can falsify your picture with a single counterexample from last week’s traffic on the policy-manual assistant, your mental model is working.

Also pin one numeric memory from this prompt caching chapter: without caching: 12.3M input tokens/day; with 90% prefix hits: 1.2M uncached prefix + 0.3M suffix = 1.5M full-price-equivalent tokens before cache-read pricing That number is not decoration; it is a template for how claims about prompt caching on the policy-manual assistant should look in design docs. Scoped specifically to prompt caching / policy-manual assistant / mental-model.

Read

Common mix-ups

People confuse prompt caching with neighboring buzzwords when debugging the policy-manual assistant. Before changing prompts, ask whether the broken stage was evidence gathering, the prompt caching judgment itself, validation, or the product action. Fixing the wrong stage creates folklore (“we tried prompt caching and it failed”) that blocks the next team on the policy-manual assistant. Scoped specifically to prompt caching / policy-manual assistant / mental-model.

Go deeper

Before you start

Why this matters

Spend two minutes on the policy-manual assistant. If prompt caching disappeared tomorrow, what breaks first for the user, and what evidence would prove it was working? Write that before you read the analogy.

In the wild

See how this idea shows up as a product and a company — then come back to the lesson. Skills transfer across vendors.

Check your understanding

Page assessment

Answer from memory. Completion is saved from this evidence, not from opening the next page.

1. What is one idea from this page you would apply, and what evidence would you check?

All responses are required.