Перейти к основному содержимому
Версия: 0.1.9 (PyPI)

Изолированная среда и безопасность

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

Термин sandbox в интерфейсе и коде означает изолированную среду выполнения.

Поддерживаемые варианты​

Есть реализации для:

  • локального Docker;
  • локального Jupyter;
  • E2B;
  • общего слоя управления средами, файлами и жизненным циклом.

Модуль REPL может добавлять инструменты python, shell, await_shell, а провайдеры изолированной среды могут добавлять дополнительные инструменты, например open_port.

Локальный Docker​

Основные значения по умолчанию:

ПеременнаяЗначение
GIGA_AGENT_LOCAL_SANDBOX_ENABLEDtrue
GIGA_AGENT_LOCAL_DOCKER_IMAGEmikelarg/code-interpreter:0.0.5
GIGA_AGENT_LOCAL_DOCKER_MEMORY_LIMIT_MB512
GIGA_AGENT_LOCAL_DOCKER_MEMORY_RESERVATION_MB512
GIGA_AGENT_LOCAL_DOCKER_VCPU0.3
GIGA_AGENT_LOCAL_DOCKER_PIDS_LIMIT256
GIGA_AGENT_LOCAL_DOCKER_SHM_SIZE_MB128
GIGA_AGENT_LOCAL_DOCKER_MAX_ACTIVE_SANDBOXES3
GIGA_AGENT_LOCAL_DOCKER_READONLY_ROOTFSfalse

Доступ к Docker-сокету следует считать повышенным уровнем доверия: он может дать пользователю существенное влияние на машину, где запущен сервер.

Локальный Jupyter​

Основные значения по умолчанию:

ПеременнаяЗначение
GIGA_AGENT_LOCAL_JUPYTER_STARTUP_TIMEOUT_SEC20
GIGA_AGENT_LOCAL_JUPYTER_GRACEFUL_SHUTDOWN_TIMEOUT_SEC5
GIGA_AGENT_LOCAL_JUPYTER_WORKING_DIRпусто
GIGA_AGENT_LOCAL_JUPYTER_FILES_PATHпусто
GIGA_AGENT_LOCAL_JUPYTER_RUNTIME_DIRпусто
GIGA_AGENT_LOCAL_JUPYTER_PYTHON_EXECUTABLEпусто

Jupyter-среда устанавливается через дополнительный набор зависимостей giga-agent[jupyter].

Очистка сред​

Сервер запускает фоновые задачи очистки, если они включены:

  • очистка простаивающих сред: интервал 60s;
  • очистка осиротевших сред: интервал 120s;
  • время жизни запускающейся среды: 120s.

Очистка помогает освобождать ресурсы, но не заменяет ограничения прав, памяти, процессов и доступных каталогов.

Практический список проверок​

  • Включайте выполнение кода только тем пользователям, которым оно действительно нужно.
  • Не открывайте изолированной среде доступ к каталогам сверх необходимого.
  • Считайте команды shell привилегированной возможностью.
  • Настраивайте права на ресурсы: файлы, коллекции, провайдеры.
  • Держите GIGA_AGENT_SECRET_KEY в секрете.
  • Не копируйте демонстрационные настройки в общий сервер без проверки.