Sandbox

Linux でしか動かないプログラムのための、Session 専用の Linux マシン。

Sandbox は、Session 専用の Linux マシンです。Agent には exec という Tool が 1 つ与えられ、そのマシンでシェルコマンドを実行できます。開発者がターミナルで作業するのと同じように、リポジトリを clone し、package をインストールし、ビルドしてテストを実行できます。

まず Function を検討する

Sandbox は Subako で最も汎用的な Tool ですが、その汎用性には代償があります。Agent に任せたい作業のほとんどは、Function のほうがうまくこなせます。

Sandbox を付与する前に、その作業が次のどれかに当てはまらないか確認してください。どれも subako-function-examples にある Function package で、Sandbox のようなリスクはありません。

Sandbox が向いている作業

どの Function でも用意できない、本物の Linux のユーザーランドが必要な作業には Sandbox を使います。

• コードベースのビルドやテスト: git clone、npm ci、pytest、コンパイラー。
• WebAssembly 向けにビルドされていない、ネイティブのプログラムや CLI の実行。
• ネイティブ拡張が必要な npm や PyPI の package のインストール。
• モデルがコードを書いては実行して直していく作業のうち、コマンド間でマシンの状態を引き継ぐ必要があるもの。

Sandbox と Function は、同じ Agent のバージョンにまとめて付与できます。ビルドとテストは Sandbox で行い、Credential が必要な呼び出しはすべて Function に任せる、という分担がおすすめです。こうすれば、トークンをマシンに入れる必要がまったくありません。

Sandbox を付与する

Agent のバージョンの編集画面で、Tool › Sandbox の Sandbox を追加 を選び、名前を付けます。

Agent config では次のように書きます。

{
  "sandboxes": [
    {
      "name": "workbench",
      "environment": { "type": "platform", "release": "2026" },
      "network": { "type": "unrestricted" },
      "default_policy": "allow"
    }
  ]
}

exec Tool

exec は 1 つのコマンドを sh -c で実行するので、パイプや && も使えます。

結果として、終了コードと、stdout と stderr をそれぞれ最大 64 KiB まで返します。Session の Skill はスクリプトも含めて /skills/<name> に展開されるので、Agent がここで実行するスクリプトを Skill に同梱できます。

起動から廃止まで

Sandbox は最初の exec で起動します。5 分間アイドル状態が続くと 一時停止 し、/workspace が Archive に保存されてマシンが止まります。次のコマンドを実行すると、Archive から復元されます。一時停止したまま 5 時間たつと 廃止 され、残るのは Archive だけになります。その後にコマンドを実行すると、Archive から新しいマシンが起動します。

保持されるのは /workspace だけで、上限は圧縮後 256 MiB です。グローバルにインストールした package など、ほかの場所に置いたものは一時停止すると消えます。/workspace にインストールするか、必要になるたびにインストールし直してください。

Session の Sandbox タブには、各 Sandbox の状態と Archive が表示されます。Archive はダウンロードでき、Sandbox が廃止された後は削除もできます。

Archive には、削除するまで Storage 料金がかかります。詳しくは Plan と使用量 を参照してください。