Long-Term Memory
In AgentScope, we provide a basic class for long-term memory (LongTermMemoryBase) and an implementation based on the mem0 library (Mem0LongTermMemory). Together with the design of ReActAgent class in Agent section, we provide two long-term memory modes:
agent_control: the agent autonomously manages long-term memory by tool calls, andstatic_control: the developer explicitly controls long-term memory operations.
Developers can also use the both mode, which activates both memory management modes.
Hint
These memory modes are suitable for different usage scenarios. Developers can choose the appropriate mode based on their needs.
Using mem0 Long-Term Memory
Note
We provide an example of using mem0 long-term memory in the GitHub repository under the examples/long_term_memory/mem0 directory.
import osimport asynciofrom agentscope.message import Msgfrom agentscope.memory import InMemoryMemoryfrom agentscope.agent import ReActAgentfrom agentscope.formatter import DashScopeChatFormatterfrom agentscope.model import DashScopeChatModelfrom agentscope.tool import Toolkit# Create mem0 long-term memory instancefrom agentscope.memory import Mem0LongTermMemoryfrom agentscope.embedding import DashScopeTextEmbeddinglong_term_memory = Mem0LongTermMemory(agent_name="Friday",user_name="user_123",model=DashScopeChatModel(model_name="qwen-max-latest",api_key=os.environ.get("DASHSCOPE_API_KEY"),stream=False,),embedding_model=DashScopeTextEmbedding(model_name="text-embedding-v2",api_key=os.environ.get("DASHSCOPE_API_KEY"),),on_disk=False,)
The Mem0LongTermMemory class provides two main methods for long-term memory operations: record and retrieve. They take a list of messages as input and record/retrieve information from long-term memory.
As an example, we first store a user preference and then retrieve related information from long-term memory.
# Basic usage exampleasync def basic_usage():"""Basic usage example"""# Record memoryawait long_term_memory.record([Msg("user", "I like staying in homestays", "user")],)# Retrieve memoryresults = await long_term_memory.retrieve([Msg("user", "My accommodation preferences", "user")],)print(f"Retrieval results: {results}")asyncio.run(basic_usage())
Retrieval results: Likes staying in homestays
Integration with ReAct Agent
In AgentScope, the ReActAgent class receives a long_term_memory parameter in its constructor, as well as a long_term_memory_mode parameter that specifies the long-term memory mode.
If long_term_memory_mode is set to agent_control or both, two tool functions record_to_memory and retrieve_from_memory will be registered in the agent’s toolkit, allowing the agent to autonomously manage long-term memory through tool calls.
Note
To achieve the best results, the "agent_control" mode may require additional instructions in the system prompt.
# Create ReAct agent with long-term memoryagent = ReActAgent(name="Friday",sys_prompt="You are an assistant with long-term memory capabilities.",model=DashScopeChatModel(api_key=os.environ.get("DASHSCOPE_API_KEY"),model_name="qwen-max-latest",),formatter=DashScopeChatFormatter(),toolkit=Toolkit(),memory=InMemoryMemory(),long_term_memory=long_term_memory,long_term_memory_mode="static_control", # Use static_control mode)async def record_preferences():"""ReAct agent integration example"""# Conversation examplemsg = Msg("user","When I travel to Hangzhou, I like staying in homestays","user",)await agent(msg)asyncio.run(record_preferences())
Friday: When you travel to Hangzhou, staying in homestays can be a wonderful experience. Homestays often provide a more personal and intimate setting, allowing you to immerse yourself in the local culture and lifestyle. You might have the opportunity to interact with the hosts and other travelers, which can enrich your travel experiences. Moreover, homestays are usually more affordable than hotels and can offer unique accommodations that reflect the local charm. Enjoy your stay in Hangzhou's homestays!
Then we clear the short-term memory and ask the agent about the user’s preferences.
async def retrieve_preferences():"""Retrieve user preferences from long-term memory"""# Clear short-term memoryawait agent.memory.clear()# The agent will remember previous conversationsmsg2 = Msg("user", "What are my preferences? Answer briefly.", "user")await agent(msg2)asyncio.run(retrieve_preferences())
Friday: You prefer staying in homestays when traveling to Hangzhou.
Customizing Long-Term Memory
AgentScope provides the LongTermMemoryBase base class, which defines the basic
Developers can inherit from LongTermMemoryBase to implement custom long-term memory systems according to their needs:
Class | Abstract Methods | Description |
|---|---|---|
| recordretrieverecord_to_memoryretrieve_from_memory |
|
| - | Long-term memory implementation based on the mem0 library, supporting vector storage and retrieval. |
Further Reading
Total running time of the script: (0 minutes 31.945 seconds)
Download Jupyter notebook: task_long_term_memory.ipynb
Download Python source code: task_long_term_memory.py