Redis.Iris.AgentMemory 0.1.0-preview.1

This is a prerelease version of Redis.Iris.AgentMemory.
There is a newer prerelease version of this package available.
See the version list below for details.
dotnet add package Redis.Iris.AgentMemory --version 0.1.0-preview.1
                    
NuGet\Install-Package Redis.Iris.AgentMemory -Version 0.1.0-preview.1
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Redis.Iris.AgentMemory" Version="0.1.0-preview.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Redis.Iris.AgentMemory" Version="0.1.0-preview.1" />
                    
Directory.Packages.props
<PackageReference Include="Redis.Iris.AgentMemory" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Redis.Iris.AgentMemory --version 0.1.0-preview.1
                    
#r "nuget: Redis.Iris.AgentMemory, 0.1.0-preview.1"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Redis.Iris.AgentMemory@0.1.0-preview.1
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Redis.Iris.AgentMemory&version=0.1.0-preview.1&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Redis.Iris.AgentMemory&version=0.1.0-preview.1&prerelease
                    
Install as a Cake Tool

Redis Iris integration for Microsoft Agent Framework

Redis Field Engineering’s preview .NET connectors provide durable Agent Framework history, owner-scoped memory recall, and authorized Redis Context Retriever tools. The packages are maintained by Redis Field Engineering; they are not Microsoft products.

Use Redis.Iris.AgentFramework for the Microsoft Agent Framework integration. It brings in the Redis.Iris.AgentMemory, Redis.Iris.ContextRetriever, and Redis.Iris.ContextRetriever.Modeling packages; surface administration is available separately through Redis.Iris.ContextRetriever.Management.

Start with the standalone .NET quickstart.

Redis Agent Memory connector

Redis.Iris.AgentMemory is a standalone .NET client for the Redis Agent Memory (RAM) HTTP API. Use it when your application needs to store conversation events, retrieve sessions and summaries, search long-term memories, or delete session events and known memory records. It exposes RedisAgentMemoryClient through IRedisAgentMemoryClient and can be used independently of Microsoft Agent Framework.

Agent Memory provides two complementary kinds of memory:

Memory What it contains When an application uses it
Session memory Conversation events and a service-generated summary, when available Resume a conversation and provide its recent history to the model
Long-term memory Searchable memories that can remain useful across conversations Recall a user's preferences or other relevant facts in a new session

For example, a traveler says “I prefer window seats” in one conversation. Session memory preserves that exchange. When the service's extraction process promotes the preference into long-term memory, the application can retrieve it during a later conversation for the same owner. Promotion is asynchronous and depends on the service configuration; saving an event does not mean the preference is immediately available for recall.

The connector handles HTTP requests, typed contracts, credentials, cancellation, and diagnostics. Redis Agent Memory performs storage, search, summarization, and background extraction. You need an existing Agent Memory endpoint, store ID, and agent credential; an ordinary Redis server alone does not expose this API. Deployments enforcing personal ownership also require a delegated user token.

When using the client directly, your application supplies search filters and authorizes access to sessions and records. The raw client does not automatically add an owner filter to every search. Deleting a session does not delete memories already extracted from it. See the security model and API limits and persistence semantics.

Microsoft Agent Framework integration

Redis.Iris.AgentFramework connects the Agent Memory client to Agent Framework's history and context extension points. Your application supplies the model through an IChatClient; the providers supply remembered context and persist supported conversation messages.

Provider Role in an agent
RedisIrisChatHistoryProvider Loads chronological session history and an optional summary before a run, then saves new supported messages afterward
RedisIrisMemoryProvider Searches long-term memory using the latest external user message and a mandatory owner filter, then adds relevant results as explicitly untrusted context
RedisContextRetrieverProvider Adds authorized MCP tools for retrieving current business records from a separate Context Retriever surface

A typical memory-enabled turn works as follows:

  1. The host resolves and authorizes the current user and session from trusted application state.
  2. The history provider loads that session's conversation. The memory provider searches for relevant memories belonging to the same owner.
  3. Agent Framework invokes the model with the current request, history, recalled context, and any configured tools.
  4. The designated writer appends new supported request and response messages to Agent Memory. The service can extract long-term memories in the background.

Register the memory integration with AddRedisIrisAgentMemory, supplying an IdentityResolver and AuthorizationPolicy, then attach the providers to the agent as shown in the quickstart. Registration coordinates a single event writer when both memory providers are used. Set UseChatHistoryProvider = false to use recall and event capture alongside another history implementation.

To resume a conversation after a restart, preserve the Agent Framework session state and its authorized RAM identity bindings. A new session for the same owner can recall long-term memories while maintaining its own conversation history. The application remains responsible for session storage and authentication; stored provider state never grants access by itself.

History windows, summary length, recall filters, similarity thresholds, and recalled-text budgets are configurable. History loads and writes fail closed by default; recall defaults to continuing without memories on an operation failure. The default mapper persists user and assistant text, so it does not reconstruct a full tool-call or multimodal transcript. See the persistent sample for a complete application.

Context Retriever is optional for memory-only applications. It complements remembered preferences with current records, such as a traveler's flight reservation. See the Context Retriever guide for per-user tool authorization and credential rotation.

Documentation

Supported versions

Component Supported baseline
Build SDK .NET 10 (selected by global.json; required for .slnx)
Application runtimes .NET 10 LTS recommended; .NET 8 compatibility tested until its November 10, 2026 end of support
Microsoft Agent Framework 1.23.x
Redis Agent Memory Managed or self-managed /v1 data plane
Redis Context Retriever Managed MCP or self-managed 0.4.2 over loopback

The connector uses Agent Framework 1.23.0.

The libraries target net8.0 and can be consumed by .NET 10 applications. The build SDK and library target framework are independent.

License and package version

This repository is licensed under MIT. All five packages use the same preview version, 0.1.0-preview.1, declared in src/Directory.Build.props. Preview APIs may change before a stable release. A version in source does not mean the package has been published to NuGet.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 was computed.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 was computed.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Redis.Iris.AgentMemory:

Package Downloads
Redis.Iris.AgentFramework

Redis Iris providers for Microsoft Agent Framework.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.1.1-preview 62 11/13/2026
0.1.0-preview.1 73 10/30/2026