Progress.Memory.SemanticKernel 0.2.1

Progress.Memory.SemanticKernel

Semantic Kernel integration for Progress Memory.

Adds long-term memory to Semantic Kernel agents via a KernelPlugin (remember / recall / forget) and an IChatCompletionService middleware wrapper that automatically injects memories into every SK chat request.

Not using Semantic Kernel?
For Microsoft.Extensions.AI pipelines, use Progress.Memory.Extensions.AI instead.

Requirements

• .NET 8, 9, or 10
• Progress.Memory (auto-included as a dependency)
• Microsoft.SemanticKernel ≥ 1.76.0

Installation

dotnet add package Progress.Memory.SemanticKernel

Integration modes

Choose one or combine both:

Mode 1 — Plugin (LLM-controlled)

Register a ProgressMemoryPlugin on the IKernelBuilder. The SK planner and the LLM can then autonomously invoke memory functions when they determine context is needed.

Minimal example

// Register the memory client
builder.Services.AddProgressMemory(new ProgressMemoryConfig(
    BackendBaseUrl: "https://memory.example.com",
    SdkApiKey: "pmem_p_..."));

// Add memory plugin to the kernel
var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .AddProgressMemoryPlugin(memoryClient, userId: "user-123", agentId: "my-agent")
    .Build();

Dynamic identity (multi-tenant / per-request)

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .AddProgressMemoryPlugin(
        memoryClient,
        getUserId:  () => httpContextAccessor.HttpContext!.User.FindFirst("sub")!.Value,
        getAgentId: () => "my-agent")
    .Build();

Resolving from the service provider

services.AddProgressMemory(config);

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .AddProgressMemoryPlugin(services.BuildServiceProvider(),
                             userId: "user-123", agentId: "my-agent")
    .Build();

Plugin functions

Mode 2 — Middleware (auto-inject)

Wrap an IChatCompletionService with the UseProgressMemory extension. On every SK chat call:

1. The last user message is used to search for relevant past memories.
2. Matching facts are prepended as a system message before the request reaches the underlying service.
3. If autoRemember: true, the completed exchange is saved to memory (awaited inline).

Why a separate IChatCompletionService wrapper?
Bridging via AsChatClient() causes SK's PromptExecutionSettings to go through a JSON round-trip that breaks ToolCallBehavior deserialization. The ProgressMemoryInjectingChatCompletionService avoids this by operating directly at the IChatCompletionService layer.

Example

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .Build();

// Wrap the registered chat completion service
var baseService = kernel.GetRequiredService<IChatCompletionService>();
var memoryService = baseService.UseProgressMemory(
    kernel.Services,
    memoryClient,
    userId:       "user-123",
    agentId:      "my-agent",
    autoRemember: true);

// Use the wrapped service directly
var result = await memoryService.GetChatMessageContentsAsync(chatHistory);

Dynamic identity

var memoryService = baseService.UseProgressMemory(
    memoryClient,
    getUserId:  () => httpContextAccessor.HttpContext!.User.FindFirst("sub")!.Value,
    getAgentId: () => "my-agent",
    autoRemember: false);

Parameters

Combining both modes

Use the middleware for seamless silent recall and add the plugin for LLM-directed write/delete:

var kernel = Kernel.CreateBuilder()
    .AddOpenAIChatCompletion("gpt-4o", apiKey)
    .AddProgressMemoryPlugin(memoryClient, userId: "user-123", agentId: "my-agent")
    .Build();

var baseService = kernel.GetRequiredService<IChatCompletionService>();
var memoryService = baseService.UseProgressMemory(
    memoryClient, userId: "user-123", agentId: "my-agent");

Conversation threading

Pass a shared ConversationContext instance to link all turns in a session into one conversation resource:

var context = new ConversationContext();

var memoryService = baseService.UseProgressMemory(
    memoryClient,
    userId: "user-123",
    agentId: "my-agent",
    conversationContext: context);

See also

• Progress.Memory — core client and DI registration
• Progress.Memory.Extensions.AI — Microsoft.Extensions.AI integration