pumaDB

pumaDB : La couche de mémoire indispensable pour les agents IA

Dans l'écosystème actuel de l'intelligence artificielle, l'un des plus grands défis reste la persistance de l'information. Les agents oublient, mais pumaDB se souvient. En tant que couche de mémoire spécialisée, pumaDB offre une solution robuste pour stocker des données JSON durables sans avoir à gérer l'infrastructure complexe d'une base de données traditionnelle. Que vous utilisiez des clients comme Codex, ChatGPT ou Claude, pumaDB permet à vos agents de conserver un contexte précieux d'une session à l'autre.

Qu'est-ce que pumaDB ?

pumaDB est défini comme la couche de mémoire pour les agents. Il s'agit d'un service de stockage de lignes JSON hébergé qui élimine le travail fastidieux de gestion de base de données. En connectant un MCP (Model Context Protocol) hébergé ou une API côté serveur, vous pouvez permettre à vos agents de mémoriser des faits, des préférences et des états de travail de manière fluide.

L'idée centrale est simple : pumaDB fournit une surface de mémoire persistante. Par exemple, si vous dites à ChatGPT via pumaDB de vous appeler « Sam » et de garder ses réponses courtes, cette information peut être récupérée instantanément dans une session ultérieure, même sur un outil différent comme Claude, grâce aux requêtes pumadb.query.

Les fonctionnalités clés de pumaDB

pumaDB ne se contente pas de stocker des données ; il propose une architecture pensée pour la sécurité et l'efficacité des interactions avec l'IA.

Une configuration instantanée

L'installation de pumaDB se fait en quelques secondes. Aucun projet de base de données complexe n'est requis. Vous avez le choix entre deux modes d'intégration principaux :

• MCP hébergé : Pour une utilisation directe par les agents.
• REST pour applications server-side : Pour une intégration dans vos propres backends.

Des rails de sécurité intégrés (Safety Rails)

La mémoire des agents dans pumaDB est volontairement maintenue petite et explicite pour éviter tout débordement ou erreur de manipulation :

• Limites de tables et de clés : Des limites de débit par clé et des limites de table par compte garantissent la stabilité.
• Éditions naturelles : Les agents peuvent transformer des requêtes en langage naturel (ex: « souviens-toi que je préfère les résumés de PR courts ») en mises à jour filtrées, évitant ainsi la création de lignes dupliquées.
• Nettoyage filtré : Des outils permettent de maintenir la base de données propre.

Historique des versions et récupération

Chaque mise à jour ou suppression dans pumaDB archive automatiquement le contenu précédent de la ligne. Les 10 dernières versions sont conservées pendant 30 jours, permettant une restauration facile avec un seul appel de fonction en cas d'erreur de l'agent.

Limites du compte et performances

Pour garantir une performance optimale, pumaDB applique les limites suivantes :

• Tables : Jusqu'à 20 tables par compte.
• Lignes : 1 000 lignes par table.
• Stockage : 25 Mo de stockage total par compte.
• Débit : 30 écritures par minute par clé et 60 lectures par minute par clé.

Cas d'utilisation de pumaDB

Grâce à son schéma de mémoire léger, pumaDB est idéal pour de nombreux scénarios où l'agent IA doit conserver une trace durable de ses activités.

1. Conventions de projet et Workflow

Stockez des faits sur le dépôt de code, les notes d'architecture, les règles de nommage des branches ou les décisions techniques. Cela évite que l'agent n'ait à redécouvrir ces règles à chaque nouvelle session.

2. Préférences utilisateur personnalisées

pumaDB excelle dans la mémorisation du style de communication, des paramètres de formatage par défaut ou des attentes de révision, le tout classé par personne ou par espace de travail.

3. État des tâches et suivi de projet

Pour les travaux de longue durée, pumaDB peut conserver une trace des threads ouverts, des bloqueurs, des notes de transfert (handoff) et des commandes en attente.

4. Extraits de recherche et documentation

Lors d'investigations qui s'étendent sur plusieurs jours, utilisez pumaDB pour stocker des liens, des résumés, des notes comparatives et des questions de suivi.

5. Mémoire typée et sécurisée (Typed Safe Memory)

Conservez des ressources, des extraits de code, du Markdown ou des exemples de configuration en tant qu'enregistrements inertes. Cela permet une révision humaine avant toute utilisation par l'agent.

Comment utiliser pumaDB

Il existe deux méthodes principales pour interagir avec la mémoire de pumaDB.

Utilisation via l'API Server-side (REST)

Pour les petites applications côté serveur, vous pouvez utiliser une clé puma_live_* dans un environnement backend ou serverless et appeler directement le point de terminaison :

https://api.pumadb.ai

Les routes HTTP disponibles incluent :

• GET /v1/{table} : Pour lister les données.
• POST /v1/{table} : Pour ajouter des entrées.
• POST /v1/{table}/update_row : Pour modifier une ligne spécifique.
• DELETE /v1/{table} : Pour supprimer des données.

Note : Ne placez jamais vos clés d'API dans du code côté client (React, applications mobiles, dépôts publics).

Utilisation via MCP Hébergé (Agent-facing)

Connectez pumaDB à vos agents via l'endpoint MCP compatible avec OAuth :

https://api.pumadb.ai/mcp

Les agents peuvent alors utiliser une suite d'outils dédiés pour manipuler la mémoire :

• remember : Pour stocker de nouveaux souvenirs typés.
• query : Pour rechercher dans la mémoire.
• upsert : Pour mettre à jour ou insérer si la donnée n'existe pas.
• restore : Pour récupérer une version précédente d'une donnée.

FAQ sur pumaDB

Q : Quels clients supportent pumaDB via MCP ? A : pumaDB peut être connecté depuis Codex, ChatGPT, Claude, OpenClaw ou tout client supportant le protocole Streamable HTTP MCP.

Q : Comment pumaDB gère-t-il les résultats volumineux ? A : Les petites requêtes renvoient du JSON directement. Pour les textes plus longs ou les ensembles de résultats importants, pumaDB génère des liens de visualisation et de téléchargement éphémères.

Q : Est-il possible de restaurer des données supprimées ? A : Oui, pumaDB conserve les 10 dernières versions de chaque ligne pendant 30 jours. Vous pouvez utiliser l'outil restore pour récupérer le contenu précédent.

Q : Quelles sont les limites de stockage par compte ? A : Chaque compte dispose d'une limite de 20 tables, avec un maximum de 1 000 lignes par table et un total de 25 Mo de données.

Q : Peut-on automatiser les mises à jour en langage naturel ? A : Oui, grâce à la fonctionnalité de Natural Edits, les agents peuvent interpréter des instructions simples pour mettre à jour la mémoire sans créer de doublons, bien que les mises à jour groupées (bulk) nécessitent une activation explicite.

---

© 2026 PUMADB · Mémoire JSON hébergée pour agents IA.