SandboxesОбзор

Sandboxes для AI-агентов

Sandboxes в Lizard (lizard.build) выполняют код и задачи AI-агента на изолированных Linux-машинах. Sandboxes поддерживают Firecracker microVM с отдельным ядром; в описанных ниже случаях они работают в контейнерах. Ваш код создаёт sandbox с помощью Lizard SDK (@lizard-build/sdk для TypeScript, lizard-sdk для Python), или вы выполняете lizard sandbox create в терминале; затем вы запускаете команды, читаете и записываете файлы и открываете порты. В тесте 2026-10-12 медианное время от создания sandbox до первого вывода Python составило 228 мс.

Когда использовать Sandboxes

  • Запускайте код, который написала модель. Дайте LLM интерпретатор кода, который сохраняет состояние Python между вызовами.
  • Дайте агенту для кодирования отдельный компьютер. Запускайте Claude Code, OpenCode или Codex в sandbox, а не на своём ноутбуке. Подключите его учётные данные через lizard agents и отправляйте промпты через lizard sandbox prompt.
  • Смотрите, что собрал агент. Запустите dev-сервер и откройте его по приватному URL предпросмотра.
  • Пробуйте несколько вариантов сразу. Скопируйте работающий sandbox через fork вместе с памятью и процессами или восстановите много копий из одного снимка.
  • Управляйте браузером. Шаблон desktop запускает графический рабочий стол, которым агент управляет через скриншоты, клики и нажатия клавиш.

Для веб-сервиса или воркера, который должен работать постоянно, разверните приложение; см. быстрый старт приложения.

Как быстро запускается sandbox?

В тесте 2026-10-12 медианное время от создания sandbox до первого вывода Python составило 228 мс, а 95-й перцентиль составил 310 мс. Тест запускали 300 раз из региона US East в Railway на us-east-1, с шаблоном base и размером Small. Результаты того же теста для E2B, Daytona и Modal смотрите на странице Sandboxes.

Кратко о Sandboxes

ВопросОтвет
Что выполняет код?Firecracker microVM или контейнер; см. runtime и шаблоны
Как создать sandbox?Lizard SDK, lizard sandbox, кабинет или HTTP API
Какие есть шаблоны?base, interpreter, codex, claude, opencode, pi, prime и desktop
Какие есть размеры?Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, по умолчанию) и Large (8 vCPU / 16 GB); см. размеры и цены
Сколько живёт sandbox?По умолчанию пять минут при создании из SDK и CLI; без срока по умолчанию из прямого API и кабинета
Что сохраняется после остановки?Только файлы на томе Persistent Volumes, подключённом в /workspace
Сколько sandbox может работать одновременно?100 на Pro, 5 в пробном периоде; см. лимиты аккаунта

Runtime и шаблоны

Выбирайте шаблон из текущего каталога: base, interpreter, codex, claude, opencode, pi, prime или desktop. Наличие зависит от региона и свободных ресурсов пула. interpreter содержит Python и основные библиотеки для работы с данными. desktop запускает графический рабочий стол, которым вы управляете через sandbox.desktop или lizard sandbox desktop. Проверяйте версии программ внутри sandbox. Публичный CLI не поддерживает загрузку своих шаблонов.

Lizard Sandboxes поддерживают Firecracker microVM с отдельным ядром. Sandbox также может работать в контейнере Kubernetes с общим ядром хоста: со старым томом или снимком pod, если настройки аккаунта или региона выбирают контейнеры либо после некоторых ошибок запуска Firecracker. Перед запуском кода, которому нужно отдельное ядро, проверьте getInfo().runtime. Давайте агенту только те ключи и права доступа, которые нужны для задачи. Снимок или том Firecracker требует Firecracker: если запуск не удался, создание завершается ошибкой без перехода в контейнер.

Жизненный цикл

Создайте sandbox, выполните команды и вызовите kill. connect подключается к существующему sandbox и не меняет его состояние, поэтому не возобновляет приостановленный или остановленный sandbox. Пауза, возобновление, snapshot и restore доступны; см. Пауза, возобновление и снимки. fork копирует работающий sandbox вместе с памятью и процессами; если подключён том, возвращается 409, а для sandbox, работающего как pod, — 501. Наблюдение за файлами пока недоступно. lizard sandbox ssh открывает интерактивную оболочку с учётными данными CLI. Доступа по протоколу SSH нет, поэтому SSH-клиенты, scp и проброс портов не работают.

create -> running -> stopped (kill / expiration)
running -> paused -> running (pause / resume)
running -> new sandboxes (fork)
snapshot -> new sandbox (restore)

Ресурсы и сроки жизни

Выберите размер при создании sandbox: Small (2 vCPU / 4 GB), Medium (4 vCPU / 8 GB, по умолчанию) или Large (8 vCPU / 16 GB). См. размеры и цены. При необходимости укажите регион явно; наличие региона в каталоге не гарантирует свободные ресурсы.

SDK и CLI по умолчанию задают срок жизни пять минут. Прямой API и кабинет по умолчанию не задают срок. Укажите его явно: timeoutMs: 0 при создании отключает истечение срока; положительное значение задаёт срок жизни. setTimeout принимает 1000–2147483647 мс, но не ноль. Команды не продлевают срок. Это не таймер простоя.

Хранение и оплата

Файлы и процессы доступны, пока sandbox работает. После остановки следующий sandbox может получить только файлы, записанные на подключённый том Persistent Volumes в /workspace. Без тома /workspace служит временной папкой. Том подключается только к одному sandbox и хранится на одном узле; отдельно сохраняйте файлы, которые должны пережить потерю узла.

У каждого размера фиксированная почасовая цена; оплата идёт посекундно, пока sandbox работает, включая простой. Исходящий трафик входит в цену до 2 TB на аккаунт за скользящие 30 дней. Sandbox, восстановленный из снимка, работает с размером и ценой исходного sandbox; восстановленный из снимка pod оплачивается по измеренному расходу. Успешная пауза останавливает оплату вычислений; Persistent Volumes оплачиваются отдельно, пока вы храните данные. Ставьте sandbox на паузу или останавливайте его, когда задача завершена. Ставки на все ресурсы смотрите на странице оплаты и в ценах.

Руководства

Справочник

Object Storage (S3)Быстрый старт

Обновлено