Skip to content

Commit 04cc351

Browse files
nkanu17koverholt
andauthored
Add Redis integration entry (#1777)
* Add Redis integration entry Adds an integration catalog entry for `adk-redis` (https://github.com/redis-developer/adk-redis), the Python package that provides Redis-backed ADK integrations: - RedisVL-backed search tools (vector, hybrid, range, text, SQL), including native FT.HYBRID on Redis 8.4+ - Session and long-term memory services that implement BaseSessionService and BaseMemoryService against Redis Agent Memory Server - An McpToolset helper for RedisVL's own MCP server (`rvl mcp`), alongside the existing Agent Memory Server MCP helper - Self-hosted and managed (Redis LangCache) semantic cache providers Built and previewed with `mkdocs build --strict`; the page renders at /integrations/redis/ and appears on the catalog grid. * Minor fixes to Redis integration page * Use ADK's native McpToolset for the RedisVL MCP integration Per maintainer guidance on the PR review thread: - Replace `create_redisvl_mcp_toolset(...)` (a third-party Python wrapper that adk-redis shipped briefly but does not ship in the released 0.0.5) with ADK's native `McpToolset` plus `StdioConnectionParams` + `StdioServerParameters(command="rvl", ...)`. Matches the pattern used by every other MCP catalog page (cartesia, chroma, mongodb, pinecone, qdrant). - Add a `!!! note` admonition pointing readers to `/tools-custom/mcp-tools/` if they want to connect to the `rvl mcp` server from other ADK language SDKs. - Rename the tab from "MCP toolset" to "RedisVL MCP server" and prepend a one-paragraph explanation. - Update the surface table at the top: split the single "MCP toolsets" row into "RedisVL MCP" (native McpToolset against `rvl mcp`) and "AMS MCP toolset" (`create_memory_mcp_toolset`). - Update the "Available tools" table: replace the `create_redisvl_mcp_toolset(...)` helper row with a description of the `rvl mcp` server's exposed tools and how to wire `McpToolset` to them. Other clean-ups: - Drop the `pip install 'adk-redis[mcp-search]'` line; the extra was retired from adk-redis 0.0.5 along with the wrapper. Add a `pip install 'redisvl[mcp]>=0.18.2'` line for the MCP CLI. - Switch sample vectorizer to `redis/langcache-embed-v2`, matching the repo's runnable examples and the rest of the adk-redis docs. Verified with `mkdocs build --strict` locally. The admonition renders; the link to `/tools-custom/mcp-tools/` resolves. * Switch Redis catalog icon to the official Red wordmark SVG The page previously used the Redis org GitHub avatar PNG (460x460, cube mark). Swap to `Redis_Logo_Red_RGB.svg` from the official Redis brand kit (sourced via redis/redis-vl-python), matching the logo used in the adk-redis README hero. SVG is acceptable for catalog assets (see goodmem.svg precedent). Note: this asset is a wordmark (viewBox ~500x156), wider than peer catalog cards which are mostly square. If it renders awkwardly on the catalog grid, swap back to a square cube-mark variant. - Add `docs/integrations/assets/redis.svg`. - Update `catalog_icon` in `redis.md` frontmatter. - Drop `docs/integrations/assets/redis.png`. Verified with `mkdocs build --strict`. * Formatting and minor edits * fix: remove AMS MCP toolset mentions per reviewer feedback Remove create_memory_mcp_toolset() references from the overview table and MCP tools table. This wrapper was removed from adk-redis in v0.0.6 (redis-developer/adk-redis#13). Users should use ADK's native McpToolset with SseConnectionParams for Agent Memory Server MCP access. Resolves comments from @koverholt on lines 29 and 239. * fix: reorder tabs and table to lead with MCP, fix count to four ways * feat: add AMS MCP server tab and MCP table entry Add a separate code tab showing how to connect ADK's native McpToolset to Agent Memory Server's MCP endpoint over SSE, based on the fitness_coach_mcp example. Also add a corresponding row to the MCP reference table. Update overview count to five ways. * fix: rename AMS MCP to Sessions + Memory MCP server * feat: split Semantic cache tab into self-hosted and LangCache Add a separate LangCache tab with accurate code snippet using LangCacheProvider and LangCacheProviderConfig (cache_id, api_key, server_url). No local vectorizer needed for the managed service. * refactor: move semantic caching into its own section Semantic caching is a cross-cutting optimization rather than a core integration approach. Move the self-hosted (RedisVL) and managed (LangCache) cache tabs out of 'Use with agent' into a dedicated '## Semantic caching' section. Drop the cache row from the overview table, leaving four core approaches. * fix: add descriptions to Sessions + Memory and Search tools tabs * fix: semantic search -> hybrid search in Sessions + Memory description * docs: link to adk-redis mkdocs site in additional resources Primary docs link now points to redis-developer.github.io/adk-redis/. The redis.io integration page is kept as a secondary reference. * Remove redundant MCP table - does not show tools; make approaches wording future proof * Readd MCP table with tools and options as before --------- Co-authored-by: Kristopher Overholt <koverholt@google.com>
1 parent 6458159 commit 04cc351

2 files changed

Lines changed: 442 additions & 0 deletions

File tree

docs/integrations/assets/redis.svg

Lines changed: 66 additions & 0 deletions
Loading

0 commit comments

Comments
 (0)