from typing import Optional import time from pydantic import PrivateAttr from crewai.memory.entity.entity_memory_item import EntityMemoryItem from crewai.memory.memory import Memory from crewai.memory.storage.rag_storage import RAGStorage from crewai.utilities.events.crewai_event_bus import crewai_event_bus from crewai.utilities.events.memory_events import ( MemoryQueryStartedEvent, MemoryQueryCompletedEvent, MemoryQueryFailedEvent, MemorySaveStartedEvent, MemorySaveCompletedEvent, MemorySaveFailedEvent, ) class EntityMemory(Memory): """ EntityMemory class for managing structured information about entities and their relationships using SQLite storage. Inherits from the Memory class. """ _memory_provider: Optional[str] = PrivateAttr() def __init__(self, crew=None, embedder_config=None, storage=None, path=None): if crew and hasattr(crew, "memory_config") and crew.memory_config is not None: memory_provider = crew.memory_config.get("provider") else: memory_provider = None if memory_provider == "mem0": try: from crewai.memory.storage.mem0_storage import Mem0Storage except ImportError: raise ImportError( "Mem0 is not installed. Please install it with `pip install mem0ai`." ) storage = Mem0Storage(type="entities", crew=crew) else: storage = ( storage if storage else RAGStorage( type="entities", allow_reset=True, embedder_config=embedder_config, crew=crew, path=path, ) ) super().__init__(storage=storage) self._memory_provider = memory_provider def save(self, item: EntityMemoryItem) -> None: # type: ignore # BUG?: Signature of "save" incompatible with supertype "Memory" """Saves an entity item into the SQLite storage.""" crewai_event_bus.emit( self, event=MemorySaveStartedEvent( metadata=item.metadata, source_type="entity_memory", ), ) start_time = time.time() try: if self._memory_provider == "mem0": data = f""" Remember details about the following entity: Name: {item.name} Type: {item.type} Entity Description: {item.description} """ else: data = f"{item.name}({item.type}): {item.description}" super().save(data, item.metadata) # Emit memory save completed event crewai_event_bus.emit( self, event=MemorySaveCompletedEvent( value=data, metadata=item.metadata, save_time_ms=(time.time() - start_time) * 1000, source_type="entity_memory", ), ) except Exception as e: crewai_event_bus.emit( self, event=MemorySaveFailedEvent( metadata=item.metadata, error=str(e), source_type="entity_memory", ), ) raise def search( self, query: str, limit: int = 3, score_threshold: float = 0.35, ): crewai_event_bus.emit( self, event=MemoryQueryStartedEvent( query=query, limit=limit, score_threshold=score_threshold, source_type="entity_memory", ), ) start_time = time.time() try: results = super().search( query=query, limit=limit, score_threshold=score_threshold ) crewai_event_bus.emit( self, event=MemoryQueryCompletedEvent( query=query, results=results, limit=limit, score_threshold=score_threshold, query_time_ms=(time.time() - start_time) * 1000, source_type="entity_memory", ), ) return results except Exception as e: crewai_event_bus.emit( self, event=MemoryQueryFailedEvent( query=query, limit=limit, score_threshold=score_threshold, error=str(e), source_type="entity_memory", ), ) raise def reset(self) -> None: try: self.storage.reset() except Exception as e: raise Exception(f"An error occurred while resetting the entity memory: {e}")