MemoryRecord
BaseMessage
OpenAIBackendRole
)from_dict()
: Build from a Python dictto_dict()
: Convert to dict for saving/serializationto_openai_message()
: Transform into an OpenAI message objectContextRecord
AgentMemory
, scored for context relevance.Attributes:MemoryRecord
MemoryBlock (Abstract Base Class)
write_records()
: Store multiple recordswrite_record()
: Store a single recordclear()
: Remove all stored recordsBaseContextCreator (Abstract Base Class)
token_counter
: Counts message tokenstoken_limit
: Max allowed tokens in the contextcreate_context()
: Algorithm for building context from chat historyAgentMemory (Abstract Base Class)
MemoryBlock
for direct agent use.Key methods:retrieve()
: Get ContextRecord
listget_context_creator()
: Return the associated context creatorget_context()
: Return properly sized chat contextChatHistoryBlock
storage
: Optional (default InMemoryKeyValueStorage
)keep_rate
: Historical message score weighting (default 0.9
)retrieve()
: Get recent chats (windowed)write_records()
: Add new recordsclear()
: Remove all chat historyVectorDBBlock
storage
: Optional vector DB (QdrantStorage
by default)embedding
: Embedding model (default: OpenAIEmbedding
)retrieve()
: Get similar records based on query/keywordwrite_records()
: Add new records (converted to vectors)clear()
: Remove all vector recordsChatHistoryBlock
.context_creator
: BaseContextCreator
storage
: Optional BaseKeyValueStorage
window_size
: Optional int
(retrieval window)retrieve()
: Get recent chat messageswrite_records()
: Write new records to chat historyget_context_creator()
: Get the context creatorclear()
: Remove all chat messagesVectorDBBlock
.context_creator
: BaseContextCreator
storage
: Optional BaseVectorStorage
retrieve_limit
: int
(default 3
)retrieve()
: Get relevant messages from the vector DBwrite_records()
: Write new records and update topicget_context_creator()
: Get the context creatorcontext_creator
: BaseContextCreator
chat_history_block
: Optional ChatHistoryBlock
vector_db_block
: Optional VectorDBBlock
retrieve_limit
: int
(default 3
)retrieve()
: Get context from both history & vector DBwrite_records()
: Write to both chat history & vector DBget_context_creator()
: Get the context creatorclear()
: Remove all records from both memory blocksapi_key
: (optional) Mem0 API authenticationagent_id
: (optional) Agent associationuser_id
: (optional) User associationmetadata
: (optional) Dict of metadata for all memoriesBaseContextCreator
for advanced control.