agents.memory_v2.multi_memory_coordinator¶

Multi-Memory Agent Coordinator - Orchestrates all memory systems.

This is the top-level coordinator that manages all memory agents: - SimpleMemoryAgent (pre-hook system) - ReactMemoryAgent (tool-based memory) - LongTermMemoryAgent (persistent memory) - GraphMemoryAgent (structured knowledge) - AdvancedRAGMemoryAgent (multi-stage retrieval)

The coordinator intelligently routes operations to the most appropriate memory system and can combine results from multiple systems.

Classes¶

`CoordinationMode`	Memory coordination modes.
`MemorySystemType`	Available memory system types.
`MultiMemoryConfig`	Configuration for Multi-Memory Coordinator.
`MultiMemoryCoordinator`	Coordinates multiple memory systems for comprehensive memory management.

Functions¶

demo_multi_memory_coordinator()

Demonstrate the multi-memory coordinator.

Module Contents¶

class agents.memory_v2.multi_memory_coordinator.CoordinationMode¶

Bases: str, enum.Enum

Memory coordination modes.

Initialize self. See help(type(self)) for accurate signature.

class agents.memory_v2.multi_memory_coordinator.MemorySystemType¶

Bases: str, enum.Enum

Available memory system types.

Initialize self. See help(type(self)) for accurate signature.

class agents.memory_v2.multi_memory_coordinator.MultiMemoryConfig¶: Configuration for Multi-Memory Coordinator.

class agents.memory_v2.multi_memory_coordinator.MultiMemoryCoordinator(config)¶

Coordinates multiple memory systems for comprehensive memory management.

This coordinator provides: - Intelligent routing to appropriate memory systems - Parallel querying across multiple systems - Result combination and synthesis - Memory system analytics and optimization - Cross-system memory migration

Init .

Parameters:: config (MultiMemoryConfig) – [TODO: Add description]

classmethod create_comprehensive_system(user_id, enable_graph=False, neo4j_config=None, storage_path=None)¶

Create a comprehensive memory system with all components.

Parameters:

user_id (str)
enable_graph (bool)
neo4j_config (dict[str, Any] | None)
storage_path (str | None)

Return type:

MultiMemoryCoordinator

async get_system_analytics()¶

Get analytics across all memory systems.

Return type:: dict[str, Any]

async migrate_memories(from_system, to_system, filter_criteria=None)¶

Migrate memories between systems.

Parameters:

from_system (MemorySystemType)
to_system (MemorySystemType)
filter_criteria (dict[str, Any] | None)

Return type:

dict[str, Any]

async query_memory(query, systems=None, mode=None, combine_results=True)¶

Query memory across systems.

Parameters:

query (str) – Query string
systems (list[MemorySystemType] | None) – Specific systems to query
mode (CoordinationMode | None) – Coordination mode
combine_results (bool) – Whether to combine results

Returns:

Query results

Return type:

dict[str, Any]

async store_memory(content, systems=None, mode=None, metadata=None, importance='normal')¶

Store memory across appropriate systems.

Parameters:

content (str) – Memory content to store
systems (list[MemorySystemType] | None) – Specific systems to use (None for intelligent routing)
mode (CoordinationMode | None) – Coordination mode
metadata (dict[str, Any] | None) – Optional metadata
importance (str) – Importance level

Returns:

Storage results from all used systems

Return type:

dict[str, Any]

async agents.memory_v2.multi_memory_coordinator.demo_multi_memory_coordinator()¶: Demonstrate the multi-memory coordinator.