**FUSEはすべての必要を満たす―ファイルシステムを通じてエージェントがあらゆるものへアクセスできる** FUSE（Filesystem in Userspace）は、エージェントがまるでローカルファイルシステムに接続しているかのように、任意のデータソースとシームレスにやり取りできるようにします。これにより、多様なリソースへ統一されたインターフェースでアクセスすることが可能になります。

エージェントにサンドボックス化されたシェルとファイルシステムへのアクセス権を与えることは、エージェンシャル・ハーネスの最新トレンドです。
近年の代表例として次のようなものがあります。

• Turso の AgentFS
• Anthropic の Agent SDK（Claude Code のハーネスを非コーディング領域へ拡張）
• Vercel がテキスト→SQL エージェントをサンドボックス上に再構築
• Anthropic のファイルシステムベースの段階的公開機能（Agent Skills）

これが良いとされる理由は次のようにまとめられます。

1. 大手研究室では、コーディングタスク向けに重度の強化学習を行っており、その環境と親和性を高めることでコーディング領域で得られる恩恵を他の問題領域にも波及させられます。

2. 検索・書き込み・移動・リスト化ツールを Bash 1 本に統合することで、ツール空間が大幅に縮小します。エージェントは直感的に操作をチェーンでき、Unix のパラダイムが自動で優れたツール設計を提供してくれます。

3. ファイルシステムを持つことで、自動的に生まれる便利なパターンがあります。例えば：

   • Plan／Scratch ファイル – エージェントは一時ファイルを作成し、思考の整理・進捗管理・中間結果の保存に利用します。
   • 長期コンテキスト処理 – 会話が膨らむと古いメッセージやツール結果をファイルへ圧縮しておき、必要な時に再読み込みすることで全てをメモリ上に保持する手間を省けます。

このようにメリットは明確です。しかし実際に自分のドメインでどう活用するかが難題になります。

---

2 つのケーススタディ

ドメイン	例
ファイルシステムと類似点を持つ領域	メール整理エージェント（フォルダ管理、閲覧、移動）
既存プラットフォームでファイルシステムに見えるもの	Google Drive 内のエージェント

サンドボックス化されたファイルシステムに組み込む際には次のような疑問が浮かびます。

• いつファイルをコピーする？
• 全てをコピーするべきか？
• エージェントが行った更新を書き戻す方法は？
• 人間による編集を同期させるタイミングは？
• エージェントの進捗に合わせてフォルダ／ファイルを段階的に表示するには？

Vercel が X で発表した「ファイルシステムベースエージェント」についてのコメントでは、「この記事はその質問に対して十分な回答を提供していない」と述べられています。ファイルシステムの構造は示されているものの、PostgreSQL＋オブジェクトストレージ＋API を実際にサンドボックス FS に投影する具体的かつスケーラブルな手法が提示されていません。「プリロードファイル」という表現だけでは、推奨される取り込み／スナップショットパターンが不明です。

---

FUSE で「何でもファイルシステム化」する

例：メールエージェント

AI 主導のメールプラットフォーム（Gmail のように、上層に AI を付加）を構築するとします。データは自前の DB に格納されており、ユーザーは UI を通じて操作します。強力なエージェントを追加したい場合、単純なツールループ（

list-emails

,

move-email

,

read-email

）ではなく、データをファイルシステムとして露出させます。

エージェントサンドボックス内のディレクトリ構成

workspace/
  Inbox/
    Customer Inquiry - Size Chart (emily.wolfe@gmail.com)
    PO Confirmation #2026-0038 (supplierC@fabricdirect.com)
    Shipping Delay Notice (supplierA@logisticsco.com)
    Partnership Proposal - TrendCircle (marketing@trendcircle.io)

  Starred/
    Wholesale Inquiry - SilverLeaf Boutique (boutique@silverleaf.co)
    Re: Restock ETA For Red Jackets (supplierA@logisticsco.com)

  Needs_Action/
    Missing Documents - Customs (carrier-support@airbridge.co)
    Last Call: VAT Filing Deadline (gov-tax@tradeportal.gov)

  Orders/
    2026/
      Feb/
        PO Confirmation #2026-0038 (supplierC@fabricdirect.com)
        Shipping Delay Notice (supplierA@logisticsco.com)

  Customers/
    Returns/
      Return Request #8743 (john.hartley@yahoo.com)

  Sent/
    Re: Customer Inquiry - Size Chart (emily.wolfe@gmail.com)

FUSE が高レベルアーキテクチャにどう組み込まれるか

• 従来のパス – UI → バックエンド → DB。
• エージェントパス – エージェントはサンドボックス内でマウントされたファイルシステムを見ます。

  ls /workspace/Inbox

  を実行すると FUSE 層が呼び出され、同じバックエンドに対するクエリへと変換されます。ユーザーもエージェントも「別々のインタフェース」を通して同一データを参照します。

ファイルシステムはエージェント用 UI 層として機能します。閲覧・読取・整理操作には優れた抽象化が提供されますが、メール送信などの実際のアクションは別ツールに委ねられます。

---

ファイルシステム操作の実装

以下は

fuse-native

を用いた TypeScript の簡易実装例です。主要な操作のみを示します。

// readdir – ディレクトリ内容一覧取得
export async function readdir(
  path: string,
  cb: (err: number, names?: string[]) => void
) {
  const [folder] = await db.select().from(foldersTable).where(eq(foldersTable.path, path));

  if (!folder) return cb(Fuse.ENOENT);

  const emailsInFolder = await db
    .select({ email: emailsTable, sender: contactsTable })
    .from(emailsTable)
    .leftJoin(contactsTable, eq(emailsTable.sender, contactsTable.id))
    .where(eq(emailsTable.folderId, folder.id));

  const entries = new Set<string>();
  for (const { email, sender } of emailsInFolder) {
    entries.add(`${email.subject} (${sender.email}).eml`);
  }

  const subfolders = await db.select().from(foldersTable).where(like(foldersTable.path, sql`${path}/%`));
  for (const subfolder of subfolders) {
    entries.add(subfolder.path.split("/").pop() || "");
  }

  cb(0, Array.from(entries));
}

// read – メール本文取得
export async function read(
  path: string,
  fd: number,
  buf: Buffer,
  len: number,
  pos: number,
  cb: (err: number) => void
) {
  const email = await getEmailById(fd);
  if (!email) return cb(Fuse.ENOENT);

  const content = emailToContent(email);
  const slice = content.slice(pos, pos + len);
  const bytesRead = buf.write(slice);
  cb(bytesRead);
}

export function emailToContent(email: EmailWithSender): string {
  return `From: ${email.senderEmail}
Date: ${email.sentAt.toISOString()}
Subject: ${email.subject}
X-Folder: ${email.folderPath}
X-Starred: ${email.starred}
X-Needs-Action: ${email.needsAction}

${email.body}`;
}

open

,

mkdir

,

rename

,

symlink

,

unlink

などの追加操作により、メール移動・フォルダ作成・仮想フォルダ（Starred, Needs_Action）の扱いが可能になります。これらの仮想フォルダではエージェントは「シンボリックリンク」を通じて実際のファイルを参照し、リンク操作でデータベース上のフラグを切り替えます。

---

マウントと利用方法

FUSE 実装は Docker コンテナ内にマウントされます。エージェントが直接 DB から読み取るため、同期崩壊のリスクはなく、必要なデータだけがオンデマンドでロードされます。

Anthropic Agent SDK エージェントとのサンプル対話

You are an email assistant helping the user manage their inbox.
...

エージェントは Bash コマンド（

ls

,

cat

,

find

,

mv

,

ln -s

,

rm

,

mkdir

）を使って

/workspace

を操作します。内部で行ったアクションは自然言語に翻訳され、ユーザーへ提示されます。例：

• 「Starred」 → 実際にはシンボリックリンク作成
• 「Orders へ移動」 →

  mv /Inbox/... /Orders/

  の実行

デモでは以下の典型タスクを実演します。

1. Inbox のメール一覧表示
2. 件名または送信者で特定メール検索
3. Starred フォルダへの追加（シンボリックリンク作成）
4. Inbox を

   Customers

   ,

   Orders

   ,

   Business_Opportunities

   へ整理し、緊急アイテムをフラグ付け

すべては明示的なツール API を設計せずに、ドメインをファイルシステムへマッピングするだけで実現しています。

---

要点と今後の可能性

• 仮想ファイルシステム はコンテキストエンジニアリング（古い会話・ツール結果・構造化データ）のために活用できる。
• エージェントは Unix の慣習を利用することで、開発者の認知負荷を低減し、操作性が向上します。
• 将来的なサンドボックスプロバイダーは、アプリケーション内のどこを仮想ファイルシステムとして公開するかを宣言できる API を提供する可能性があります。例：

new Agent({
  tool: [...],
  sandbox: {
    filesystem: {
      '/emails': (folder) => listEmails(folder),
      '/old_conversations': () => listOldConversations(),
    }
  }
});

FUSE やサンドボックスの詳細を扱う必要がなく、マッピングだけを定義すれば残りはシステムに任せられます。これはスケーラブルで保守性の高い AI エージェント構築における大きな差別化要因となり得ます。