Provena Agent Memory

Provena

AI エージェントのための、根拠に裏付けられた記憶。
エージェントが何を記憶しているのか、そしてその理由を把握できます。

Provena は、AI エージェント向けのオープンソースでセルフホスト可能なメモリーサービスです。MCP コネクターを使うと、Codex、Claude Code、Gemini CLI、その他のクライアントがセッションをまたいでコンテキストを利用できます。それぞれの主張は、そのソースイベント、レビュー状況、スコープに紐付けられているため、エージェントが何を記憶しているのか、そしてその理由を確認できます。

製品デモ

セットアップ、セッションをまたいだ想起、オペレーターコンソールの操作を紹介する動画をご覧ください：

https://github.com/user-attachments/assets/37fe219c-b678-4c6d-811d-bfdd37552628

出所情報が重要な理由

エージェントは、関連性があっても誤っていたり、古くなっていたり、信頼できないソースから得られたりした事実を取得することがあります。Provena は、元の証拠とそこから導かれた記憶を分けて保持します：

Event:         Alex says, "Pineapple on pizza is a crime."
Claim:         Alex dislikes pineapple on pizza.
Evidence:      The claim links to Alex's original words.

Later event:   Alex says, "I tried it. I owe pineapple an apology."
Updated claim: Alex likes pineapple on pizza.

Provena は両方の記述を保持するため、Alex の好みが変わった理由を説明できます。イベントと証拠は追記専用です。主張にはレビュー状況、任意の有効期間、テナントおよびプロジェクトまたはブランチの正確なスコープが設定されます。モデルが抽出した主張は候補のままです。ソースの信頼度は検索の関連性とは別に扱われ、行動する権限を与えることはありません。memory_explain を使うと、主張をソース、レビュー履歴、競合、記録された取得履歴までたどれます。

Provena は、PostgreSQL と pgvector をバックエンドに使用する単一の FastAPI サービスです。MCP とホストフックが会話ターンを記録し、出典付きのコンテキストを取得します。Ollama または任意のホスト型モデルが、候補となる事実と埋め込みを抽出します。Next.js コンソールでは、人がそれらを確認してレビューできます。アーキテクチャの詳細 · 設計上の決定

始める

Python 3.11 以降、pipx、Docker Compose、およびサポート対象のエージェントホストが必要です。コネクターをインストールし、使用するホストを選択してください：

pipx install provena-agent-memory
provena quickstart codex

該当するホストでは、provena quickstart claude または provena quickstart gemini を使用します。クイックスタートを実行すると、ローカルサービス、PostgreSQL、Ollama、コンソールが起動し、エージェントとレビュアーの認証情報が作成され、MCP に加えて自動記録・取得フックがインストールされます。コンソールの URL が表示されます。エージェントホストを再起動し、/hooks と /mcp で Provena を確認してください。

初回実行時には、デフォルトのモデルがダウンロードされます（約 1.26 GB）。ローカルの Ollama イメージは、ダイジェストで固定された CPU ビルドです。パッケージをインストールしただけでは会話は記録されません。記録を許可するには、クイックスタートを実行する必要があります。

API とデータベースが稼働していることを確認するには：

provena status

既存のサービスに接続する

運用担当者に、API URL、エージェント用 API キー、プロジェクトまたはブランチのスコープ ID を問い合わせてください。コネクターをインストールしたら、次を実行します：

export PROVENA_API_URL=https://memory.example.com
export PROVENA_API_KEY=paste-agent-key
export PROVENA_SCOPE_ID=paste-scope-id
provena connect codex --install

必要に応じて、codex を claude または gemini に置き換えてください。その他の MCP クライアントでは、provena connect generic を使うと設定を表示できます。手動での MCP セットアップとコンソールへのアクセスについては、コネクターガイドをご覧ください。

その他のセットアップ方法

• 手動でセルフホストする： v0.1.15 の Compose ファイルをダウンロードし、残りのファイル、認証情報、アップグレード、バックアップについてはデプロイガイドに従ってください。
• ソースから開発する： Python、Docker、コンソール、テストについてはローカル開発ガイドに従ってください。

現在の制限

検索では完全一致のスコープを使用し、ブランチの継承には対応していません。Provena はエージェントに配信されたクレームを記録しますが、その後のアクションがそれらのクレームによって引き起こされたことを証明することはできません。現在の保証と制限について。

貢献

good first issueから始めるか、CONTRIBUTING.mdをお読みください。脆弱性を非公開で報告する方法についてはSECURITY.md、リリース履歴についてはCHANGELOG.mdをご覧ください。