DOC-7113: Add a scripted Context Retriever interactive demo by paoloredis · Pull Request #4105 · redis/docs

paoloredis · 2026-09-24T14:10:26Z

Adds a browser-only demo page for Redis Context Retriever, to promote the Redis Iris GA. Sample data from a fictional food delivery app (customers, restaurants, orders) is stored as JSON keys. The reader edits the data model, watches the MCP tools regenerate, and then watches a scripted agent answer six questions over JSON-RPC tools/call. No service is called; results are computed in the browser from the sample data.

Tool names, argument schemas, and response envelopes copy what a live Context Retriever service returned. Relationship names and text/numeric conditions on the per-entity filter tool are modelled, not observed.

New page under develop/ai/context-engine/context-retriever, linked from the section overview.
New context-retriever-demo shortcode with its own JS and CSS.

Note

Low Risk
Static documentation and client-side demo assets only; no production services, auth, or data paths are modified.

Overview
Adds a browser-only interactive demo for Redis Context Retriever so readers can see how a data model becomes MCP tools before creating a Cloud service.

A new docs page embeds the context-retriever-demo Hugo shortcode, which loads scoped CSS/JS once per page. The widget walks through three steps—sample Redis JSON keys (food-delivery customers/restaurants/orders), an editable entity model that regenerates tool schemas when templates or field indexes change, and a scripted “agent” that replays six sample questions as JSON-RPC tools/call flows (computed in-memory; no real MCP service). The Context Retriever section overview now links to this page.

Core logic mirrors live tool names, argument shapes, and response envelopes; window.ContextRetrieverDemo exposes helpers for tests.

^{Reviewed by Cursor Bugbot for commit c705253. Bugbot is set up for automated code reviews on this repo. Configure here.}

Adds a browser-only demo page for Redis Context Retriever, to promote the Redis Iris GA. Sample data from a fictional food delivery app (customers, restaurants, orders) is stored as JSON keys. The reader edits the data model, watches the MCP tools regenerate, and then watches a scripted agent answer six questions over JSON-RPC tools/call. No service is called; results are computed in the browser from the sample data. Tool names, argument schemas, and response envelopes copy what a live Context Retriever service returned. Relationship names and text/numeric conditions on the per-entity filter tool are modelled, not observed. - New page under develop/ai/context-engine/context-retriever, linked from the section overview. - New context-retriever-demo shortcode with its own JS and CSS. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

github-actions · 2026-09-24T14:10:43Z

DOC-7113

github-actions · 2026-09-24T14:10:53Z

Staging links:
https://redis.io/docs/staging/DOC-7113/develop/ai/context-engine/context-retriever/
https://redis.io/docs/staging/DOC-7113/develop/ai/context-engine/context-retriever/interactive-demo/

github-actions · 2026-09-24T14:11:25Z

🧠 Redis Memory

Found 13 related items from repository history:

PR — RC/AI: Context Retriever

This is the best I can possibly do before Monday.
PR — Add Context Engine (Redis Iris) agent type to the AI agent builder

Adds a fourth agent type, "Context Engine Agent", whose memory is fully managed by the Redis Iris Context Engine instead of raw Redis. Each
Commit — Add interactive context-map diagram to Iris concepts page

Add interactive context-map diagram to Iris concepts page
Commit — Add Iris concepts pages for the mental-model shift from plain Redis

Add Iris concepts pages for the mental-model shift from plain Redis
Commit — Add Context Engine (Redis Iris) agent type to the AI agent builder

Add Context Engine (Redis Iris) agent type to the AI agent builder
Commit — DOC-7113: Add a scripted Context Retriever interactive demo

DOC-7113: Add a scripted Context Retriever interactive demo
PR — DOC-6809 Docs-only MCP server: spec + v0 prototype

Note: not finished - just using the PR for Bugbot feedback so far.
PR — Redis Workbench
PR — Add a new Get started quick start under Develop, above What's new

Add a tabbed quick start covering the three deployment methods (Redis Cloud, Redis Software, Redis Open Source) and connecting a first clien
PR — Iris concepts

Add four new concepts documents for Iris, RAM, Langcache and CR.
PR — Restyle Iris/AI context-engine tiles and update self-managed messaging
- Add a tile-card shortcode matching the integrate page's card style (colored swatch, uppercase mono label, description, "Learn more" link)
PR — Context retriever quickstart

add missing quickstart doc for context retriever and move the context retriever self-managed install page to the operate section
Commit — Address review feedback on Context Retriever quickstart

Address review feedback on Context Retriever quickstart

Memory updated at c705253

CLAassistant · 2026-09-24T14:14:33Z

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

cursor

Stale Bugbot comment from a previous run.

…ross tabs - ts() treated an explicit hour of 0 as missing and used noon, so the "this month" bounds ran noon to noon. Only a missing hour now defaults to noon. - The Ask panel was rebuilt on every visit, which dropped the chat and left the question buttons dead until an orphaned replay finished. It is now built once, so a replay keeps playing across tab switches; returning reconnects only when the data model changed the tools. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

cursor

Stale Bugbot comment from a previous run.

get_*_by_id returned a not-found object, and the scripted agent read .name from it, so editing a key template to match no keys produced answers like "from undefined". A missing record now fails the call as a tool error (result with isError: true, the shape the live server uses for failed lookups), and the agent says which lookup failed and points at that entity's key template. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

cursor

Stale Bugbot comment from a previous run.

The button/select/input reset (font and color: inherit) had higher specificity than single-class rules, so the red CTA buttons rendered dark ink on red at 15px, and tabs, sub-tabs, chips, and selects lost their sizes and colors. The reset is now wrapped in :where() so it has zero specificity; computed styles checked in the browser now match the intended values. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

mich-elle-luna · 2026-09-24T17:00:31Z

Thank you! This is really cool 💟

mich-elle-luna

thank you!

paoloredis · 2026-09-25T07:25:06Z

@n-valchev what do you think of the demo on this page https://redis.io/docs/staging/DOC-7113/develop/ai/context-engine/context-retriever/interactive-demo/ ? thanks

The "Behind the scenes" panel added INDEXMISSING to every indexed field, while its note said only the index names were illustrative. The live service varies the options by field type, so the panel now does too: - TAG fields: TAG INDEXMISSING - NUMERIC fields: NUMERIC SORTABLE - TEXT fields: plain TEXT The note now says tag fields are the ones that use INDEXMISSING, so the Redis 7.4 requirement still holds, and that tag fields used for access control also get INDEXEMPTY, which the demo doesn't include. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

cursor

Stale Bugbot comment from a previous run.

To list Maya's orders by date, the scripted agent sorted the filter_order result in place. That array is also what the tools/call card shows as the tool's response, so the card showed the orders in date order (o3018 before o3003) instead of the order the tool returned. The answer now sorts a copy, as the diet question already did. A check over all six questions confirms none of them changes a stored tool result. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

cursor

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, have a team admin enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit e55827f. Configure here.}

The badge counted every key a template matched, but queries and the generated FT.CREATE ... ON JSON index only use JSON documents. Pointing a template at cart:u104 (a hash) showed a green match, then lookups and filters returned nothing. The badge now counts JSON documents only, and a template that matches only other key types shows "Matches 1 key, but not JSON" in red, with a tooltip that Context Retriever only reads JSON. Also fixes "Matches 1 keys". Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Editing a key template kept the entity's fields, so pointing Customer at cart:u104 still listed the eight customer fields, which describe documents the template no longer reaches. Changing a template now re-detects the fields from the JSON documents it matches, as Auto-detect fields does in the console: restaurant:{id} gives restaurant fields, and a template that matches no JSON documents gives none, so the entity gets no tools. Index edits are kept per document type, so switching the template back restores them. If the agent needs a tool that no longer exists, it now says the entity has no fields instead of blaming an index. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

An edited key template stayed in place after switching to another entity, so coming back to Customer still showed cart:{id} and no fields. Switching sub-tabs now puts the template of the entity being left back to its default, with its default fields. Index choices made on the entity's own documents are kept; anything set while the template pointed at other documents is dropped. Going to the Ask step keeps the edit, so readers can still see what a broken template does to the agent. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Resetting a template whenever the reader switched entities undid the point of editing it: a changed or broken template is how readers see what it does to the agent's answers. Edits now stay across sub-tab and step switches. A Reset button next to the template, shown only while it differs from the default, puts it back with its default fields. Index choices made on the entity's own documents are kept, as before. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

Adds a browser-only Context Retriever interactive demo page with its own shortcode, JS and CSS.

cursor Bot reviewed Sep 24, 2026

View reviewed changes

Comment thread static/js/context-retriever-demo.js Outdated

Comment thread static/js/context-retriever-demo.js

cursor Bot reviewed Sep 24, 2026

View reviewed changes

Comment thread static/js/context-retriever-demo.js

cursor Bot reviewed Sep 24, 2026

View reviewed changes

Comment thread static/css/context-retriever-demo.css Outdated

mich-elle-luna approved these changes Sep 24, 2026

View reviewed changes

mich-elle-luna requested a review from a team September 24, 2026 17:17

github-actions Bot mentioned this pull request Sep 25, 2026

Context retriever quickstart #4116

Merged

paoloredis requested a review from n-valchev September 25, 2026 07:24

n-valchev reviewed Sep 25, 2026

View reviewed changes

Comment thread static/js/context-retriever-demo.js Outdated

cursor Bot reviewed Sep 28, 2026

View reviewed changes

Comment thread static/js/context-retriever-demo.js Outdated

cursor Bot reviewed Sep 28, 2026

View reviewed changes

Comment thread static/js/context-retriever-demo.js Outdated

paoloredis and others added 4 commits September 28, 2026 12:18

paoloredis merged commit 9cad0b4 into main Sep 28, 2026
98 of 99 checks passed

paoloredis deleted the DOC-7113 branch September 28, 2026 12:50

EliShteinman added a commit to EliShteinman/docs that referenced this pull request Sep 29, 2026

Merge upstream PR redis#4105 into feature/docker-support

9e63dd3

Adds a browser-only Context Retriever interactive demo page with its own shortcode, JS and CSS.

EliShteinman added a commit to EliShteinman/docs that referenced this pull request Sep 29, 2026

Merge upstream PR redis#4105 into feature/docker-support

dfa1a69

Adds a browser-only Context Retriever interactive demo page with its own shortcode, JS and CSS.

Conversation

paoloredis commented Sep 24, 2026 • edited by cursor Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 24, 2026 • edited by atlassian Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions Bot commented Sep 24, 2026

Uh oh!

github-actions Bot commented Sep 24, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🧠 Redis Memory

Uh oh!

CLAassistant commented Sep 24, 2026

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

mich-elle-luna commented Sep 24, 2026

Uh oh!

mich-elle-luna left a comment

Choose a reason for hiding this comment

Uh oh!

paoloredis commented Sep 25, 2026

Uh oh!

Uh oh!

cursor Bot left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Uh oh!

cursor Bot left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

paoloredis commented Sep 24, 2026 •

edited by cursor Bot

Loading

github-actions Bot commented Sep 24, 2026 •

edited by atlassian Bot

Loading

github-actions Bot commented Sep 24, 2026 •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading

cursor Bot left a comment •

edited

Loading