Redis.Iris.ContextRetriever 0.1.1-preview

This is a prerelease version of Redis.Iris.ContextRetriever.
dotnet add package Redis.Iris.ContextRetriever --version 0.1.1-preview
                    
NuGet\Install-Package Redis.Iris.ContextRetriever -Version 0.1.1-preview
                    
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.ContextRetriever" Version="0.1.1-preview" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Redis.Iris.ContextRetriever" Version="0.1.1-preview" />
                    
Directory.Packages.props
<PackageReference Include="Redis.Iris.ContextRetriever" />
                    
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.ContextRetriever --version 0.1.1-preview
                    
#r "nuget: Redis.Iris.ContextRetriever, 0.1.1-preview"
                    
#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.ContextRetriever@0.1.1-preview
                    
#: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.ContextRetriever&version=0.1.1-preview&prerelease
                    
Install as a Cake Addin
#tool nuget:?package=Redis.Iris.ContextRetriever&version=0.1.1-preview&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.

Custom memory attribute filters are available in Iris mode through the SDK and owner-scoped agent recall. Add Redis.Iris.AgentMemory.Management separately to register server-side types through the Iris control-plane v2 API. See the guide and runnable example.

Add Redis.AgentFramework.SessionStore separately for a Redis-backed AgentSessionStore. It persists serialized framework state by continuation ID (including an A2A context ID) and works alongside RAM history and recall. It uses a direct Redis connection, and does not add a Redis dependency to the RAM client. See session persistence.

Start with the documentation site or read the standalone .NET quickstart source.

To build or contribute to the Antora site, see the documentation contributor guide.

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.19.0 minimum; connector tested with 1.19.0 and 1.23.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

The connector, samples, and notebooks use Agent Framework 1.19.0 by default.

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 seven packages use the same preview version, 0.1.1-preview, 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.

Direct long-term memory writes

Current-Iris deployments support BulkCreateLongTermMemoriesAsync, GetLongTermMemoryAsync, UpdateLongTermMemoryAsync, and UpsertLongTermMemoryAsync. Use stable IDs and request replay keys, inspect bulk errors, and send the reviewed revision for edits. The Agent Framework writer adds host authorization; opt-in agent tools prepare changes for explicit user approval. The DevUI's /memories page creates and edits records and saves agent proposals. See the Agent Memory guide and the sample configuration.

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.ContextRetriever:

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 58 11/13/2026
0.1.0-preview.1 81 10/30/2026