Русский
Меню документации

Документация Pethost Agent Sandboxes

Обновлено · 2 мин чтения

Песочница — это микроВМ Linux для кода, агентов для кода и рабочего стола с Chrome: ВМ Firecracker с собственным ядром и root внутри. Она запускается из шаблона примерно за 0,15 с, встает на паузу вместе с памятью и процессами, когда в ней ничего не происходит, просыпается при следующем вызове примерно за 0,1 с, а если простаивает дольше — останавливается, и ее диск уходит в объектное хранилище. Вы платите посекундно за то, что хранит каждое состояние.

RUNNING

В памяти своего сервера

Выполняет ваши процессы и отвечает на каждый вызов.

0,018 $ в час, SMALL

Простой 5 мин: встает на паузу

Следующий вызов ее будит

PAUSED

На диске своего сервера

Хранит память, процессы и диск.

0,0054 $ в час, SMALL

Простой 30 мин: останавливается

STOPPED

В объектном хранилище

Хранит свой диск; процессы завершаются.

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

    Все границы Pethost Agent Sandboxes в одном месте: размеры, бюджеты тарифов, лимиты запусков, лимиты песочницы и вызова, хранимая история и сеть.

  • Ошибки API песочниц и что с ними делать

    Каждый отказ API песочниц, его код и типизированная деталь, что он значит и что дальше делать вашей программе или агенту.

Попробуйте Pethost Agent Sandboxes

Пробный период на 7 дней: 1 $ использования и 4 vCPU, нужна карта. Затем тариф от 20 $ в месяц, в который входит столько же использования.

Начать пробный период