pumaDB

pumaDB: De Geavanceerde Geheugenlaag voor AI-Agents

In de wereld van kunstmatige intelligentie is er een bekend probleem: agents vergeten. Of het nu gaat om een complexe workflow of een simpele gebruikersvoorkeur, AI-modellen verliezen vaak de context zodra een sessie eindigt. Hier komt pumaDB in beeld. pumaDB is de gespecialiseerde geheugenlaag voor agents die ervoor zorgt dat belangrijke informatie behouden blijft. Met pumaDB creëert u duurzaam geheugen voor agents zonder het zware werk van databasebeheer.

Het platform stelt ontwikkelaars en gebruikers in staat om een gehoste MCP (Model Context Protocol) of een server-side API te verbinden, JSON-rijen op te slaan en direct te beoordelen wat agents onthouden. Of u nu werkt met ChatGPT, Claude of eigen server-side applicaties, pumaDB biedt de infrastructuur die nodig is om AI-interacties slimmer en consistenter te maken.

Wat is pumaDB?

pumaDB is ontworpen als een lichtgewicht, maar krachtige geheugenlaag die specifiek is gebouwd voor de behoeften van moderne AI-agents. Het fungeert als een externe opslagplaats waar agents gegevens kunnen wegschrijven en ophalen, waardoor ze over sessies heen kunnen "leren" en zich aanpassen.

In plaats van een complexe database-omgeving op te zetten, biedt pumaDB een kant-en-klare oplossing. U kunt binnen enkele seconden aan de slag door te kiezen voor een gehoste MCP-endpoint voor agents of een REST-interface voor server-side apps. Het kernconcept van pumaDB is simpel: het opslaan van JSON-records die fungeren als het langetermijngeheugen van de agent.

Belangrijkste Kenmerken van pumaDB

De kracht van pumaDB ligt in de eenvoud en de specifieke focus op agent-geheugen. Hieronder volgen de belangrijkste kenmerken die pumaDB tot de ideale keuze maken voor AI-ontwikkelaars:

1. Gehoste MCP (Model Context Protocol)

pumaDB biedt een streamable HTTP MCP-endpoint. Dit is ideaal voor agents die draaien in omgevingen zoals Codex, ChatGPT of Claude.

• OAuth Ready: Ondersteunt OAuth-discovery en dynamische client-registratie.
• Directe Integratie: Verbind via de hosted URL: https://api.pumadb.ai/mcp.

2. Server-side API

Voor kleine server-side applicaties biedt pumaDB een directe weg via een REST-interface. Door een puma_live_* sleutel in uw backend of serverloze omgeving te bewaren, kunt u de API direct aanroepen via https://api.pumadb.ai.

3. Lichtgewicht Geheugenschema

pumaDB maakt gebruik van een flexibel schema voor vrijwel elk type JSON-record. Dit omvat feiten, status, notities, instellingen, scratchpads en hand-off context. De geconsolideerde remember MCP-tool slaat veelvoorkomende geheugentypes op met ingebouwde veiligheidsmetadata.

4. Veiligheidsmechanismen (Safety Rails)

Het geheugen in pumaDB is bewust klein en expliciet gehouden om overbelasting en fouten te voorkomen:

• Accountlimieten: Maximaal 20 tabellen, 1.000 rijen per tabel en 25 MB totale opslag.
• Rate Limits: 30 schrijfbewerkingen per minuut en 60 leesbewerkingen per minuut per sleutel.
• Versiebeheer: Elke update of verwijdering archiveert de vorige inhoud. De laatste 10 versies worden 30 dagen bewaard.
• Natuurlijke Bewerkingen: Agents kunnen verzoeken in natuurlijke taal (zoals "onthoud dat ik korte samenvattingen prefereer") omzetten in gefilterde updates zonder duplicaten te maken.

Hoe Gebruik je pumaDB?

Het opzetten van pumaDB is ontworpen om binnen enkele seconden te gebeuren. Afhankelijk van uw architectuur zijn er twee hoofdwegen:

Installatie via Hosted MCP

Als u werkt met clients die Streamable HTTP MCP ondersteunen (zoals ChatGPT, Claude, of OpenClaw), volgt u deze stappen:

1. Gebruik de hosted MCP-endpoint: https://api.pumadb.ai/mcp.
2. Configureer OAuth indien nodig voor veilige toegang.
3. Laat de agent de remember tool aanroepen om informatie op te slaan.

Gebruik via Server-side API (REST)

Voor applicaties die volledige controle over de backend vereisen:

1. Verkrijg een API-sleutel (puma_live_*).
2. Roep de endpoints aan via HTTP (zoals GET /v1/{table} of POST /v1/{table}).
3. Belangrijk: Plaats API-sleutels nooit in client-side code zoals React-bundels, mobiele apps of publieke repositories.

Beschikbare Commando's

Zowel via REST als MCP biedt pumaDB een breed scala aan operaties:

• Toevoegen en Updaten: add, upsert, update_row, update_where.
• Opvragen: query, list_tables, count.
• Beheer: delete, versions, restore.
• Inzicht: open_row, open_text_field.

Gebruiksscenario's (Use Cases)

pumaDB is veelzijdig inzetbaar voor verschillende soorten data die een agent moet onthouden:

• Skills Markdown: Bewaar herbruikbare instructies en projectspecifieke workflows die agents in verschillende sessies kunnen laden.
• Projectconventies: Sla repository-feiten, architectuurnotities en naamgevingspatronen op zodat deze niet telkens opnieuw ontdekt hoeven te worden.
• Gebruikersvoorkeuren: Houd communicatiestijlen, opmaakvoorkeuren en review-verwachtingen bij per persoon of workspace.
• Onderzoeksknipsels: Sla bronnen, links en vergelijkingen op van lopende onderzoeken.
• Taakstatus: Beheer openstaande threads, blokkades en hand-off notities voor langlopende projecten.
• Getypeerd Veilig Geheugen: Sla codefragmenten, commando's en configuraties op als inerte records die eerst beoordeeld kunnen worden voor gebruik.

Veelgestelde Vragen (FAQ)

V: Hoeveel data kan ik opslaan in pumaDB? A: Elk account heeft een limiet van 20 tabellen, met maximaal 1.000 rijen per tabel. De totale opslagruimte is beperkt tot 25 MB.

V: Wat gebeurt er als een agent per ongeluk data verwijdert? A: Geen zorgen. pumaDB houdt automatisch de laatste 10 versies van elke rij bij gedurende 30 dagen. Met de restore functie kan een eerdere versie met één aanroep worden hersteld.

V: Is pumaDB veilig voor gevoelige informatie? A: pumaDB slaat records op als inerte data met veiligheidsmetadata. Het is echter essentieel om API-sleutels strikt aan de serverzijde te houden en nooit bloot te stellen aan de client-zijde.

V: Ondersteunt pumaDB bulk-updates? A: Ja, maar voor bulk-updates is een expliciete opt-in vereist om te voorkomen dat agents onbedoeld grote hoeveelheden data wijzigen.

pumaDB is de ontbrekende schakel voor iedereen die serieuze AI-agents bouwt. Door een betrouwbare geheugenlaag te bieden, transformeert het vluchtige interacties in een duurzame kennisbasis.