pumaDB

pumaDB — AIエージェントのための永続的なメモリレイヤー

AIエージェントの開発において、最大の課題の一つは「忘却」です。セッションが終了すれば、エージェントは過去のコンテキストやユーザーの好みを失ってしまいます。pumaDBは、この問題を解決するために設計された、エージェントのための専用メモリレイヤーです。

「エージェントは忘れ、pumaDBは記憶します。」

pumaDBを導入することで、データベースの複雑な構築作業を行うことなく、エージェントに耐久性のあるメモリを付与できます。Hosted MCP（Model Context Protocol）またはサーバーサイドAPIを介して、JSON形式のデータを簡単に保存、クエリ、レビューすることが可能です。

---

What's pumaDB?

pumaDBとは、AIエージェントが情報を長期的に保持し、必要に応じて取り出すための「記憶の表面」を提供するサービスです。従来のデータベースプロジェクトのようなセットアップは不要で、わずか数秒で利用を開始できます。

pumaDBは、Codex、ChatGPT、Claude、OpenClawなどの主要なAIクライアントとシームレスに連携します。開発者は、Hosted MCPを使用してエージェントに直接メモリ操作のツールを提供するか、REST APIを使用してサーバーサイドのアプリケーションからメモリを制御するかを選択できます。

pumaDBのコンセプトは非常にシンプルです。エージェントが必要とする事実、状態、ノート、設定、スクラッチパッドなどの小さなJSONレコードを、永続的かつ安全に保管することに特化しています。

---

pumaDBの主な機能 (Features)

pumaDBは、AIエージェントの特性に合わせて最適化された多くの機能を備えています。

1. 柔軟な接続オプション

pumaDBは、用途に合わせて2つの接続方法を提供します。

• Hosted MCP: OAuth対応のストリーマブルHTTP MCPエンドポイントを提供。ChatGPTやClaudeなどのクライアントから直接ツールとして呼び出せます。
• Server-side API: バックエンドやサーバーレス環境からpuma_live_*キーを使用して、標準的なREST APIとして呼び出し可能です。

2. 安全なメモリ管理 (Safety Rails)

エージェントが生成するデータを安全に保つため、pumaDBには強力なセーフティレールが組み込まれています。

• アカウント制限: 1アカウントにつき最大20テーブル、1テーブルあたり1,000行、総ストレージ容量25MBという、エージェントのメモリに最適なサイズ制限を設けています。
• レート制限: キーごとに1分間に30回の書き込み、60回の読み取りが可能で、過剰な呼び出しを制御します。
• バージョン履歴: 更新または削除が行われるたびに、以前の内容が自動的にアーカイブされます。直近10バージョンが30日間保持され、ワンコールで復元可能です。

3. 自然な編集 (Natural Edits)

pumaDBを使用すると、エージェントは「短いPRサマリーを好むことを覚えておいて」といった自然言語の要求を、フィルタリングされた更新クエリに変換できます。重複行を作成することなく、スマートに情報を更新します。

4. ビューワーリンク

クエリ結果が大規模なテキストやデータセットになる場合、または明示的に指定した場合、pumaDBは短命なビューワーリンクやダウンロードリンクを生成します。これにより、インラインJSONでは扱いにくい大きなデータも快適に閲覧できます。

---

pumaDBの活用シーン (Use Case)

pumaDBは、エージェントが「知っておくべき」あらゆる情報の保存に適しています。

スキルMarkdown (Skills Markdown)

再利用可能な操作指示、プロジェクト固有のワークフロー、ツールのメモなどを保存し、セッションを跨いでエージェントにロードさせることができます。

プロジェクトの規約 (Project Conventions)

リポジトリの事実、アーキテクチャのノート、ブランチルール、命名パターンなど、エージェントが毎回再発見する必要のない重要な決定事項を記録します。

ユーザー設定 (User Preferences)

コミュニケーションスタイル、フォーマットのデフォルト、レビューの期待値など、個人やワークスペースに紐づく永続的な好みを管理します。

リサーチの断片 (Research Clippings)

調査過程で得られたソース、要約、リンク、比較メモ、フォローアップの質問などを保存し、長期間にわたる調査を継続させます。

タスクの状態 (Task State)

進行中のスレッド、ブロッカー、引き継ぎメモ、保留中のコマンドなど、長期実行される作業のステータスを軽量に記録します。

型定義された安全なメモリ (Typed Safe Memory)

リソース、コードスニペット、Markdown、コマンドなどを、使用前にレビュー可能な不活性なレコードとして保存します。

---

導入・使用方法 (How to Use)

pumaDBは、数ステップであなたのエージェント環境に統合できます。

1. セットアップ

以下のいずれかの方法を選択します。

• Hosted MCPを接続する: ChatGPTやClaudeなどのMCPサポートクライアントから https://api.pumadb.ai/mcp をエンドポイントとして登録します。OAuthによる認証がサポートされています。
• サーバーサイドAPIキーの取得: バックエンド環境用にAPIキーを取得し、/v1 エンドポイントを呼び出せるようにします。

2. メモリの書き込み (Store)

エージェントが情報を記憶する際は、remember ツールや POST /v1/{table} を使用します。

例: ユーザーの好みを保存する pumadb.remember("preferences", { style: "short" }) → 結果: REMEMBERED

3. メモリの呼び出し (Retrieve)

保存された情報を取得するには、query ツールや GET /v1/{table} を使用します。

例: 好みを問い合わせる pumadb.query("preferences") → 結果: 過去に保存されたデータが返却されます。

4. 主なメソッド一覧

• add / query / batch / upsert: 基本的なデータ操作
• update_row / update_where: 条件付き更新
• list_tables / count: メモリ構造の把握
• versions / restore: 履歴の確認と復元
• open_row / open_text_field: 詳細データの閲覧

---

FAQ (よくある質問)

Q: pumaDBを利用するためにデータベースの専門知識は必要ですか？ A: いいえ、不要です。pumaDBはエージェントが直接、あるいはシンプルなAPIコールで利用できるように設計されており、複雑なスキーマ設計やインフラ管理は一切必要ありません。

Q: クライアントサイドのアプリ（Reactなど）でAPIキーを使ってもいいですか？ A: いいえ。セキュリティのため、APIキーはReactバンドル、静的サイト、モバイルアプリ、ブラウザコードなどのクライアントサイドの環境には含めないでください。必ず信頼できるサーバーサイド環境で使用してください。

Q: データの保存期間や制限はありますか？ A: アカウントごとに20テーブル、各テーブル1,000行まで保存可能です。また、データの更新・削除履歴は直近10バージョンまで30日間保持されます。

Q: どのような形式のデータを保存できますか？ A: 事実、設定、ノートなど、エージェントが必要とするあらゆる小さなJSONレコードを保存できます。不活性なメタデータが付与されるため、安全に情報を管理できます。

---

pumaDB — AIエージェントのための究極のメモリレイヤー。今すぐ導入して、あなたのエージェントに「忘れられない」インテリジェンスを提供しましょう。