Vercel Sandbox 上のエージェントが、ランタイムやツールを差し替えたあとも同じ作業ファイルを使い続けられる。ドライブは実行環境から独立し、後続のサンドボックスが同じパスにマウントする。

typescript
import { Sandbox, Drive } from '@vercel/sandbox';
const drive = await Drive.getOrCreate({ name: 'agent-workspace' });
const sandbox = await Sandbox.create({
  mounts: { '/workspace': drive },
});

CLI は sandbox drives get-or-create agent-workspace と sandbox create --mount agent-workspace:/workspace。

  • マウント配下だけがドライブに残り、それ以外はサンドボックス側
  • 読み書きマウントは同時に 1 つ。並列参照は drive.snapshot() の読み取り専用コピー
  • drive.fork() は独立した書き込み可能なコピーを作る。元へマージせず、リージョンと最大サイズを継承。未書き込みのドライブは fork できない
  • 1 サンドボックスあたり最大 4 本。既定リージョンは iad1 で作成後は変更不可。サンドボックスのメインリージョンと一致させる
  • 既定の最大サイズは 1 TiB(Hobby は 1 GiB)、上限は 16 TiB。手動削除まで残る
  • 課金は論理使用量の時間按分。iad1 のストレージは $0.05/GB-month、読み $0.0015/GB、書き $0.004/GB。Hobby はストレージ 15 GB(lifetime)、読み書き各 30 GB/month

#参考文献