Was macht agent-memory?
Speichere persistentes KI-Agenten-Gedächtnis in Markdown-Dateien mit Suche, Kontextinjektion, Checkpoints und Kompaktierung – keine Datenbank erforderlich
Übersicht
Diese Fähigkeit ermöglicht es AI-Agenten, ein dauerhaftes Gedächtnis zu führen, indem Erinnerungen als strukturierte Markdown-Dateien gespeichert werden. Es bietet eine einfache, dateibasierte Lösung für das Gedächtnismanagement, die ohne externe Datenbanken oder komplexe Infrastruktur auskommt.
Funktionen
- Persistenz: Erinnerungen werden als Markdown-Dateien gespeichert und bleiben über Sitzungen hinweg erhalten
- Suche: Durchsucht Erinnerungen mit Stichworten oder regulären Ausdrücken
- Kontextinjektion: Fügt relevante Erinnerungen automatisch in den System-Prompt des Agenten ein
- Checkpoints: Erstellt Zeitpunkt-Snapshots des Gedächtnisstands
- Kompaktierung: Reduziert die Dateigröße durch Zusammenfassen und Entfernen von Duplikaten
Installation
Fügen Sie die Fähigkeit zu Ihrem Agenten hinzu:
# Beispiel für die Installation (abhängig vom Agenten-Framework)
agent install Defiladeboarfish90/agent-memory
Verwendung
Initialisierung
const memory = new AgentMemory({
path: './memory',
type: 'markdown'
});
Speichern von Erinnerungen
await memory.save({
content: 'Der Benutzer zieht Python für Datenanalyse vor.',
tags: ['präferenz', 'python', 'datenanalyse']
});
Suchen von Erinnerungen
const results = await memory.search('python präferenz');
console.log(results);
// [{ content: 'Der Benutzer zieht Python für Datenanalyse vor.', tags: [...], timestamp: ... }]
Kontextinjektion
const context = await memory.getContext();
// Gibt einen formatierten String mit relevanten Erinnerungen für den System-Prompt zurück
Checkpoints
await memory.createCheckpoint('vor-projekt-start');
// Erstellt einen Snapshot unter ./memory/checkpoints/vor-projekt-start
Kompaktierung
await memory.compact();
// Fasst ähnliche Erinnerungen zusammen und entfernt Duplikate
Dateistruktur
./memory/
├── index.md # Hauptgedächtnisdatei
├── checkpoints/ # Checkpoint-Verzeichnis
│ └── checkpoint-1.md
└── config.json # Konfigurationsdatei
Konfiguration
Erstellen Sie eine config.json im Memory-Verzeichnis:
{
"maxContextLength": 2000,
"searchThreshold": 0.5,
"autoCompact": false
}
API
| Methode | Beschreibung |
|---|---|
save(entry) | Speichert eine neue Erinnerung |
search(query) | Durchsucht Erinnerungen |
getContext() | Gibt relevanten Kontext zurück |
createCheckpoint(name) | Erstellt einen Checkpoint |
compact() | Kompaktiert das Gedächtnis |
clear() | Löscht alle Erinnerungen |
Plattformunterstützung
Diese Fähigkeit ist mit den meisten dateibasierten Agenten-Frameworks kompatibel, einschließlich:
- Claude Code
- Cursor
- Codex CLI
- Benutzerdefinierte Agenten-Implementierungen
Lizenz
MIT