Пісочниця для ШІ-агентів: недовірений код у мікро-VM, що стартує за секунду

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

Пісочниця робить цю ставку дешевою. Код отримує власну Linux-машину на кілька секунд чи хвилин, а потім машини вже немає.

Що отримує агент

Кожна пісочниця — це Firecracker microVM: своє ядро, своя файлова система, свій мережевий простір імен. Це не контейнер на вашому ядрі й не тека на вашому сервері. Запуск займає близько секунди, і це важливо, коли агент піднімає пісочницю на кожне завдання, а не раз на день.

Усередині — Python 3.12 з pip, Node.js 22 з npm, bash, git і curl. Вихідний інтернет працює: агент може зробити pip install pandas або склонувати репозиторій. Вхідний — ні: жодних відкритих портів, жодного SSH. Команди, файли й вивід ходять через наш API, і це єдині двері.

Три способи підключитися:

• MCP — якщо ваш агент живе в Claude, Cursor, Cline чи будь-якому іншому клієнті з MCP, інструменти пісочниць з'являться поруч з інструментами VPS. Коду з вашого боку не треба.
• SDK для Python або TypeScript — pip install eqvps або npm i @eqvps/sdk, далі створити, запустити, видалити.
• Звичайний REST — описаний у документації з пісочниць і в специфікації OpenAPI.

Мінімальний цикл на Python виглядає так:

from eqvps import Sandbox

with Sandbox.create(tariff="small") as sb:
    sb.upload("/root/task.py", agent_generated_code)
    result = sb.exec("python3 /root/task.py", timeout=55)
    print(result.exit_code, result.stdout[-2000:])
# the sandbox is deleted here, also if anything above raised

Ненульовий код повернення приходить як звичайний результат, а не виняток. Саме це потрібно, коли агентові треба прочитати traceback і спробувати ще раз.

Небезпечні випадки і що з ними стається

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

Секрети. Не вставляйте свої основні API-ключі в код, який пише агент. Якщо завданню ключ справді потрібен, передайте його змінною оточення пісочниці: значення зберігаються зашифрованими, не потрапляють у логи, а API віддає лише їхні імена.

Нескінченні цикли. Кожна команда зупиняється через 55 секунд, якщо ви не запустили її фоновим завданням. Ефемерна пісочниця, що простоює, видаляє себе сама після idle-тайм-ауту (типово 5 хвилин). Денний або місячний ліміт витрат перестає створювати нові пісочниці, коли агент витратив досить на сьогодні.

Витік даних назовні. Тут треба казати прямо: вихідний інтернет відкритий, бо без нього не працює pip install. Пісочниця захищає вашу машину, але не заважає коду відправити в інтернет усе, що він може прочитати всередині пісочниці. Тож правило просте: кладіть у пісочницю лише те, чого не шкода втратити.

Вибір тарифу

Оплата посекундна з мінімумом 60 секунд, з того самого передплаченого балансу, що й наші VPS. Типове завдання агента — створити, поставити два пакети, запустити, видалити — вкладається менш ніж у хвилину на small, тому списується мінімум у 60 секунд: близько $0.0006. Чесно кажучи, для агента, що запускає код кілька сотень разів на день, рахунок за пісочниці — найменший рядок у бюджеті; токени LLM коштують набагато більше.

Коли пісочниця — не той інструмент

Якщо агентові треба щось обслуговувати — вебзастосунок, приймач вебхуків, бота, що слухає повідомлення, — пісочниця не підійде: ззовні до неї не достукатися. Те саме з довгоживучим сервісом, який має працювати місяцями. Це робота для VPS: див. VPS для ШІ-агентів. Поширена схема — агент живе на невеликому VPS і створює пісочницю для кожного шматка коду, який бачить уперше.

Друге обмеження — довгі важкі обчислення. Пісочниця, яка тримає CPU на максимумі довше 15 хвилин, вважається зловживанням, тож довгі розрахунки краще тримати на сервері, орендованому помісячно.

З чого почати

Створіть акаунт, отримайте токен і запустіть першу пісочницю — посібник із підключення проводить через усі кроки, а новим акаунтам дається $1 часу пісочниць на пробу. Потім спрямуйте агента на сторінку пісочниць або на інструменти MCP і дайте йому ламати речі там, де ламати безкоштовно.

Покроково: перше завдання агента в пісочниці. За темою: ізольовані прогони тестів у CI, оцінювання LLM і рев'ю коду й перевірка PR.