pumaDB

pumaDB – Die fortschrittliche Memory-Layer für KI-Agenten

KI-Agenten haben oft ein Problem: Sie vergessen. Sobald eine Sitzung endet oder das Kontextfenster überschritten wird, gehen wertvolle Informationen verloren. Hier setzt pumaDB an. Als spezialisierte Memory-Layer für Agenten bietet pumaDB ein dauerhaftes Gedächtnis, ohne dass Nutzer sich mit der Komplexität herkömmlicher Datenbanken auseinandersetzen müssen. Ob über einen gehosteten MCP-Server oder eine serverseitige REST-API – pumaDB stellt sicher, dass Ihre Agenten sich an wichtige Details erinnern.

Was ist pumaDB?

pumaDB ist eine leichtgewichtige Speicherschicht, die speziell für die Anforderungen moderner KI-Agenten entwickelt wurde. Das Motto lautet: „Agents forget. pumaDB remembers.“ Es fungiert als externer Speicherplatz für JSON-Datensätze, auf den Agenten in Echtzeit zugreifen können.

Anstatt mühsam eigene Datenbankprojekte aufzusetzen, können Entwickler und KI-Nutzer pumaDB innerhalb von Sekunden einrichten. Die Plattform ermöglicht es, Informationen in Form von JSON-Zeilen zu speichern und zu verwalten. Dadurch können Agenten Fakten, Zustände und Präferenzen über verschiedene Sitzungen hinweg beibehalten, was die Effizienz und Personalisierung von KI-Interaktionen massiv steigert.

Die wichtigsten Features von pumaDB

pumaDB zeichnet sich durch eine Reihe von Funktionen aus, die speziell auf die Arbeit mit LLMs (Large Language Models) zugeschnitten sind:

1. Hosted MCP & Server-Side API

pumaDB bietet zwei primäre Wege der Integration:

• Hosted MCP (Model Context Protocol): Ideal für Agenten-Clients wie Codex, ChatGPT oder Claude. Dank OAuth-Unterstützung und dynamischer Client-Registrierung ist die Anbindung sicher und schnell.
• REST-API: Für serverseitige Anwendungen steht eine robuste API zur Verfügung, die einfach über HTTP-Requests angesprochen werden kann.

2. Typed Safe Memory

Der Speicher ist für kleine, dauerhafte JSON-Datensätze optimiert. Das System nutzt ein konsolidiertes remember MCP Tool, um gängige Speichertypen sicher ablegen zu können. Dies schließt Metadaten ein, die für eine inerte und sichere Datenverarbeitung sorgen.

3. Safety Rails (Sicherheitsvorkehrungen)

Um die Stabilität und Übersichtlichkeit zu gewährleisten, verfügt pumaDB über integrierte Limits:

• Tabellen-Limits: Klare Strukturierung der Daten.
• Rate-Limits: Schutz vor Überlastung durch fest definierte Schreib- und Lesegrenzen.
• Versionierung: Jede Änderung oder Löschung wird archiviert. Die letzten 10 Versionen eines Datensatzes bleiben 30 Tage lang erhalten und können bei Bedarf wiederhergestellt werden.

4. Natural Edits

Agenten können Aktualisierungen in natürlicher Sprache anfordern. Beispielsweise versteht das System Befehle wie „Merke dir, dass ich kurze PR-Zusammenfassungen bevorzuge“ und setzt dies in präzise gefilterte Updates um, ohne Duplikate zu erzeugen.

Wie man pumaDB verwendet (How to Use)

Die Einrichtung von pumaDB ist denkbar einfach und erfolgt in wenigen Schritten:

Einrichtung über Hosted MCP

Verbinden Sie Ihren bevorzugten Client (z. B. ChatGPT oder Claude) mit dem Streamable HTTP MCP-Endpunkt: https://api.pumadb.ai/mcp

Nach der Autorisierung via OAuth kann der Agent direkt auf Tools wie add, query oder remember zugreifen.

Verwendung der Server-Side API

Für Backend-Umgebungen oder Serverless-Funktionen nutzen Sie einen API-Key (puma_live_*) und rufen die Endpunkte direkt auf:

• Basis-URL: https://api.pumadb.ai
• Wichtiger Hinweis: API-Keys dürfen niemals in Client-seitigem Code (wie React-Bundles oder mobilen Apps) hinterlegt werden, sondern nur in geschützten Serverumgebungen.

Tools und Befehle

Agenten können eine Vielzahl von Befehlen nutzen, um den Speicher zu verwalten:

• remember: Der primäre Befehl für neue, typisierte Speicher-Einträge.
• query: Zum Suchen und Abrufen von Informationen.
• update_where: Gezielte Aktualisierung vorhandener Daten.
• restore: Wiederherstellung früherer Versionen eines Datensatzes.

Typische Use Cases (Anwendungsbereiche)

pumaDB ist vielseitig einsetzbar. Hier sind die gängigsten Szenarien:

• User Preferences: Speichern Sie Kommunikationsstile, Formatierungsvorgaben oder Review-Erwartungen, die auf eine Person oder einen Workspace zugeschnitten sind.
• Project Conventions: Hinterlegen Sie Repository-Fakten, Architektur-Notizen, Namenskonventionen und wichtige Entscheidungen, damit der Agent diese nicht jedes Mal neu „erlernen“ muss.
• Skills Markdown: Verwalten Sie wiederverwendbare Arbeitsanweisungen und projektspezifische Workflows, die Agenten sitzungsübergreifend laden können.
• Research Clippings: Sammeln Sie Quellen, Zusammenfassungen, Links und Vergleichsnotizen bei lang andauernden Recherchen.
• Task State: Verfolgen Sie offene Threads, Blocker, Übergabeprotokolle und den Status von langlaufenden Aufgaben.

Sicherheit und Account-Limits

Um eine hohe Performance und Sicherheit zu gewährleisten, unterliegt jeder pumaDB-Account bestimmten Limits:

• Speicherkapazität: Maximal 20 Tabellen, 1.000 Zeilen pro Tabelle und ein Gesamtspeichervolumen von 25 MB pro Account.
• Anfrageraten (Rate Limits):
  • 30 Schreibvorgänge pro Minute pro Key.
  • 60 Lesevorgänge pro Minute pro Key.
• Datensicherheit: Durch Viewer-Links können große Textmengen oder Ergebnismengen sicher über kurzlebige Links eingesehen und heruntergeladen werden, ohne die API-Antwort zu überlasten.

FAQ – Häufig gestellte Fragen

Wie lange werden gelöschte Daten aufbewahrt? pumaDB speichert die letzten 10 Versionen eines Datensatzes für 30 Tage. Innerhalb dieses Zeitraums können Daten mit einem einfachen Call wiederhergestellt werden.

Kann ich pumaDB in öffentlichen Repositories verwenden? Nein. API-Keys sollten niemals in öffentlichen Repositories, statischen Seiten oder Browser-Code gespeichert werden. Die Nutzung sollte ausschließlich über vertrauenswürdigen serverseitigen Code oder über die gesicherte MCP-Schnittstelle erfolgen.

Was passiert bei großen Abfrageergebnissen? Kleine Abfragen geben direkt Inline-JSON zurück. Bei größeren Datenmengen oder wenn includeLink: true gesetzt ist, generiert pumaDB kurzlebige Viewer- und Download-Links für eine komfortable Ansicht.

Ist pumaDB für große Datenbankprojekte geeignet? pumaDB ist explizit als „lightweight memory layer“ konzipiert. Mit einem Limit von 25 MB ist es ideal für Agenten-Kontext, Notizen und Statusmeldungen, aber nicht als Ersatz für eine primäre Big-Data-Anwendung gedacht.