Українська
Почати

Agent Sandboxes Копія разом із пам’яттю

Копіюйте пісочницю на ходу, разом із пам’яттю

Підготуйте середовище один раз — репозиторій склоновано, залежності встановлено, сервер запущено, агент на півдорозі до розв’язання завдання, — а потім скопіюйте його цілком, разом із пам’яттю й процесами, і пробуйте багато різного з тієї самої точки.

Що таке копіювання (fork)

fork_sandbox копіює пісочницю такою, як вона є зараз, з пам’яттю, процесами й диском, у нові робочі пісочниці одним викликом: стільки, скільки вміщує її сервер, і щонайбільше 100. Кожна копія продовжує з моменту копіювання сама по собі: ті самі файли, ті самі програми в тому самому стані, сесія Python зі своїми змінними, сервер із відкритим портом. Агенти теж копіюються: розмова агента лежить на диску пісочниці, тож кожній копії можна дати промпт із того місця, де була вихідна.

Саме це потрібно прогонам RL та оцінювання: один підготовлений стан, багато спроб із нього, і жодна не платить знову за клонування, встановлення чи перші кроки завдання.

Як працює копіювання пісочниці

Копії створюються на сервері вихідної пісочниці. Вихідна, що працює, копіюється на ходу, потім на кілька мілісекунд стає на паузу, поки знімається її пам’ять, і працює далі: 18–56 ms, найдовше — коли її диск сильно фрагментований. Вихідна на паузі лишається на паузі, а копії зупиненої стартують із її диска. Кожна копія відновлюється з reflink-копій цього знімка й далі пише власну пам’ять і диск. Виміряно: одна копія — 258 ms через API, три — 247 ms на сервері.

Копіювання відбувається повністю або ніяк. Якщо на сервері немає місця для кожної копії, нічого не створюється, а виклик повідомляє, скільки копій вмістилося б (NoCapacity), тож можна попросити саме стільки. Копії мають розмір вихідної пісочниці та її диск; їм можна дати власні мітки та інші групи налаштувань: вихідний трафік, порти, середовище, таймери простою.

Що кожна копія отримує нового, а що зберігає

Кожна копія має власний id, свій id як ім’я хоста, власний machine-id і власну випадковість ядра: ядро перезасівається під час відновлення. Генератори випадкових чисел усередині програм — інша справа. Генератори OpenSSL, Math.random у V8, random у Python і math/rand у Go скопійовано разом із пам’яттю, і вони дають ті самі числа в кожній копії, доки їх не перезасіяти; те саме з ключами, які програма створила до копіювання. Ніщо не повідомляє процесу, що його скопійовано, тож перезасівайте генератори після копіювання, коли це важливо, або беріть кожне випадкове значення в ядра (/dev/urandom, os.urandom, crypto/rand).

from pethost.sandboxes import Sandboxes, SandboxSettings, Size

sandboxes = Sandboxes()  # читає PETHOST_TOKEN
source = sandboxes.create_sandbox("base", settings=SandboxSettings(size=Size.SMALL))
sandboxes.run_command(source.sandbox_id, command="python3 -m venv env && env/bin/pip install numpy")

# Чотири копії вихідної пісочниці такої, як вона зараз: диск, пам’ять і процеси.
copies = sandboxes.fork_sandbox(source.sandbox_id, count=4).sandboxes
for seed, copy in enumerate(copies):
    command = f"env/bin/python -c 'import numpy; numpy.random.seed({seed}); print(numpy.random.rand())'"
    print(copy.sandbox_id, sandboxes.run_command(copy.sandbox_id, command=command).stdout)
id=$(pethost sandbox new --size small)
pethost sandbox run "$id" -- 'python3 -m venv env && env/bin/pip install numpy'
for copy in $(pethost sandbox fork "$id" --count 4); do
  pethost sandbox run "$copy" -- 'env/bin/python -c "import numpy; print(numpy.random.rand())"'
done

Ліміти й ціни

Створення копії нічого не коштує: кожна — безкоштовний запуск, а з першої секунди вона оплачується як будь-яка пісочниця, посекундно за ціною свого розміру. Тариф обмежує запуски на хвилину, годину й день — 36, 360 і 1 200 на тарифі за 20 $, — і кожна копія рахується як один запуск; її vCPU теж зараховуються в бюджет тарифу, 20 на тарифі за 20 $, куди вміщуються вихідна пісочниця SMALL і 9 копій SMALL. Копіювання, яке перевищує межу вікна, відхиляється одразу повністю.

Копіювання відхиляється, поки до вихідної пісочниці змонтовано том для читання й запису, а копії завжди лишаються на сервері вихідної. Для стану, з якого ви стартуєте знову й знову, днями, на будь-якому сервері, краще збережіть шаблон: він зберігає диск, а не пам’ять.

Короткі прогони коштують мало. Оцінювання на 1 000 пісочниць SMALL на день, по 60 секунд кожна, — це 500 годин роботи пісочниць, 9,00 $ використання на місяць за 0,018 $ на годину, у межах тарифу за 20 $; якщо розподілити їх протягом дня, це близько 42 запусків на годину, у межах його 360.

Порівняння з іншими

За їхніми сторінками на 21 листопада 2026 року: E2B теж копіює із пам’яттю. boat.dev копіює з останнього знімка диска пісочниці й рахує кожну копію як запуск, що коштує 0,03–0,07 $ понад запуски, включені в тариф. Копіювання у Vercel Sandbox переносить файлову систему, а Daytona копіює лише свій клас ВМ Linux.

Читати документацію

Запитання

Чи можна скопіювати пісочницю на ходу, разом із пам’яттю?

Так: копіювання переносить пам’ять, процеси й диск із вихідної пісочниці, що працює або на паузі. У зупиненої пісочниці немає пам’яті, яку можна скопіювати, тож її копії стартують із диска.

Чи спільна пам’ять у копій із вихідною пісочницею?

Ні. Кожна копія з моменту створення — окрема пісочниця: те, що пише одна, інші ніколи не бачать.

Чи повторюються випадкові числа в копіях?

Числа ядра — ні: у кожній копії воно перезасівається. Генератори всередині програм копіюються разом зі своїм станом і повторюються, доки їх не перезасіяти.

Скільки коштує копіювання?

Створення нічого не коштує: кожна копія — безкоштовний запуск у межах запусків тарифу на хвилину, годину й день. Далі кожна копія оплачується посекундно, як будь-яка пісочниця.

Чи можуть копії опинитися на іншому сервері?

Ні: вони створюються на сервері вихідної пісочниці, усі або жодної.

Дивіться також

Дайте агентові комп’ютер за 0,15 с

Почати пробний період