FileMemoryProvider Class

Definition

public sealed class FileMemoryProvider : Microsoft.Agents.AI.AIContextProvider, IDisposable

type FileMemoryProvider = class
    inherit AIContextProvider
    interface IDisposable

Public NotInheritable Class FileMemoryProvider
Inherits AIContextProvider
Implements IDisposable

Inheritance

Object

AIContextProvider

FileMemoryProvider

Implements

IDisposable

Remarks

The FileMemoryProvider enables agents to persist information across interactions using a file-based storage model. Each memory is stored as an individual file with a meaningful name. For large files, a companion description file (suffixed with _description.md) can be stored alongside the main file to provide a summary.

File access is mediated through a AgentFileStore abstraction, allowing pluggable backends (in-memory, local file system, remote blob storage, etc.).

This provider exposes the following tools to the agent:

• file_memory_write — Write a memory file with the given name, content, and an optional description.
• file_memory_read — Read the content of a file by name.
• file_memory_delete — Delete a file by name.
• file_memory_ls — List all files with their descriptions (if available).
• file_memory_grep — Search file contents using a regular expression pattern.
• file_memory_replace — Replace occurrences of a substring within a memory file.
• file_memory_replace_lines — Replace whole lines within a memory file.