К основному содержанию
скилл CX Codex

add-redis-iris — скилл для Claude Code: что делает и как установить

Скилл add-redis-iris для Claude Code интегрирует Redis Iris в ИИ-агенты на любых фреймворках. Запускается при запросе на добавление памяти, шлюза контекста или маршрутизатора.

MIT 110 установок ★ 178 обновлён 2026-09-08

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add redis/agent-skills --skill add-redis-iris -a claude-code
Открыть на GitHub

Что делает add-redis-iris

Инструмент находит места вызовов модели в коде, определяет используемый фреймворк по импортам и подбирает нужные компоненты Redis Iris вроде Agent Memory или Context Gateway. Он сохраняет текущую архитектуру агента и вносит минимальные изменения в исходный код.

Пакет устанавливается через менеджеры uv, Poetry или стандартные файлы зависимостей проекта. После этого скилл помогает настроить профили подключения в файле конфигурации iris.toml для работы с облачной средой Redis Cloud или автономным кластером.

Для работы требуется существующий Python-проект и менеджер пакетов. Токоны администратора и параметры окружения фиксируются в файлах .env и .env.admin в зависимости от выбранного режима.

Какие задачи решает

  • определить фреймворк существующего ИИ-агента
  • подключить память или плейбуки к проекту
  • настроить шлюз контекста и маршрутизатор интентов
  • сформировать профиль конфигурации iris.toml

Примеры запросов агенту

  • Добавь Redis Iris в этот агент
  • Какой продукт Iris нужен для нашего агента на LangGraph?
  • Настрой шлюз контекста для текущего проекта

Как установить add-redis-iris

1Через Skills CLI (Vercel)

npx skills add redis/agent-skills --skill add-redis-iris -a claude-code

2Вручную: положить файлы

~/.claude/skills/add-redis-iris/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/add-redis-iris/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об add-redis-iris

Как установить add-redis-iris в Claude Code?

Выполните команды npx skills add redis/agent-skills --skill add-redis-iris -a claude-code и ~/.claude/skills/add-redis-iris/SKILL.md.

Что делает add-redis-iris?

Скилл определяет фреймворк агента, находит недостающие модули Redis Iris и подключает их с минимальным изменением кода.

Что нужно для работы add-redis-iris?

Требуется проект на Python, менеджер пакетов uv или Poetry, а также параметры доступа к Redis Cloud или управляемому кластеру.

Исходный текст

SKILL.md · MIT
---
name: add-redis-iris
description: Add Redis Iris to an existing AI agent in any framework (LangGraph, LangChain, OpenAI Agents SDK, Google ADK, Pydantic AI, CrewAI, or a plain loop). Use when the user asks to add Iris, Redis Agent Memory, Agent Playbooks, Context Gateway, Intent Router, or Lens to their agent, or asks which Iris product their agent needs. Detects the framework and routes to the product skill.
license: MIT
metadata:
  author: redis
  version: "1.0.0"
---

# Add Redis Iris

Inspect, install, route. Do not rewrite the agent.

## 1. Find the agent

Locate:

- **The turn**: where the model is called (`invoke`, `Runner.run`, `generate_content`, `agent.run`, `kickoff`, `chat.completions.create`, `messages.create`).
- **Tool registration**: where tools are defined and handed to the model.
- **User and session ids**: where the request's user id and thread or session id live.
- **More than one loop** (a hand-written loop and a framework, or two frameworks)? Create the product objects once in a module with no framework imports, wire each loop at its own seam, and convert one loop at a time. Do not pick the loop for the user.

## 2. Detect the framework

Search imports:

| Import | Framework |
|---|---|
| `langgraph`, `langchain`, `langchain_core` | LangGraph / LangChain |
| `agents` (package `openai-agents`) | OpenAI Agents SDK |
| `google.adk` | Google ADK |
| `pydantic_ai` | Pydantic AI |
| `crewai` | CrewAI |
| only `openai`, `anthropic`, or another model client | Plain loop |

Note the version from the lockfile. Product skills look up that version's API over MCP.

## 3. Find what it lacks

| Symptom in the code | Product | Skill |
|---|---|---|
| No long-term memory, `InMemoryStore`, checkpointer only, memory in a dict or local DB | Agent Memory | `add-agent-memory` |
| Already on Redis Agent Memory through its own REST or MCP client, hand-written adapters, or model-facing memory tools | Agent Memory | `add-agent-memory`, "Already on Redis Agent Memory" |
| Policy or procedures hardcoded in the prompt, tool usage guidance in the prompt, or a vector store over policy docs | Agent Playbooks | `add-agent-playbooks` |
| A semantic response cache: model answers stored and re-served to later users, curated by hand | Agent Playbooks | `add-agent-playbooks`, "Replacing a response cache" |
| Several MCP servers configured one by one in the agent, each with its own secret, or too many tool schemas in the prompt | Context Gateway | `add-context-gateway` |
| A keyword if/else router, or an LLM call just to pick a route | Intent Router | `add-intent-router` |
| No per-turn tracing: no way to see which LLM calls, tools and retrievals one answer used, or what it cost | Lens | `add-lens` |

If the user named a product, use that. If unclear, ask once, listing what you found.

Lens goes next to any product, or on its own: it traces the turn, and every Iris product traces itself inside it. Offer it alongside whatever else you add.

## 4. Install

- `uv.lock` or `[tool.uv]` present: `uv add redis-iris`.
- Poetry: `poetry add redis-iris`.
- Otherwise add `redis-iris` to the project's requirements file.

If resolution fails on pre-releases, retry with `uv add --prerelease=allow redis-iris`. Confirm: `uv run python -c "import redis_iris; print(redis_iris.__version__)"`.

## 5. Route

Follow each chosen product skill. More than one product: each skill adds its own calls. Optionally build them from one config with `Iris.from_env()` (`iris.agent_memory()`, `iris.agent_playbooks()`, `iris.context_gateway()`, `iris.intent_router()`).

Ask once whether the services run on Redis Cloud or a self-managed suite, then write the project's `iris.toml` profile. Only the `iris` CLI reads `iris.toml`; the app reads env vars. It holds URLs only: a token in TOML makes the CLI exit 2. Select the profile with `IRIS_CONFIG=./iris.toml` and `IRIS_PROFILE=cloud` or `IRIS_PROFILE=suite`.

Redis Cloud. The person fills `.env` from the console: `IRIS_<PRODUCT>_URL`, its ID and `_API_KEY` per product.

```toml
[profiles.cloud]
kind = "cloud"
console_url = "https://cloud.redis.io"

[profiles.cloud.agent_memory]
url = "https://gcp-us-east4.memory.redis.io"  # the data-plane URL from the console
```

Self-managed suite. The operator's tokens go in `.env.admin`, never the app's `.env`; `service create --write-env .env` writes the app's `.env`.

```toml
[profiles.suite]
kind = "self-managed"

[profiles.suite.agent_memory]
service_url = "https://memory-admin.example.com"  # control plane: the CLI calls it for service create and check
url = "https://memory.example.com"  # data plane: what the agent calls
identity_url = "https://memory-identity.example.com"  # Identity Service that mints the agent's keys
```

Add one table per product the app uses: `agent_memory`, `agent_playbooks`, `context_gateway`, `intent_router`. `[profiles.suite.context_gateway]` has no `url`: `service create --write-env` writes the Gateway's endpoint. A suite with one shared Identity Service sets `[profiles.suite.identity]` `url` once instead of each `identity_url`. `IRIS_<PRODUCT>_SERVICE_URL`, `IRIS_<PRODUCT>_URL` and `IRIS_<PRODUCT>_IDENTITY_URL` override the profile.

## Rules

- Keep the user's framework, graph, and prompts. Smallest diff.
- Never guess framework APIs from memory. Look them up over MCP (see each product skill).
- Only use APIs in `redis_iris`. `redis_iris.integrations.langgraph.attach` (extra `redis-iris[langgraph]`) and `redis_iris.integrations.adk.attach` (no extra) exist; there is no `IrisTool`, `iris.tools()`, or `iris.turn()`.
- The SDK raises on a missing setting or an outage. Ask whether a product failure may fail the turn; most production agents catch it and continue with an empty block.
- Never commit secrets.

© redis · MIT · redis/agent-skills

Похожие скиллы

Все скиллы по теме «ИИ и ML» →
langchain-fundamentals langchain-ai Скилл langchain-fundamentals для Claude Code помогает создавать агентов LangChain через create_agent(), описывать инструменты и добавлять middleware. Он охватывает состояние диалога, подтверждение действий и обработку ошибок. CX Codex +1 18 500установок langchain-dependencies langchain-ai Скилл langchain-dependencies подбирает точный набор пакетов и версий для LangChain, LangGraph и LangSmith. Помогает избежать несовместимых библиотек при старте проекта на Python или TypeScript. CX Codex +1 17 000установок instrumenting-with-mlflow-tracing mlflow Скилл instrumenting-with-mlflow-tracing добавляет или чинит MLflow tracing в Python и TypeScript: автологирование фреймворков, свои спаны, проверка сохранённых трейсов. CX Codex +1 1 100установок langchain-development Mindrally Скилл langchain-development для Claude Code: задаёт правила разработки на LangChain и LangGraph — композиция цепочек, агенты, память, RAG. Держит Python-проект в едином стиле. CX Codex +1 726установок migrating-langchain-to-pydantic-ai pydantic Скилл migrating-langchain-to-pydantic-ai для Claude Code переносит Python-проекты с LangChain, LangGraph и Deep Agents на Pydantic AI, сохраняя публичные контракты приложения. CX Codex +1 476установок deepagents-implementation existential-birds Скилл deepagents-implementation для Claude Code даёт рецепты сборки агентов на Deep Agents: фабрика create_deep_agent, файловые бэкенды, субагенты и стриминг LangGraph. CX Codex +1 142установок

Из того же набора16

Весь набор →
redis-search Скилл redis-search для Claude Code помогает проектировать индексы Redis Search и составлять запросы. Подключается при настройке фильтров, векторного поиска или RAG. CX Codex +1 1 900установок iris-development Скилл iris-development по Redis Agent Memory: помогает подключить постоянную память ИИ-агента на Redis Cloud — сессии, долговременные записи и их поиск. CX Codex +1 1 700установок add-agent-memory Скилл add-agent-memory для Claude Code и Cursor подключает долговременную память Redis к ИИ-агентам для сохранения сессий. CX Codex +1 113установок add-agent-playbooks Скилл add-agent-playbooks для Claude Code подключает Redis Iris Agent Playbooks к существующему Python-агенту. Он срабатывает при переносе утверждённых ответов и повторяемых процедур из промптов, документов или семантического кэша. CX Codex +1 110установок add-intent-router Скилл add-intent-router для Claude Code переносит выбор маршрута в Redis Iris Intent Router. Он распознаёт намерения и направляет сообщения по заданным маршрутам. CX Codex +1 109установок add-context-gateway Скилл add-context-gateway для Claude Code объединяет MCP-серверы агента за одним Redis Iris Context Gateway. Он включается, когда серверы настроены по отдельности или их схемы инструментов перегружают контекст. CX Codex +1 107установок add-lens Скилл add-lens для Claude Code и Cursor, который добавляет тресинг Redis Iris Lens в существующего ИИ-агента. Запускается при запросе на добавление трассировки и наблюдаемости агента. CX Codex +1 106установок redis-docs-mcp Скилл redis-docs-mcp для Claude Code объясняет, как читать результаты поиска по документации Redis через MCP. Он включается перед поиском или когда результат search, fetch либо ask вызывает вопросы. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой