{"id":1636,"date":"2025-11-25T08:00:48","date_gmt":"2025-11-25T16:00:48","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/foundry\/?p=1636"},"modified":"2026-01-21T10:53:17","modified_gmt":"2026-01-21T18:53:17","slug":"introducing-memory-in-foundry-agent-service","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/foundry\/introducing-memory-in-foundry-agent-service\/","title":{"rendered":"Introducing Memory in Foundry Agent Service"},"content":{"rendered":"

Give your agents the power to remember<\/span>\u00a0<\/span><\/h2>\n

Imagine your agent never asks the same question twice. Until now, most agents have been <\/span>stateless. Each conversation resets to zero, forgetting what users said just minutes ago or weeks ago. Developers tried to bridge this gap with homegrown solutions \u2014 storing embeddings in databases, manually retrieving prior messages, or stuffing entire chat histories into prompts. These workarounds add latency, cost, and complexity, and still fall short of delivering truly personal, context-aware interactions.<\/span>\u00a0<\/span><\/p>\n

At Ignite 2025, we introduced the <\/span>public preview of <\/span><\/b>m<\/span><\/b>emory <\/span><\/b>in<\/span><\/b>\u00a0Foundry Agent Service<\/span><\/b>\u00a0\u2014 a fully managed, long-term memory store natively integrated with our agent service. Memory empowers developers to seamlessly store, retrieve, and manage chat summaries, user preferences and critical context across sessions, devices, and workflows. With secure, high-quality memory, agents can deliver richer, more personalized experiences out-of-the-box. This unlocks more natural interactions and sustained engagement across your applications.<\/span>\u00a0<\/span><\/p>\n

Developer-first: fast prototyping to enterprise scale<\/span>\u00a0<\/span><\/h2>\n

Start fast, scale seamlessly:<\/strong> Build a prototype in minutes with out-of-the-box configuration, then scale easily to support millions of users and memories as your needs grow.<\/span>\u00a0<\/span><\/p>\n

State-of-the-art quality:<\/strong> Memory in Foundry Agent Service delivers outstanding performance from day one. We continually develop and apply the latest state-of-the-art techniques, so your agents benefit from the latest advances in memory retrieval, relevance, and personalization.\u00a0<\/span>\u00a0<\/span><\/p>\n

Unified API, flexible backends:<\/strong> Use a unified interface to access your Foundry\u2019s managed service or bring your own storage in the future. You get advanced retrieval, memory extraction, and consolidation \u2014 without added complexity.\u00a0<\/span>\u00a0<\/span><\/p>\n

\"Foundry<\/a><\/p>\n

In the Foundry portal, you can enable the memory feature with a single click. A memory store will be automatically created and configured for your agent. For advanced configurations or customizations, you can leverage our APIs and SDKs to get started.<\/p>\n

 <\/p>\n

# Python sample\r\n# Create a memory store \r\nmemory_store_name = \"my_memory_store\" \r\ndefinition = MemoryStoreDefaultDefinition( \r\n    chat_model=\"gpt-4.1\", \r\n    embedding_model=\"text-embedding-3-small\", \r\n    options=MemoryStoreDefaultOptions( \r\n        user_profile_enabled=True,  \r\n        user_profile_details=\"Food preferences for a meal planning agent\", \r\n        chat_summary_enabled=True \r\n    ), \r\n) \r\n\r\nmemory_store = project_client.memory_stores.create( \r\n    name=memory_store_name, \r\n    description=\"Example memory store for conversations\", \r\n    definition=definition, \r\n) \r\n \r\n\r\n# Add memories to the memory store \r\nscope = \"user123\" \r\nuser_message = ResponsesUserMessageItemParam( \r\n    content=\"I prefer dark roast coffee and usually drink it in the morning\" \r\n) \r\nupdate_poller = project_client.memory_stores.begin_update_memories( \r\n    name=memory_store.name, \r\n    scope=scope, \r\n    items=[user_message],  \r\n    update_delay=0, \r\n) \r\n\r\nupdate_result = update_poller.result() \r\n\r\n# Retrieve memories from the memory store \r\nquery_message = ResponsesUserMessageItemParam(content=\"What are my coffee preferences?\") \r\nsearch_response = project_client.memory_stores.search_memories( \r\n    name=memory_store.name, \r\n    scope=scope, \r\n    items=[query_message], \r\n    options=MemorySearchOptions(max_memories=5), \r\n)<\/span> \r\n\r\n# Retrieve user profiles, typically you only need to call this once\r\nsearch_response = project_client.memory_stores.search_memories( \r\n    name=memory_store.name, \r\n    scope=scope\r\n)<\/span> <\/code><\/pre>\n
Memory behind the scenes<\/span>\u00a0<\/span><\/h2>\n
The memory in Foundry Agent Service enables agents to deliver seamless, context-rich experiences by managing memory in several phases for optimal performance:\u00a0<\/span>\u00a0<\/span><\/p>\n
    \n
  1.  Extract what matters: <\/span><\/b>When a user interacts with an agent, the system actively extracts key information such as user preferences, facts, and relevant context from the conversation. For example, preferences like \u201callergic to dairy\u201d and facts about recent activities are identified and stored.<\/span><\/li>\n
  2.  Consolidate to keep things clean<\/span><\/b>: Extracted memories are consolidated to keep the memory store efficient and relevant. We use LLMs to merge similar or duplicate topics, so the agent doesn\u2019t store redundant information. Conflicting facts are detected (e.g., a new allergy) are resolved to maintain a single, accurate memory.<\/span><\/li>\n
  3.  Retrieve where needed:<\/span><\/b> When the agent needs to recall information, it uses hybrid search techniques to find the most relevant memories. This allows the agent to quickly surface the right context, making conversations feel natural and informed. Core memories (like allergies, favorite products, or recurring requests) are retrieved at the beginning of a conversation, so the agent is immediately aware of the user\u2019s core needs.<\/span><\/li>\n
  4.  Customize the memory for your use case: <\/span><\/b>Developers can guide the memory store using the <\/span>user_profile_details<\/span> parameter to specify important topics. The system translates these cues into instructions for the underlying model, shaping how memory extraction, consolidation, and retrieval are performed. This flexibility ensures agents to focus on what matters most for your application.<\/span><\/li>\n<\/ol>\n
    Here is an example of how memory can improve and personalize integration between a recipe agent and a user who expressed a food allergy in the past.\u00a0<\/span>\u00a0<\/span><\/p>\n
    Our approach to quality<\/span>\u00a0<\/span><\/h2>\n
    When building memory in the Foundry Agent Service, we use rigorous techniques to deliver the best quality and performance. We rely on precise evaluation frameworks and iterative refinement to ensure that memory persistence and retrieval meet the highest standards. While we recognize that many existing public benchmark datasets have limitations, we address these by curating datasets that test different aspects of memory, from semantic fact recall to user preferences, and applying the resulting knowledge about the user to new situations.<\/span>\u00a0<\/span><\/p>\n
    Our memory systematically extracts both user profile information and chat summaries from conversation histories. This approach preserves key information and details from past conversations, striving for faithfulness to the original contexts.<\/span>\u00a0<\/span><\/p>\n
    At its core, memory personalizes and streamlines interactions with agents, making conversations more natural and effective. Our evaluations measure the end-to-end quality of agents equipped with memory compared to those without \u2014 focusing on real-world scenarios. In recent tests, agents with memory in Foundry Agent Service achieved state-of-the-art and competitive performance on common memory benchmarks.<\/span>\u00a0<\/span><\/p>\n
    The memory space is evolving rapidly, and we are committed to pushing the boundary. We continuously invest in research, experimentation, and feedback-driven improvements.<\/span>\u00a0<\/span><\/p>\n
     <\/p>\n
    \"quality<\/a><\/p>\n
    * Accuracies are macro-averages<\/span><\/p>\n
    * All results reported using text-embedding-3-small\u00a0<\/span><\/p>\n
    Get Started<\/span>\u00a0<\/span><\/h2>\n
    Memory in Foundry Agent Service is now in public preview. Whether you\u2019re building your first agent or scaling to thousands, you can start prototyping today.\u00a0<\/span>\u00a0<\/span><\/p>\n
    \"How<\/a><\/p>\n