AgentFS：用SQLite实现智能体状态存储

SQLite凭借轻量级架构和单文件存储特性，天然适合记录智能体的运行状态、处理审计日志、保障合规性以及管理快照。然而，如何将这些能力优雅地集成到Agent系统中，一直缺少令人眼前一亮的实践案例。今天要介绍的AgentFS，正是由Pekka Enberg与Turso数据库的Glenn Snelling携手打造的项目，它将SQLite的潜力发挥到了极致：将整个智能体运行时完整封装在单个SQLite文件中。简单来说，就是用一个文件管理Agent的全部数据与行为。

项目地址：https://github.com/penberg/agentfs

核心架构解析

AgentFS的核心基于Turso实现了SQLite存储系统，它将三个关键组件有机融合：POSIX风格的虚拟文件系统、键值存储以及审计追踪工具。所有文件操作、工具调用和状态变更，都会被完整记录在SQLite数据库中——这意味着开发者可以直接通过SQL查询整个历史记录。更令人惊喜的是，快照功能让任意时间点的状态重现成为可能，而单文件设计则让整个智能体运行时可轻松迁移到任何环境。

项目提供了四个主要组件：CLI命令行工具、TypeScript和Rust的SDK库、Linux兼容的沙盒执行环境，以及完整的SQLite架构规范。需要提醒的是，目前它仍处于Alpha阶段，仅适合开发与测试场景。

实际使用示例

CLI操作非常直观，方便快速上手：

$ agentfs init
Created agent filesystem: agent.db
$ agentfs run /bin/bash
Welcome to AgentFS!
$ echo "hello from agent" > /agent/hello.txt
$ exit
$ agentfs fs cat hello.txt
hello from agent

SDK的API设计同样保持简洁风格：

import { AgentFS } from 'agentfs-sdk';

const agent = new AgentFS('./agent.db');

// 键值操作
await agent.kv.set('user:preferences', { theme: 'dark' });

// 文件系统操作
await agent.fs.writeFile('/output/report.pdf', pdfBuffer);

// 工具调用追踪
await agent.tools.record(
  'web_search',
  Date.now() / 1000,
  Date.now() / 1000 + 1.5,
  { query: 'AI' },
  { results: [...] }
);

总结与对比

基于SQLite的Agent状态管理并非只有AgentFS一种方案。社区中还有sqlite-graph（https://github.com/agentflare-ai/sqlite-graph），它为SQLite增添了图数据库功能；此外，也有通过Prisma等ORM使用SQLite的实践。但在透明文件系统层和标准化规范方面，AgentFS显然更具优势。

纵观当下的AI系统设计，似乎出现了一股返璞归真的趋势。对智能体而言，独立自主、轻量运行，甚至脱离平台单机运行才是值得追求的方向。这种将复杂基础设施简化为单一文件的思路，正是迈向这一方向的有益探索。