tursodatabase/agentfs

What it solves

AgentFS 提供一套專門為 AI 代理管理狀態、檔案與歷史的儲存系統。它透過記錄每一次操作、維持持久化檔案系統，並確保代理環境可攜且可重現，解決了傳統檔案系統或容器在代理狀態管理上常見的困難。

How it works

AgentFS 使用基於 SQLite 的儲存系統（由 Turso 提供支援）將代理的所有操作存放於單一資料庫檔案中。它提供三種主要介面：

• Filesystem：類 POSIX 系統，用於管理檔案與目錄。
• Key-Value Store：用來保存代理的狀態與上下文。
• Toolcall Audit Trail：記錄代理呼叫的每個工具，以供除錯與分析。

使用者可以透過 SDK（TypeScript、Python、Rust）或 CLI 與 AgentFS 互動，CLI 允許使用 FUSE（Linux）或 NFS（macOS）掛載檔案系統。

Who it’s for

此工具針對需要結構化狀態管理、除錯稽核以及在隔離環境中安全執行代理的開發者設計。

Highlights

• Auditability：每一次檔案操作與工具呼叫皆以 SQL 記錄，使代理的歷史可查詢。
• Reproducibility：代理狀態可快照與還原，以重現精確的執行狀態或回滾錯誤。
• Portability：整個執行環境（包括檔案與歷史）皆封裝於單一 SQLite 檔案。
• Isolation：提供檔案系統層級的寫時複製隔離，安全執行不受信任的代理。