Library / Case Studies

Learning with Privacy at Scale at Apple

Understanding how people use their devices often helps in improving the user experience. However, accessing the data that provides such…

By Scale at Apple engineers · Scale at Apple · Added 2026-10-12

Open original source

All content belongs to Scale at Apple engineers / Scale at Apple. We only link to it and give credit. Report a problem

Learn this case study

About 37 min left. Your work is saved as you go.

What you are about to study

Scale at Apple explains a real system. You should know the basics: caching, queues and replication.

Ideas you will meet

Distributed Systems
Consensus, time, failure and the fundamentals of scale-out.
Machine Learning Systems
Recommendations, ranking, feature stores and serving models at scale.

What we already know about this

Our own lessons on these ideas. Read them here before you start, so it makes sense.

  • Real-World Systems · 11 minDesign an AI coding assistantHow an editor assistant suggests code in under a second: gathering context, retrieval, the model, streaming and keeping private code safe.Read here

    The problem

    An assistant inside the editor that completes code as you type, answers questions in a chat panel, and can edit files. The hard constraints:

    • Latency: inline suggestions must appear in roughly a few hundred milliseconds, or the user has already moved on.
    • Relevance: good suggestions need the right context from a large codebase, not just the current line.
    • Cost: language-model inference is expensive per request, and typing generates a request storm.
    • Privacy and security: customer source code and secrets are sensitive.
    • Quality: wrong or insecure suggestions must be limited and measurable.

    Architecture

    Figure SDA-RWS-18-1 · AI coding assistant architecture · © forcsguy.com

    1. The editor extension

    Runs in the user's editor. It watches typing, debounces requests (waits a few tens of milliseconds), cancels outdated requests when the user continues typing, and streams the suggestion into the editor as ghost text. It also handles accept, reject and partial accept, and enforces local privacy rules (excluded files, secret detection).

    2. Building context

    Prompt = instructions + context + the code around the cursor. Context comes from:

    • The current file: the code before the cursor (prefix) and after it (suffix, for fill-in-the-middle).
    • Open tabs and recently edited files.
    • Imports and related files: definitions of functions and types being used.
    • Retrieved snippets from the wider project.

    All of it must fit the model's context window and a token budget, so the builder ranks pieces by relevance and trims.

    3. Retrieval over a codebase

    A repository is too big to include whole, so it is indexed:

    1. Split files into chunks (functions, classes, blocks).
    2. Compute embeddings (vectors capturing meaning) and store them in a vector index, together with a symbol and dependency graph (what calls what).
    3. At request time, search with the current code as the query and combine semantic results with structural ones (definitions, callers, tests).
    4. Update the index incrementally as files change, and keep per-user and per-organisation isolation.

    4. Model serving

    • A language model generates tokens. Serving systems batch many requests together, reuse a KV cache of already-processed prompt tokens, and stream output so the first words show immediately.
    • Use smaller, faster models for inline completion and larger ones for chat and complex edits.
    • Cache repeated prompts and completions where context is identical, and prefix-cache shared prompt parts.
    • Autoscale GPU capacity, and route by region for latency.

    5. Post-processing and safety

    • Trim the output to a sensible stopping point (end of block or line).
    • Filter secrets, personal data and known insecure patterns; optionally check for verbatim public code matches and licence concerns.
    • Reject low-confidence suggestions instead of showing noise.
    • For agents that edit files or run commands, require explicit user approval and run actions in a sandbox.

    Figure SDA-RWS-18-2 · How a code model is trained and judged · © forcsguy.com

    Latency budget

    For inline suggestions, a budget like this keeps the experience smooth:

    StepTarget
    Debounce and local contextabout 30 ms
    Network to the serviceabout 30 ms
    Retrieval and prompt buildingabout 30 ms
    Model: time to first tokenabout 150 ms
    Streaming and displaycontinuous

    Everything else (retrieval, indexing, safety checks) must fit inside it or run asynchronously ahead of time.

    Privacy, security and trust

    • Send only what is needed, respect ignore files, and redact secrets.
    • Provide enterprise controls: private deployment or isolated tenancy, no training on customer code, short retention, audit logs.
    • Encrypt in transit and at rest; strong authentication and per-user quotas.
    • Defend against prompt injection (malicious text in files or web pages trying to instruct the model): treat retrieved content as data, limit tool permissions, require confirmation for risky actions.

    Measuring quality

    • Offline evaluation: run the model on held-out code and tests, measure pass rates and exact-match similarity.
    • Online metrics: acceptance rate of suggestions, characters kept after acceptance, latency percentiles, and errors.
    • A/B test changes to prompts, models and retrieval, and watch for regressions in security and licence filters.
    • Collect feedback signals (thumbs up or down) while respecting privacy.

    What this design reuses

    Debouncing and cancellation, caching, rate limiting and quotas, queues and batching, vector search, streaming responses and careful privacy controls: the same building blocks from the rest of this course, applied to a latency-sensitive AI workload.

    Real-world reading

    Open this lesson with its quiz and exercise

Go deeper on this

A path through videos, articles, other case studies and code on the same ideas as Learning with Privacy at Scale at Apple.

  1. Warm upGet the vocabulary first.

  2. WatchHow others solve the same problem, on video.

    Videos belong to their creators and play from YouTube. More on YouTube (opens in a new tab)

  3. ReadEngineers explain it in their own words.

  4. See it in another companyThe same ideas, a different system.

  5. Read the codeSee how it looks when it is real.

Keep learning

Loading community…