Документация Pethost Agent Sandboxes
Песочница — это микроВМ Linux для кода, агентов для кода и рабочего стола с Chrome: ВМ Firecracker с собственным ядром и root внутри. Она запускается из шаблона примерно за 0,15 с, встает на паузу вместе с памятью и процессами, когда в ней ничего не происходит, просыпается при следующем вызове примерно за 0,1 с, а если простаивает дольше — останавливается, и ее диск уходит в объектное хранилище. Вы платите посекундно за то, что хранит каждое состояние.
В памяти своего сервера
Выполняет ваши процессы и отвечает на каждый вызов.
0,018 $ в час, SMALL
Простой 5 мин: встает на паузу
Следующий вызов ее будит
На диске своего сервера
Хранит память, процессы и диск.
0,0054 $ в час, SMALL
Простой 30 мин: останавливается
В объектном хранилище
Хранит свой диск; процессы завершаются.
0,03 $ за GiB в месяц
ResumeSandbox запускает ее снова, файлы — такими, какими она их оставила
С чего начать
В цифрах
- 0,15 с на запуск песочницы, измерено через панель в 16 ms от ее сервера
- 0,1 с на пробуждение песочницы с паузы при следующем вызове
- 0,018 $ в час за 2 vCPU и 4 GiB, посекундно
- 30 % этой цены, пока песочница на паузе
Что умеет песочница
- Команды, файлы и терминал. Запустите команду и дождитесь ее порта, правьте файл точной заменой, получайте вывод потоком или откройте терминал в браузере: команды и файлы.
- Порты. Любой порт по адресу
https://<port>-<id>.<server>, публичный или за токеном: порты и превью. - Агенты для кода. Claude Code, Codex и OpenCode уже установлены. Один вызов дает агенту промпт, другой потоком показывает каждый его вызов инструмента: агенты для кода.
- Рабочий стол. Chrome на экране 1280×800, который запускается при первом использовании: клик, ввод и скриншот за один вызов или наблюдение вживую: computer use.
- Шаблоны, форки и тома. Сохраните диск песочницы и запускайте из него новые (шаблоны); скопируйте работающую песочницу вместе с памятью и всем остальным, до 100 копий (форки); храните данные на диске вне всех песочниц, на одном сервере (тома).
- Секреты и исходящий трафик. API-ключи, которых в песочнице никогда нет, и список разрешенных адресов, куда она может подключаться: секреты и исходящий трафик.
- SSH и наблюдаемость. Обычные
ssh,scpиssh -L(SSH), а также метрики, события и использование каждой песочницы (наблюдаемость).
Agent Sandboxes и App Platform
В Pethost два вида рабочих пространств. App Platform — машина тарифа для ваших приложений на Docker Compose по фиксированной цене в месяц: о ней рассказывает документация App Platform. Agent Sandboxes — то, о чем эти страницы: микроВМ, которые ваш код или ваш агент запускает, использует и останавливает через API, с посекундной оплатой. Каждое рабочее пространство — одного вида, и в одном аккаунте могут быть оба.
Все страницы
Начало
-
Как устроены Pethost Agent Sandboxes
Что такое песочница, ее три состояния RUNNING, PAUSED и STOPPED, что ее будит, два API и где хранятся ее память, процессы и файлы.
-
Быстрый старт: ваша первая песочница
Создайте песочницу, выполните команду, запишите файл, откройте порт и уберите за собой: из Python, TypeScript, Go, Rust, CLI pethost или вашим агентом.
-
Подключить агента к песочницам по MCP
Дайте Claude Code, Codex, Cursor или Claude песочницы как инструменты: добавьте MCP-сервер Pethost Agent Sandboxes и войдите в рабочее пространство.
Основы
-
Жизненный цикл песочницы: автопауза, автоостановка и простой
Когда песочница в простое встает на паузу, останавливается или удаляется: что считается активностью, таймеры, keep_awake, wake_when_stopped, значения для задач.
-
Цены и оплата песочниц: посекундно, по состояниям
Сколько стоит каждая секунда, пока песочница работает, на паузе или спит, что входит в тариф, бесплатные запуски и их лимиты, пробный период и примеры расчета.
-
Лучшие практики для Pethost Agent Sandboxes
Несколько решений, с которыми песочницы быстро запускаются, стоят меньше и остаются в безопасности: шаблоны, пауза для агентов, keep_awake, request_id, секреты.
Задачи
-
Команды и файлы в песочнице
Выполняйте команды шелла в песочнице и ждите их вывода или порта, получайте долгие потоком, правьте файлы точной заменой и передавайте большие файлы по ссылкам.
-
Порты и превью: адреса песочницы
Дайте любому порту песочницы HTTPS-адрес, публичный или за токеном, дождитесь, пока dev-сервер начнет слушать, и запускайте превью, которые спят между заходами.
-
Claude Code, Codex и OpenCode в песочнице
Дайте Claude Code, Codex или OpenCode промпт в песочнице одним вызовом, получайте его вызовы инструментов потоком и подключите его без ключа внутри песочницы.
-
Computer use: Chrome на рабочем столе в песочнице
Клик, ввод и скриншот рабочего стола с Chrome за один вызов — для агента с computer use, — или смотрите экран песочницы вживую в браузере.
-
Шаблоны: песочницы, готовые к работе сразу
Сохраните диск песочницы как шаблон, вместе с вашими пакетами и образами Docker, и запускайте из него новые песочницы на любом сервере примерно за 0,2 с.
-
Секреты и исходящий трафик: ключи, которых нет в песочнице
Дайте песочнице API-ключи, которых в ней нет: их подставляет прокси исходящего трафика для названных хостов, а куда ей подключаться, задает список адресов.
-
Форк песочницы вместе с памятью и процессами
Скопируйте работающую песочницу с памятью, процессами и диском в новые песочницы, до 100 за вызов, чтобы пробовать несколько вариантов из одной точки сразу.
-
Тома: диск, который переживает песочницы
Создайте том, подключите его к песочницам по пути, на запись в одной или на чтение во многих, и узнайте, где он хранится и сколько стоит.
-
SSH в песочницу: шелл, scp, SFTP и туннели
Входите в любую песочницу обычным ssh, копируйте файлы через scp и SFTP и пробрасывайте ее порты через ssh -L — с ключом рабочего пространства или токеном.
-
Наблюдаемость: метрики, события и использование песочницы
CPU, память, диск и сеть песочницы, ее жизненный цикл, команды, подключения, запросы к портам и ходы агентов — списком и потоком, и сколько она стоила.
Справочник
-
Лимиты Pethost Agent Sandboxes
Все границы Pethost Agent Sandboxes в одном месте: размеры, бюджеты тарифов, лимиты запусков, лимиты песочницы и вызова, хранимая история и сеть.
-
Ошибки API песочниц и что с ними делать
Каждый отказ API песочниц, его код и типизированная деталь, что он значит и что дальше делать вашей программе или агенту.
Попробуйте Pethost Agent Sandboxes
Пробный период на 7 дней: 1 $ использования и 4 vCPU, нужна карта. Затем тариф от 20 $ в месяц, в который входит столько же использования.