mcpField
I
iris-development

iris-development

github.com/redisエージェントワークフロー1711.7k 回インストール7 週間前に更新
リポジトリ

iris-development について

Redis Agent Memory（RAM）をAIエージェントに組み込むためのガイダンススキルです。Redis Cloudのマネージドサービスが会話履歴と意味検索可能な長期メモリーを扱い、バックグラウンドで記憶を昇格します。PythonとTypeScriptのSDK例も掲載しています。

主な機能

  1. 01Redis Cloudメモリーのセットアップ
  2. 02セッションイベントの保存と取得
  3. 03長期メモリーのセマンティック検索
  4. 04メモリーの一括作成と整理
  5. 05バックグラウンド昇格のガイダンス
  6. 06Python／TypeScript SDKの例

活用シーン

  1. 01Redis Cloudメモリーサービスの作成
  2. 02エージェントとセッションメモリーの接続
  3. 03長期メモリーの検索と絞り込み
  4. 04セッションイベントと直接書き込みの選択

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/redis/agent-skills --skill iris-development

インストール後、Claude Code で/iris-developmentを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
ltm-bulk-create.md
ltm-organize.md
ltm-search.md
promotion-overview.md
session-add-event.md
session-retrieval.md
session-when-to-use.md
setup-auth-token.md
setup-cloud-service.md

詳細

Iris：Redis エージェントメモリ

Iris は、Redis の AI 関連製品をまとめるブランドです。このスキルでは現在、そのファミリーに属する 1 つの製品、Redis Agent Memory（RAM） を扱います。これは、Redis Cloud のマネージドサービスとして提供される、AI エージェント向けの永続メモリレイヤーです。Iris の他の製品も、提供開始に合わせて個別のセクションとして追加されます。

Redis Agent Memory は、2 つのメモリ階層を備えた REST/JSON データプレーン API を公開します。

  • セッションメモリ — セッションごとの追記専用の会話履歴（ワーキングメモリ）です。
  • 長期メモリ — セッションから抽出された（または直接作成された）意味検索可能なレコードです。

Redis Cloud が管理するバックグラウンドの昇格ワーカーが、セッションイベントから永続的な情報を抽出し、長期メモリに書き込みます。

公式 SDK

コード例では、すべて公式 SDK を使用します。

言語パッケージクラスインストール
Pythonredis-agent-memoryAgentMemorypip install redis-agent-memory
TypeScript@redis-iris/agent-memoryAgentMemorynpm add @redis-iris/agent-memory

どちらの SDK も、ベアラートークンを AGENT_MEMORY_API_KEY から、デフォルトのストア ID を AGENT_MEMORY_STORE_ID から読み取ります。本番環境のデータプレーン URL は https://gcp-us-east4.memory.redis.io です。サービスの正確な URL は、プロビジョニング後に Cloud コンソールにも表示されます。

適用するタイミング

次の場合は、これらのガイドラインを参照してください。

  • Redis Cloud でメモリサービスを作成するとき（https://cloud.redis.io/#/agent-memory）
  • エージェントが AgentMemory.add_session_event(...) / addSessionEvent(...) を呼び出すように接続するとき
  • search_long_term_memory(...) / searchLongTermMemory(...) で長期メモリを検索するとき
  • セッションイベントと長期メモリへの直接書き込みのどちらを使うか選ぶとき

優先度別のルールカテゴリ

優先度カテゴリ影響度プレフィックス
1セットアップと Cloud サービス高setup-
2セッションメモリ／イベント高session-
3長期メモリ高ltm-
4メモリの昇格中promotion-

クイックリファレンス

1. セットアップと Cloud サービス（高）
2. セッションメモリ／イベント（高）
  • session-when-to-use - セッションイベントと長期メモリへの直接書き込みのどちらを使うか選ぶ
  • session-add-event - セッションイベントを正しく追加する
  • session-retrieval - セッションメモリと個々のイベントを取得する
3. 長期メモリ（高）
  • ltm-bulk-create - 冪等な ID を使用して長期メモリを一括作成する
  • ltm-search - フィルターを使って長期メモリを意味検索する
  • ltm-organize - namespace、ownerId、topics、memoryType を使ってレコードを整理する
4. メモリの昇格（中）

使用方法

詳しい説明とコード例については、references/ 内の各ルールファイルを読んでください。

references/setup-cloud-service.md
references/session-add-event.md
references/promotion-overview.md

各ルールファイルには、次の内容が含まれています。

  • 重要な理由の簡単な説明
  • Python と TypeScript の SDK コードによる正しい例
  • 「誤った例」、または「使用する場合／不要な場合」のガイダンス
  • 追加の背景情報と参考資料

コメント

Markdown 対応