Framework for orchestrating role-playing, autonomous AI agents. By fostering collaborative intelligence, CrewAI empowers agents to work together seamlessly, tackling complex tasks.
feat: add console logging for memory system usage (#3103)
Lucas Gomideae57e5723c99
diff --git a/src/crewai/utilities/events/event_listener.py b/src/crewai/utilities/events/event_listener.pyindex 7be6b9bb0..a7cf82d9b 100644--- a/src/crewai/utilities/events/event_listener.py+++ b/src/crewai/utilities/events/event_listener.py@@ -65,6 +65,8 @@ from .reasoning_events import (AgentReasoningFailedEvent,)+from .listeners.memory_listener import MemoryListener+class EventListener(BaseEventListener):_instance = None@@ -91,6 +93,8 @@ class EventListener(BaseEventListener):self._initialized = Trueself.formatter = ConsoleFormatter(verbose=True)+ MemoryListener(formatter=self.formatter)+# ----------- CREW EVENTS -----------def setup_listeners(self, crewai_event_bus):diff --git a/src/crewai/utilities/events/listeners/memory_listener.py b/src/crewai/utilities/events/listeners/memory_listener.pynew file mode 100644index 000000000..82935a3b7--- /dev/null+++ b/src/crewai/utilities/events/listeners/memory_listener.py@@ -0,0 +1,110 @@+from crewai.utilities.events.base_event_listener import BaseEventListener+from crewai.utilities.events.memory_events import (+ MemoryRetrievalCompletedEvent,+ MemoryRetrievalStartedEvent,+ MemoryQueryFailedEvent,+ MemoryQueryCompletedEvent,+ MemorySaveStartedEvent,+ MemorySaveCompletedEvent,+ MemorySaveFailedEvent,+)++class MemoryListener(BaseEventListener):++ def __init__(self, formatter):+ super().__init__()+ self.formatter = formatter+ self.memory_retrieval_in_progress = False+ self.memory_save_in_progress = False++ def setup_listeners(self, crewai_event_bus):+ @crewai_event_bus.on(MemoryRetrievalStartedEvent)+ def on_memory_retrieval_started(+ source, event: MemoryRetrievalStartedEvent+ ):+ if self.memory_retrieval_in_progress:+ return++ self.memory_retrieval_in_progress = True++ self.formatter.handle_memory_retrieval_started(+ self.formatter.current_agent_branch,+ self.formatter.current_crew_tree,+ )++ @crewai_event_bus.on(MemoryRetrievalCompletedEvent)+ def on_memory_retrieval_completed(+ source, event: MemoryRetrievalCompletedEvent+ ):+ if not self.memory_retrieval_in_progress:+ return++ self.memory_retrieval_in_progress = False+ self.formatter.handle_memory_retrieval_completed(+ self.formatter.current_agent_branch,+ self.formatter.current_crew_tree,+ event.memory_content,+ event.retrieval_time_ms+ )++ @crewai_event_bus.on(MemoryQueryCompletedEvent)+ def on_memory_query_completed(source, event: MemoryQueryCompletedEvent):+ if not self.memory_retrieval_in_progress:+ return++ self.formatter.handle_memory_query_completed(+ self.formatter.current_agent_branch,+ event.source_type,+ event.query_time_ms,+ self.formatter.current_crew_tree,+ )++ @crewai_event_bus.on(MemoryQueryFailedEvent)+ def on_memory_query_failed(source, event: MemoryQueryFailedEvent):+ if not self.memory_retrieval_in_progress:+ return++ self.formatter.handle_memory_query_failed(+ self.formatter.current_agent_branch,+ self.formatter.current_crew_tree,+ event.error,+ event.source_type,+ )++ @crewai_event_bus.on(MemorySaveStartedEvent)+ def on_memory_save_started(source, event: MemorySaveStartedEvent):+ if self.memory_save_in_progress:+ return++ self.memory_save_in_progress = True++ self.formatter.handle_memory_save_started(+ self.formatter.current_agent_branch,+ self.formatter.current_crew_tree,+ )++ @crewai_event_bus.on(MemorySaveCompletedEvent)+ def on_memory_save_completed(source, event: MemorySaveCompletedEvent):+ if not self.memory_save_in_progress:+ return++ self.memory_save_in_progress = False++ self.formatter.handle_memory_save_completed(+ self.formatter.current_agent_branch,+ self.formatter.current_crew_tree,+ event.save_time_ms,+ event.source_type,+ )++ @crewai_event_bus.on(MemorySaveFailedEvent)+ def on_memory_save_failed(source, event: MemorySaveFailedEvent):+ if not self.memory_save_in_progress:+ return++ self.formatter.handle_memory_save_failed(+ self.formatter.current_agent_branch,+ event.error,+ event.source_type,+ self.formatter.current_crew_tree,+ )\ No newline at end of filediff --git a/src/crewai/utilities/events/utils/console_formatter.py b/src/crewai/utilities/events/utils/console_formatter.pyindex ccf1837cc..901c74468 100644--- a/src/crewai/utilities/events/utils/console_formatter.py+++ b/src/crewai/utilities/events/utils/console_formatter.py@@ -1454,3 +1454,250 @@ class ConsoleFormatter:)self.print(finish_panel)self.print()++ def handle_memory_retrieval_started(+ self,+ agent_branch: Optional[Tree],+ crew_tree: Optional[Tree],+ ) -> Optional[Tree]:+ if not self.verbose:+ return None++ branch_to_use = agent_branch or self.current_lite_agent_branch+ tree_to_use = branch_to_use or crew_tree++ if branch_to_use is None or tree_to_use is None:+ if crew_tree is not None:+ branch_to_use = tree_to_use = crew_tree+ else:+ return None++ memory_branch = branch_to_use.add("")+ self.update_tree_label(+ memory_branch, "🧠", "Memory Retrieval Started", "blue"+ )++ self.print(tree_to_use)+ self.print()+ return memory_branch++ def handle_memory_retrieval_completed(+ self,+ agent_branch: Optional[Tree],+ crew_tree: Optional[Tree],+ memory_content: str,+ retrieval_time_ms: float,+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = self.current_lite_agent_branch or agent_branch+ tree_to_use = branch_to_use or crew_tree++ if branch_to_use is None and tree_to_use is not None:+ branch_to_use = tree_to_use++ def add_panel():+ memory_text = str(memory_content)+ if len(memory_text) > 500:+ memory_text = memory_text[:497] + "..."++ memory_panel = Panel(+ Text(memory_text, style="white"),+ title="🧠 Retrieved Memory",+ subtitle=f"Retrieval Time: {retrieval_time_ms:.2f}ms",+ border_style="green",+ padding=(1, 2),+ )+ self.print(memory_panel)+ self.print()++ if branch_to_use is None or tree_to_use is None:+ add_panel()+ return None++ memory_branch_found = False+ for child in branch_to_use.children:+ if "Memory Retrieval Started" in str(child.label):+ self.update_tree_label(+ child, "✅", "Memory Retrieval Completed", "green"+ )+ memory_branch_found = True+ break++ if not memory_branch_found:+ for child in branch_to_use.children:+ if (+ "Memory Retrieval" in str(child.label)+ and "Started" not in str(child.label)+ and "Completed" not in str(child.label)+ ):+ self.update_tree_label(+ child, "✅", "Memory Retrieval Completed", "green"+ )+ memory_branch_found = True+ break++ if not memory_branch_found:+ memory_branch = branch_to_use.add("")+ self.update_tree_label(+ memory_branch, "✅", "Memory Retrieval Completed", "green"+ )++ self.print(tree_to_use)++ if memory_content:+ add_panel()+++ def handle_memory_query_completed(+ self,+ agent_branch: Optional[Tree],+ source_type: str,+ query_time_ms: float,+ crew_tree: Optional[Tree],+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = self.current_lite_agent_branch or agent_branch+ tree_to_use = branch_to_use or crew_tree++ if branch_to_use is None and tree_to_use is not None:+ branch_to_use = tree_to_use++ if branch_to_use is None:+ return None++ memory_type = source_type.replace("_", " ").title()++ for child in branch_to_use.children:+ if "Memory Retrieval" in str(child.label):+ for child in child.children:+ sources_branch = child+ if "Sources Used" in str(child.label):+ sources_branch.add(f"✅ {memory_type} ({query_time_ms:.2f}ms)")+ break+ else:+ sources_branch = child.add("Sources Used")+ sources_branch.add(f"✅ {memory_type} ({query_time_ms:.2f}ms)")+ break++ def handle_memory_query_failed(+ self,+ agent_branch: Optional[Tree],+ crew_tree: Optional[Tree],+ error: str,+ source_type: str,+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = self.current_lite_agent_branch or agent_branch+ tree_to_use = branch_to_use or crew_tree++ if branch_to_use is None and tree_to_use is not None:+ branch_to_use = tree_to_use++ if branch_to_use is None:+ return None++ memory_type = source_type.replace("_", " ").title()++ for child in branch_to_use.children:+ if "Memory Retrieval" in str(child.label):+ for child in child.children:+ sources_branch = child+ if "Sources Used" in str(child.label):+ sources_branch.add(f"❌ {memory_type} - Error: {error}")+ break+ else:+ sources_branch = child.add("🧠 Sources Used")+ sources_branch.add(f"❌ {memory_type} - Error: {error}")+ break+++ def handle_memory_save_started(+ self,+ agent_branch: Optional[Tree],+ crew_tree: Optional[Tree]+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = agent_branch or self.current_lite_agent_branch+ tree_to_use = branch_to_use or crew_tree++ if tree_to_use is None:+ return None++ for child in tree_to_use.children:+ if "Memory Update" in str(child.label):+ break+ else:+ memory_branch = tree_to_use.add("")+ self.update_tree_label(+ memory_branch, "🧠", "Memory Update Overall", "white"+ )++ self.print(tree_to_use)+ self.print()++ def handle_memory_save_completed(+ self,+ agent_branch: Optional[Tree],+ crew_tree: Optional[Tree],+ save_time_ms: float,+ source_type: str,+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = agent_branch or self.current_lite_agent_branch+ tree_to_use = branch_to_use or crew_tree++ if tree_to_use is None:+ return None++ memory_type = source_type.replace("_", " ").title()+ content = f"✅ {memory_type} Memory Saved ({save_time_ms:.2f}ms)"++ for child in tree_to_use.children:+ if "Memory Update" in str(child.label):+ child.add(content)+ break+ else:+ memory_branch = tree_to_use.add("")+ memory_branch.add(content)++ self.print(tree_to_use)+ self.print()++ def handle_memory_save_failed(+ self,+ agent_branch: Optional[Tree],+ error: str,+ source_type: str,+ crew_tree: Optional[Tree],+ ) -> None:+ if not self.verbose:+ return None++ branch_to_use = agent_branch or self.current_lite_agent_branch+ tree_to_use = branch_to_use or crew_tree++ if branch_to_use is None or tree_to_use is None:+ return None++ memory_type = source_type.replace("_", " ").title()+ content = f"❌ {memory_type} Memory Save Failed"+ for child in branch_to_use.children:+ if "Memory Update" in str(child.label):+ child.add(content)+ break+ else:+ memory_branch = branch_to_use.add("")+ memory_branch.add(content)++ self.print(tree_to_use)+ self.print()\ No newline at end of file