Документація Pethost Agent Sandboxes
Пісочниця — це microVM 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, що запускається з першим використанням: клацнути, ввести текст і зробити скриншот одним викликом або дивитися наживо: керування комп’ютером.
- Шаблони, копії й томи. Збережіть диск пісочниці й запускайте з нього нові (шаблони); зробіть до 100 копій пісочниці, що працює, разом із її пам’яттю (копіювання); тримайте дані на диску поза будь-якою пісочницею, на одному сервері (томи).
- Секрети й вихідний трафік. API-ключі, яких пісочниця ніколи не тримає, і список дозволених адрес, куди вона може підключатися: секрети й вихідний трафік.
- SSH і спостережуваність. Звичайні
ssh,scpіssh -L(SSH), а також метрики, події й використання кожної пісочниці (спостережуваність).
Agent Sandboxes і App Platform
У Pethost є два види робочих просторів. App Platform — це машина тарифу для ваших застосунків Docker Compose за фіксованою ціною на місяць: її документація — документація App Platform. Agent Sandboxes — те, про що ці сторінки: microVM, які ваш код чи ваш агент запускає, використовує й зупиняє через 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, секрети.
Завдання
-
Виконуйте команди й редагуйте файли в пісочниці
Виконуйте команди оболонки в пісочниці й чекайте виводу чи порту, транслюйте довгі, редагуйте файли точною заміною й передавайте великі файли через посилання.
-
Порти й прев’ю: URL пісочниці
Дайте будь-якому порту пісочниці HTTPS-адресу, публічну чи за токеном, дочекайтеся сервера розробки й запускайте прев’ю, що сплять між відвідуваннями.
-
Запускайте Claude Code, Codex і OpenCode у пісочниці
Дайте Claude Code, Codex чи OpenCode промпт у пісочниці одним викликом, транслюйте його виклики інструментів і дайте йому увійти без ключа в пісочниці.
-
Керування комп’ютером: Chrome на робочому столі в пісочниці
Клацніть, введіть текст і зробіть скриншот робочого стола з Chrome одним викликом, для агента, що керує комп’ютером, або дивіться екран наживо в браузері.
-
Шаблони: пісочниці, готові до роботи з першої секунди
Збережіть диск пісочниці як шаблон, разом із пакетами й образами 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 $ на місяць, який включає стільки ж використання.