pumaDB

pumaDB：为 AI Agent 打造的持久化内存层，彻底解决智能体“健忘”难题

在当前人工智能领域，智能体（Agents）的交互能力日益增强，但一个核心痛点始终困扰着开发者：智能体会遗忘。一旦会话结束或上下文刷新，智能体往往会丢失之前的偏好设置、任务进度或关键事实。pumaDB 正是为了解决这一问题而生的——它为智能体提供了可靠的持久化内存层，让 Agent 能够真正“记住”信息。

什么是 pumaDB？

pumaDB 是一个专为 AI Agent 设计的轻量级内存层。它让开发者无需进行复杂的数据库开发与运维工作（No database work），即可为智能体接入持久化存储能力。通过连接托管的 MCP（Model Context Protocol） 或服务器端 API，Agent 可以像使用大脑记忆一样存储 JSON 行数据，并在需要时随时调取和回顾。

核心理念：智能体会遗忘，而 pumaDB 负责记忆。它是连接不同会话、不同模型、不同平台之间的记忆纽带。

pumaDB 的核心特性 (Features)

pumaDB 的设计目标是简单、高效且安全，其核心特性涵盖了从接入到管理的方方面面：

• 秒级部署：无需创建复杂的数据库项目，几秒钟内即可完成设置。通过简单的 REST 调用或 MCP 插件即可开始写入记忆。
• 双重接入方式：支持为智能体量身定制的 Hosted MCP 协议，也支持适用于服务器端应用的 REST API。
• 轻量级 JSON 模式：专门为 Agent 优化的轻量级架构，适合存储事实、状态、笔记、设置及各类临时记录。
• 自然语言编辑 (Natural Edits)：Agent 可以将用户的自然语言请求（如“记住我喜欢简洁的 PR 摘要”）直接转化为过滤后的数据更新，而不会产生重复行。
• 版本历史与恢复：系统会自动存档每一次更新和删除。保留最近 10 个版本长达 30 天，支持一键还原，防止数据误操作。
• 安全防护机制：内置速率限制、表空间配额以及惰性安全元数据，确保记忆存储既高效又安全。
• 可视化链接：对于较大的文本或结果集，系统可生成短效的查看器（Viewer）链接，方便直接在线查看或下载。

核心应用场景 (Use Case)

pumaDB 的灵活性使其能够适应多种复杂的 Agent 工作流，以下是几个典型应用场景：

1. 技能与操作指令 (Skills Markdown)

开发者可以存储可重复使用的操作指令、特定项目的流程规范或工具使用笔记。Agent 可以在跨会话中随时加载这些“技能包”，保持行为的一致性。

2. 项目约定 (Project Conventions)

存储代码库事实、架构说明、分支命名规则及以往的决策记录。这确保了 Agent 在处理代码任务时，不必反复被提醒相同的规则。

3. 用户偏好设置 (User Preferences)

这是最直观的应用场景。智能体可以记住用户的沟通风格、格式默认值、审查预期等。例如，用户只需说一次“叫我 Sam”，智能体便能通过 pumaDB 在所有后续对话中记住这一身份。

4. 研究剪报 (Research Clippings)

在长期的信息搜集任务中，pumaDB 可以帮助 Agent 记录来源链接、摘要、对比笔记以及待后续跟进的问题，让调查工作得以持续推进。

5. 任务与状态管理 (Task State)

记录打开的对话线程、阻塞项、交接笔记以及长时间运行任务的轻量级状态。这对于需要多步骤协作的 Agent 尤为重要。

如何使用 pumaDB (How to Use)

选项一：托管式 MCP (Hosted MCP)

这是 Agent 客户端的首选方案。您可以从 Codex, ChatGPT, Claude, OpenClaw 或任何支持 Streamable HTTP MCP 的客户端进行连接。

• MCP 端点：https://api.pumadb.ai/mcp
• 认证：支持 OAuth 发现和动态客户端注册。

选项二：服务器端 API (Server-Side API)

对于小型服务器端应用，您可以在后端或无服务器环境中使用 API Key。

• API 地址：https://api.pumadb.ai
• 基本操作示例：
  • GET /v1/{table}：查询数据表。
  • POST /v1/{table}：写入新记录。
  • DELETE /v1/{table}：删除记录。

注意：请勿将 API Key 放置在 React 组件、静态网站、移动端应用或任何公开的客户端代码中，以防密钥泄露。

账户限制与安全规范 (Safety & Limits)

为了确保服务的稳定性，pumaDB 设定了如下资源限制：

• 存储限额：每个账户最多支持 20 个数据表，每个表最多 1,000 行，总存储空间为 25 MB。
• 频率限制 (Rate Limits)：每份密钥每分钟支持 30 次写入请求和 60 次读取请求。
• 数据保留：更新或删除前的旧版本将保留 30 天，可恢复最近的 10 个版本。

常见问题解答 (FAQ)

Q: pumaDB 适合存储大型数据库吗？ A: 不适合。pumaDB 专注于为 Agent 提供轻量级、耐用的 JSON 记录，例如偏好、事实和任务状态。如果涉及海量数据存储，建议使用传统的数据库。

Q: 智能体如何更新已有的记忆？ A: Agent 可以使用 update_row 或 update_where 工具。更先进的方式是利用其“自然语言编辑”特性，让 Agent 理解用户的修正指令并自动转化为精准的过滤更新。

Q: 我的数据安全吗？ A: pumaDB 提供了 OAuth 认证和服务器端密钥保护。所有的写入操作都会附带元数据，并且支持版本审计。同时系统内置了安全护栏，防止未经授权的批量数据操作。

Q: 如何查看 Agent 存储的内容？ A: 您可以通过 MCP 提供的 list_tables 和 query 工具进行回顾，或者在调用时设置 includeLink: true 来生成在线查看链接。

---

pumaDB 正在重塑智能体与数据的交互方式。通过这一层持久化内存，您的 AI Agent 将不再是“阅后即焚”的聊天机器，而是能够伴随用户共同成长的智能伙伴。