mirror of
https://github.com/agent0ai/agent-zero.git
synced 2026-11-18 22:36:29 +00:00
Initialize the scheduler store before snapshots. Preserve legacy memory calls and per-action permissions while advertising the unified tool, and retain saved policy IDs for moved tools. Restore legacy log rendering and connector tool events, and reject malformed boolean arguments by default.
2.2 KiB
2.2 KiB
Memory
Provide persistent vector-based memory and knowledge retrieval for Agent Zero.
What It Does
This plugin stores memories and knowledge embeddings in a FAISS-backed vector database, exposes tools for saving and recalling memories, and provides APIs and UI support for browsing, importing, updating, and deleting memory entries.
Main Behavior
- Persistent vector store
- Creates and loads FAISS indexes per memory subdirectory.
- Stores embedding metadata so the index can be rebuilt if the embedding model changes.
- Knowledge preloading
- Loads configured knowledge directories into memory when a database is initialized.
- Memory tools
- Uses one
memorytool withload,save,delete, andforgetactions. - Old
memory_load,memory_save,memory_delete, andmemory_forgetcalls use the same implementation. Existing action permissions remain effective; permission to load memory does not grant permission to delete it.
- Uses one
- Automatic conversation memory
- Stores durable preferences, project facts, and recurring constraints while filtering transient action-history fragments before insertion.
- Dashboard APIs
- Exposes search, delete, bulk delete, update, and subdirectory listing endpoints for the memory dashboard.
- Scoped storage
- Supports different memory subdirectories so memory can be separated by context or agent scope.
Key Files
- Core memory engine
helpers/memory.pyimplements FAISS storage, index loading, embedding configuration, and knowledge preload.
- Knowledge import
helpers/knowledge_import.pyimports external knowledge into memory storage.
- Consolidation
helpers/memory_consolidation.pycontains memory consolidation logic.
- Tools
tools/memory.py(single tool,actionselects load, save, delete or forget)
- API
api/memory_dashboard.pypowers the memory management dashboard.api/import_knowledge.pyandapi/knowledge_reindex.pyhandle knowledge import and reindexing.
Configuration Scope
- Settings section:
agent - Per-project config:
true - Per-agent config:
true
Plugin Metadata
- Name:
_memory - Title:
Memory - Description: Provides persistent memory capabilities to Agent Zero agents.