Песочницы E2B: как дать агенту изолированную машину для кода

01Зачем агенту песочница

Агент, который умеет писать и запускать код, по определению получает права на исполнение. Если он работает на вашем сервере, то видит ваши переменные окружения, файлы и сеть. Одна ошибка в промпте или подсказка со стороны страницы — и код выполнится там, где вы не планировали.

Песочница меняет модель угроз. Вместо «ограничить агента фильтрами» вы даёте ему целую машину, но одноразовую и чужую: она создаётся под задачу, живёт от секунды до часа, а затем уничтожается вместе со всем содержимым. Ваша файловая система в этом процессе не участвует вообще.

02Как устроена песочница

С точки зрения кода всё выглядит как три вызова: создать песочницу, выполнить в ней код, показать файлы. За этой простотой — рантайм на Go, который управляет жизненным циклом сессий, маршрутизацией и изоляцией. Рантайм открыт под Apache-2.0, поэтому его можно изучить и поднять у себя.

Изоляция — главное отличие от контейнера на вашей машине. Контейнер разделяет процессы, но использует ваше ядро и ваш диск; выйти за его пределы при неудачной конфигурации реально. Песочница E2B живёт в отдельной виртуалке: у неё своя файловая система и своё сетевое пространство, а по окончании сессии не остаётся ничего.

03Тарифы и лимиты

Тариф определяет не только цену, но и то, какой сценарий вообще возможен: длительность сессии, число одновременных песочниц и возможность настраивать конфигурацию. Данные ниже — с официальной страницы цен, снятые 16.10.2026; вендор меняет условия, поэтому перед запуском в продакшене сверяйтесь с сайтом.

04Сколько это стоит на практике

Посекундные ставки выглядят незначительно, но именно они определяют счёт: в час песочница на конфигурации по умолчанию стоит примерно $0,17, а тысяча часов работы — уже порядка $100 только за процессор. Ниже — расчёт из опубликованных ставок, без домыслов о скидках.

05Первый запуск: четыре шага

Ниже — минимальный сценарий из официальной документации: создаём песочницу, исполняем Python внутри неё и смотрим список файлов в корне. Этих четырёх шагов достаточно, чтобы понять, как агент будет пользоваться песочницей дальше.

# .env
E2B_API_KEY=e2b_***

pip install e2b-code-interpreter python-dotenv

from dotenv import load_dotenv
load_dotenv()
from e2b_code_interpreter import Sandbox

sbx = Sandbox.create()
execution = sbx.run_code("print('hello world')")
print(execution.logs)
print(sbx.files.list('/'))

sbx.kill()

06Безопасность и динамика проекта

Песочница — это половина решения. Вторая половина — права, которые вы ей выдали: сетевой доступ, переменные окружения, токены внешних сервисов. Открытый рантайм полезен и здесь: код инфраструктуры можно прочитать, а не верить на слово.

07Что дальше

Порядок действий: поднимите Hobby-песочницу, прогоните свой реальный сценарий и замерьте две величины — сколько секунд живёт сессия и сколько стоит месячный объём. Только после этого решайте про Pro: подписка $150 в месяц окупается, если песочницы работают больше полутора тысяч часов в месяц, иначе выгоднее платить по факту.