pumaDB

pumaDB — Инновационный уровень памяти для ИИ-агентов

В современном мире искусственного интеллекта одной из главных проблем остается то, что агенты забывают. Каждый новый чат или сессия часто начинаются с чистого листа, что снижает эффективность работы. pumaDB решает эту проблему, предоставляя долговечный уровень памяти для агентов (the memory layer for agents) без необходимости сложной настройки баз данных. С помощью pumaDB вы можете подключить размещенный MCP (Model Context Protocol) или серверный API, чтобы сохранять строки JSON и просматривать то, что помнят ваши агенты.

Что такое pumaDB?

pumaDB — это специализированное решение, разработанное для того, чтобы наделить ИИ-агентов способностью запоминать информацию. Это не просто база данных, а полноценный слой памяти, который позволяет агентам сохранять факты, состояния и предпочтения пользователя.

Представьте ситуацию: в понедельник вы общаетесь с ChatGPT, просите называть вас «Сэм» и давать короткие ответы. В пятницу, используя Claude, агент мгновенно подхватывает эти настройки. Это становится возможным благодаря тому, что pumaDB позволяет агентам выполнять запросы к накопленной памяти (pumadb.query("preferences")), обеспечивая непрерывность контекста между различными платформами и сессиями.

Основные возможности pumaDB

Система pumaDB предлагает ряд уникальных функций, которые делают её идеальным инструментом для разработчиков ИИ-приложений и пользователей агентов.

1. Облегченная схема памяти

Используйте pumaDB для хранения практически любых небольших и долговечных JSON-записей. Это могут быть:

• Факты и заметки.
• Состояния и настройки.
• Контекст передачи задач (handoff context).
• Записи, которые делают будущие вызовы инструментов более точными.

2. Защитные механизмы (Safety Rails)

Память в pumaDB намеренно сделана компактной и четко структурированной. В систему встроены следующие механизмы безопасности:

• Лимиты аккаунта: До 20 таблиц, 1 000 строк в каждой таблице и общий объем хранилища 25 МБ на аккаунт.
• Ограничения скорости (Rate Limits): 30 операций записи и 60 операций чтения в минуту на один ключ.
• История версий: Каждое обновление или удаление архивирует предыдущее содержимое строки. Последние 10 версий хранятся в течение 30 дней и могут быть восстановлены одним вызовом.

3. Естественное редактирование (Natural Edits)

Агенты могут преобразовывать запросы на обычном языке (например, «запомни, что я предпочитаю краткие сводки PR») в отфильтрованные обновления. Это предотвращает дублирование строк и делает взаимодействие более человечным. Для массовых обновлений требуется явное подтверждение.

4. Ссылки для просмотра (Viewer Links)

Небольшие запросы возвращают JSON непосредственно в интерфейс. Для крупных текстов или больших наборов данных pumaDB создает временные ссылки для просмотра и скачивания, что упрощает работу с объемной информацией.

Как использовать pumaDB

Настройка pumaDB занимает считанные секунды и не требует создания отдельного проекта базы данных. Существует два основных способа интеграции.

[01] Hosted MCP (Model Context Protocol)

Этот метод идеально подходит для агентов, таких как Codex, ChatGPT, Claude или OpenClaw.

• Эндпоинт: https://api.pumadb.ai/mcp
• Особенности: Поддержка OAuth discovery и динамической регистрации клиентов.
• Инструкция: Подключитесь через любой клиент, поддерживающий Streamable HTTP MCP, используя указанный URL.

[02] Server-side API (REST)

Для небольших серверных приложений используйте именованный ключ puma_live_* в вашей бэкенд-среде.

• Базовый URL: https://api.pumadb.ai
• Безопасность: Важное примечание! Не размещайте API-ключи в React-бандлах, статических сайтах, мобильных приложениях, коде браузера или публичных репозиториях. Используйте их только в доверенных серверных средах.

Доступные REST эндпоинты:

• GET /v1/{table} — получение данных из таблицы.
• POST /v1/{table} — добавление новой записи.
• POST /v1/{table}/update_row — обновление конкретной строки.
• POST /v1/{table}/update_where — обновление по условию.
• DELETE /v1/{table} — удаление таблицы.

Сценарии использования (Use Case)

Благодаря своей гибкости, pumaDB находит применение в самых разных рабочих процессах ИИ.

Навыки и Markdown-инструкции

Агенты могут загружать многоразовые инструкции по эксплуатации, специфические рабочие процессы проектов и заметки об инструментах в разных сессиях.

Конвенции проектов

Храните факты о репозиториях, архитектурные заметки, правила веток, паттерны именования и принятые решения. Это избавляет агента от необходимости «заново открывать» эти правила при каждом запросе.

Пользовательские предпочтения

Стиль общения, настройки форматирования, ожидания от проверки кода — все эти данные могут храниться с привязкой к конкретному человеку или рабочему пространству.

Исследовательские вырезки

Собирайте источники, резюме, ссылки, заметки для сравнения и последующие вопросы в ходе долгосрочных расследований.

Состояние задач

Отслеживайте открытые потоки обсуждений, блокирующие факторы, заметки о передаче задач и статусы выполнения долгосрочных работ.

Типизированная безопасная память

Ресурсы, фрагменты кода, Markdown и примеры конфигураций сохраняются как инертные записи. Это позволяет просмотреть их перед использованием, обеспечивая дополнительный уровень безопасности.

Часто задаваемые вопросы (FAQ)

Вопрос: Какие лимиты действуют на бесплатном уровне? Ответ: Вы можете создать до 20 таблиц, хранить до 1 000 строк в каждой и использовать до 25 МБ общего дискового пространства.

Вопрос: Можно ли восстановить случайно удаленные данные? Ответ: Да, pumaDB сохраняет последние 10 версий каждой строки в течение 30 дней. Вы можете использовать инструмент restore для возврата данных.

Вопрос: Какие инструменты доступны агентам через MCP? Ответ: Агенты могут использовать широкий набор инструментов: add, query, batch, upsert, update_row, update_where, list_tables, count, delete, versions, restore, open_row, open_text_field и основной инструмент remember для записи типизированной памяти.

Вопрос: Подходит ли pumaDB для клиентских приложений? Ответ: Нет, использование API-ключей на стороне клиента (браузеры, мобильные приложения) небезопасно. Рекомендуется использовать серверную интеграцию или Hosted MCP с авторизацией через OAuth.

pumaDB — это современное и эффективное решение, которое превращает кратковременное взаимодействие с ИИ в непрерывный и интеллектуальный процесс накопления знаний.