ReMe/reme/tool/memory/add_memory.py

135 lines
4.7 KiB
Python

"""Add memory to vector store"""
from loguru import logger
from .base_memory_tool import BaseMemoryTool
from .memory_handler import MemoryHandler
from ...core.schema import ToolCall
class AddMemory(BaseMemoryTool):
"""Tool to add memories to vector store"""
def __init__(
self,
enable_memory_target: bool = False,
enable_when_to_use: bool = False,
**kwargs,
):
super().__init__(**kwargs)
self.enable_memory_target: bool = enable_memory_target
self.enable_when_to_use: bool = enable_when_to_use
def _build_memory_parameters(self) -> dict:
"""Build the memory parameters schema based on enabled features."""
properties = {
"message_time": {
"type": "string",
"description": "message time, e.g. '2020-01-01 00:00:00'",
},
"memory_content": {
"type": "string",
"description": "content of the memory.",
},
}
required = ["message_time", "memory_content"]
if self.enable_when_to_use:
properties["when_to_use"] = {
"type": "string",
"description": "description of when to use this memory.",
}
required.append("when_to_use")
if self.enable_memory_target:
properties["memory_target"] = {
"type": "string",
"description": "target memory type for this memory.",
}
required.append("memory_target")
return {
"type": "object",
"properties": properties,
"required": required,
}
def _build_tool_call(self) -> ToolCall:
return ToolCall(
**{
"description": "add a memory to vector store for future retrieval.",
"parameters": self._build_memory_parameters(),
},
)
def _build_multiple_tool_call(self) -> ToolCall:
return ToolCall(
**{
"description": "add multiple memories to vector store for future retrieval.",
"parameters": {
"type": "object",
"properties": {
"memories": {
"type": "array",
"description": "list of memories to store.",
"items": self._build_memory_parameters(),
},
},
"required": ["memories"],
},
},
)
async def execute(self):
if self.enable_multiple:
memories = self.context.get("memories", [])
else:
memories = [self.context]
# Group memories by memory_target if enabled
if self.enable_memory_target:
memories_by_target = {}
for mem in memories:
target = mem["memory_target"]
if target not in memories_by_target:
memories_by_target[target] = []
memories_by_target[target].append(mem)
else:
memories_by_target = {self.memory_target: memories}
# Process each memory_target group
all_memory_nodes = []
for target, target_memories in memories_by_target.items():
# Parse and prepare memory data
memory_dicts = []
for mem in target_memories:
memory_content = mem.get("memory_content", "")
message_time = mem.get("message_time", "")
when_to_use = mem.get("when_to_use", "") if self.enable_when_to_use else ""
metadata = {}
try:
metadata["time_int"] = int(message_time.split(" ")[0].replace("-", ""))
except Exception:
logger.warning(f"Invalid message time format: {message_time}")
memory_dicts.append({
"content": memory_content,
"when_to_use": when_to_use,
"message_time": message_time,
"ref_memory_id": self.history_id,
"author": self.author,
"metadata": metadata,
})
if memory_dicts:
handler = MemoryHandler(target, self.service_context)
memory_nodes = await handler.add_batch(memory_dicts)
all_memory_nodes.extend(memory_nodes)
if not all_memory_nodes:
return "No valid memories provided."
self.memory_nodes.extend(all_memory_nodes)
output = f"Successfully added {len(all_memory_nodes)} memories."
logger.info(output)
return output