Packages and compatibility

All seven packages share preview version 0.1.1-preview, declared in src/Directory.Build.props. Preview APIs may change before a stable release.

Package Purpose

Redis.AgentFramework.SessionStore

Optional direct Redis session store for serialized framework state, separate from RAM history and recall.

Redis.Iris.AgentFramework

Microsoft Agent Framework history, recall, and Context Retriever providers; depends on the next three packages.

Redis.Iris.AgentMemory

Standalone HTTP client for session events, summaries, filtered memory search, and scoped deletion.

Redis.Iris.ContextRetriever

Authorized MCP tool discovery and invocation, typed reads, and connection caching.

Redis.Iris.ContextRetriever.Modeling

Compile POCO attributes or fluent configuration into a DataModel and compare model changes.

Redis.Iris.ContextRetriever.Management

Optional administrative HTTP client for creating, reading, and updating surfaces. Add it explicitly in deployment tooling.

Redis.Iris.AgentMemory.Management

Optional Iris control-plane v2 client for registering custom memory types and updating extraction strategies. Add it explicitly in deployment tooling.

Supported baselines

Component Baseline

Build SDK

.NET 10, selected by global.json and required for .slnx.

Library target

net8.0; consumable from .NET 10 applications.

Application runtime

.NET 10 LTS recommended. .NET 8 compatibility is tested until its November 10, 2026 end of support.

Microsoft Agent Framework

1.19.0 minimum; connector tested with 1.19.0 and 1.23.0. Samples and notebooks use 1.19.0.

Redis Agent Memory

Original /v1/stores API (default), or current self-managed Iris API with ApiMode = AgentMemoryApiMode.Iris.

Redis Context Retriever

Managed MCP or self-managed 0.4.2 over loopback.

Build packages from source

Run from the repository root:

./eng/pack.sh

Use artifacts/packages as a local NuGet source and keep NuGet.org enabled for external dependencies. See the quickstart for installation and the packaging guide for release validation.

Migrate earlier previews

Replace references and namespaces named Microsoft.Agents.AI.Redis.Iris with Redis.Iris.AgentFramework. The assembly is Redis.Iris.AgentFramework.dll; rebuild applications and restart notebook kernels. No compatibility assembly is supplied under the earlier name.

Surface administration uses Redis.Iris.ContextRetriever.Management rather than the earlier ContextCtlSurfaceDeployer API. See modeling and management for the direct HTTP workflow.

License

The connector source and documentation are available under the MIT license.