microsoft--agent-framework/python/packages/mem0/AGENTS.md

Mem0 Package (agent-framework-mem0)

Integration with Mem0 for agent memory management.

Main Classes

• Mem0ContextProvider - Context provider that integrates Mem0 memory into agents

Usage

from agent_framework.mem0 import Mem0ContextProvider

provider = Mem0ContextProvider(
    api_key="your-key",
    # Storage scope: memories are written with this user_id.
    user_id="user-id",
    # Retrieval scope: must be set explicitly, it never inherits the storage scope.
    search_user_id="user-id",
)

Memory Scoping

• application_id / agent_id / user_id are the storage scope stamped on written memories.
• search_application_id / search_agent_id / search_user_id are the retrieval scope.
• Retrieval scope never defaults to the storage scope. With no search_* value set, before_run retrieves nothing and logs a warning. This prevents memories written under a shared agent_id from being retrieved for every user of that agent.

Import Path

from agent_framework.mem0 import Mem0ContextProvider
# or directly:
from agent_framework_mem0 import Mem0ContextProvider

Notes

Mem0 telemetry is disabled by default. Set MEM0_TELEMETRY=true to enable.