Skip to content

google-adk: bring docs to parity with adk-redis 0.0.5#3347

Merged
mich-elle-luna merged 1 commit into
redis:mainfrom
nkanu17:feat/adk-redis-0.0.5-parity
May 20, 2026
Merged

google-adk: bring docs to parity with adk-redis 0.0.5#3347
mich-elle-luna merged 1 commit into
redis:mainfrom
nkanu17:feat/adk-redis-0.0.5-parity

Conversation

@nkanu17
Copy link
Copy Markdown
Contributor

@nkanu17 nkanu17 commented May 20, 2026

Summary

adk-redis 0.0.5 shipped to PyPI earlier today (release notes). It includes a few user-facing changes the redis.io ADK docs were behind on:

  • New RedisSQLSearchTool and adk-redis[sql] extra.
  • New redis_sql_search and redisvl_mcp_search examples (the latter mirrors redis_search_tools but uses the rvl mcp server over MCP).
  • Repo-canonical model and embedder bumped: gemini-2.0-flashgemini-2.5-flash and redis/langcache-embed-v1redis/langcache-embed-v2.
  • Linux quirk on host.docker.internal documented.
  • epsilon removed from RedisVectorQueryConfig (breaking, range only).
  • redisvl.extensions.llmcache import migrated to redisvl.extensions.cache.llm.

This PR brings every page under content/integrate/google-adk/ up to date.

Changes per page

_index.md

  • AMS Docker command: gemini-2.0-flashgemini-2.5-flash.
  • New paragraph on the host.docker.internal Linux quirk (use --network=host and 127.0.0.1, or the 172.17.0.1 bridge gateway).
  • Installation section adds pip install adk-redis[sql] and pip install 'redisvl[mcp]>=0.18.2'.
  • Capabilities table now mentions the SQL tool and the rvl mcp server; example count goes from seven to nine.

search-tools.md

  • Page now describes five in-process search tools (was four). New RedisSQLSearchTool section with the parameterized-SQL pattern.
  • New "RedisVL MCP server" section showing ADK's native McpToolset wired to rvl mcp over stdio, following the maintainer guidance on google/adk-docs#1777. Includes "When to choose in-process vs MCP" matrix and a coverage note that range/SQL have no MCP equivalent today.
  • Bottom links now point at the two new examples.

redis-agent-memory.md

  • Working-memory model_name bumped to gemini-2.5-flash.

examples.md

  • Count bumped to nine; added redis_sql_search and redisvl_mcp_search entries.

semantic-caching.md

  • Vectorizer model: redis/langcache-embed-v1redis/langcache-embed-v2 (matches the runnable example).
  • Agent model: gemini-2.0-flashgemini-2.5-flash.

What is intentionally NOT in this PR

  • No mention of create_redisvl_mcp_toolset(...) or the [mcp-search] extra. That helper lived briefly on the adk-redis main branch but was removed before 0.0.5 shipped, per the adk-docs PR review which steered the integration toward ADK's native McpToolset pattern (matching cartesia / chroma / mongodb / pinecone catalog pages). The published package does not ship the helper; the docs should not reference it.

Test plan

  • Grep verifies no stale references remain: create_redisvl_mcp_toolset, mcp-search, gemini-2.0-flash, langcache-embed-v1, "four search tools", "seven (complete|runnable) examples".
  • All five edited pages are markdown-only, no front-matter or shortcode changes that would affect Hugo render.
  • Hugo build preview (please verify on the redis.io staging deploy).

References


Note

Low Risk
Documentation-only updates: adds new SQL search/MCP guidance and refreshes example snippets and model names, with no runtime code changes. Risk is limited to potential confusion if instructions or version pins are incorrect.

Overview
Brings the Google ADK integration docs up to date with adk-redis v0.0.5 by documenting the new RedisSQLSearchTool (and adk-redis[sql] install extra), adding a new RedisVL MCP server section showing ADK-native McpToolset usage, and expanding the examples list from seven to nine.

Updates snippets and setup guidance to match current defaults (Gemini gemini-2.5-flash, redis/langcache-embed-v2), adds Linux notes for host.docker.internal, and links/install instructions for redisvl[mcp]>=0.18.2.

Reviewed by Cursor Bugbot for commit 61be38b. Bugbot is set up for automated code reviews on this repo. Configure here.

adk-redis 0.0.5 shipped to PyPI today with several changes that
the redis.io ADK docs were behind on. This brings the docs to parity.

Drift fixed:

- `_index.md`: AMS Docker command bumped from `gemini-2.0-flash` to
  `gemini-2.5-flash`. Added a Linux note for `host.docker.internal`
  (it does not resolve by default on Linux). Added the
  `pip install adk-redis[sql]` and `pip install redisvl[mcp]>=0.18.2`
  install lines. Capabilities table now mentions the SQL tool and the
  `rvl mcp` server, and the example count goes from seven to nine.
- `search-tools.md`: page now describes FIVE search tools (the new
  `RedisSQLSearchTool` was missing). Added a SQL search section with
  a runnable snippet and the parameterized-query pattern. Added a
  "RedisVL MCP server" section showing ADK's native `McpToolset`
  wired to `rvl mcp` over stdio, following the maintainer guidance
  on `google/adk-docs#1777`. Bottom links now point at the two new
  examples (`redis_sql_search`, `redisvl_mcp_search`).
- `redis-agent-memory.md`: working-memory `model_name` bumped from
  `gemini-2.0-flash` to `gemini-2.5-flash`.
- `examples.md`: count bumped to nine; added `redis_sql_search` and
  `redisvl_mcp_search` entries.
- `semantic-caching.md`: vectorizer model bumped from
  `redis/langcache-embed-v1` to `redis/langcache-embed-v2` (matches
  the runnable examples and the rest of adk-redis docs). Agent model
  bumped from `gemini-2.0-flash` to `gemini-2.5-flash`.

What is intentionally NOT in this PR:

- No mention of `create_redisvl_mcp_toolset(...)`. That helper was in
  the adk-redis main branch briefly but was removed before 0.0.5
  shipped, per the catalog-page review feedback that pushed us toward
  using ADK's native `McpToolset` directly. The repo no longer ships
  it; the docs should not reference it.
- No mention of the `[mcp-search]` extra. Same reason.

Verified all five files pass a grep for stale references
(`create_redisvl_mcp_toolset`, `mcp-search`, `gemini-2.0-flash`,
`langcache-embed-v1`, "four search tools", "seven examples").
@mich-elle-luna mich-elle-luna self-assigned this May 20, 2026
Copy link
Copy Markdown
Collaborator

@mich-elle-luna mich-elle-luna left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thank you!

@mich-elle-luna mich-elle-luna merged commit 0c90cf6 into redis:main May 20, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants