SandboxesИнтерпретатор кода

Интерпретатор кода

CodeSandbox расширяет обычную песочницу за счёт сохраняющего состояние ядра — переменные, импорты и определения функций сохраняются между вызовами, как в Jupyter Notebook. Это подходящий инструмент, когда ИИ-агент генерирует и запускает код пошагово.

Он загружается из шаблона code-interpreter-v1 (Python 3.14 + Node.js 26, с API выполнения кода на порту 8080) и поддерживает Python, JavaScript и Bash из коробки.

Запуск кода

import { CodeSandbox } from '@lizard-build/sdk';
 
// Every sandbox belongs to a project — usage is metered per project
const sandbox = await CodeSandbox.create({ project: 'my-project' });   // defaults to 'code-interpreter-v1'
 
await sandbox.runCode('x = 42');
const result = await sandbox.runCode('print(x * 2)');
console.log(result.stdout);        // "84\n"  — x survived from the previous call
 
await sandbox.kill();

runCode(code, opts?) возвращает Execution:

ПолеОписание
stdout / stderrЗахваченные потоки вывода
resultsНасыщенные результаты (значения, а также сгенерированные изображения / диаграммы)
errorExecutionError (name, message, traceback), если код выбросил ошибку
executionCountМонотонный счётчик для ядра

Выбор языка

По умолчанию — Python. Передайте language для разового запуска в другом рантайме:

const js = await sandbox.runCode('1 + 1', { language: 'javascript' });
console.log(js.results[0].data);   // "2"
 
await sandbox.runCode('echo "$(uname -s)"', { language: 'bash' });

Потоковый вывод

Для долгих ячеек выводите stdout/stderr по мере их генерации, вместо ожидания результата:

await sandbox.runCode('for i in range(5): print(i)', {
  onStdout: (line) => process.stdout.write(line),
  onStderr: (line) => process.stderr.write(line),
  onResult: (r)    => console.log('result:', r),
  onError:  (e)    => console.error('error:', e.name, e.message),
});

Изолированные контексты

Контекст — это независимое пространство имён внутри одной песочницы — используйте один на сессию агента или на пользователя, чтобы их переменные никогда не пересекались.

const a = await sandbox.createContext({ language: 'python' });
const b = await sandbox.createContext({ language: 'python' });
 
await sandbox.runCode('secret = 1', { context: a });
await sandbox.runCode('print(secret)', { context: b });   // NameError — b never saw it
 
await sandbox.listContexts();
await sandbox.restartContext(a);    // clear all variables/state
await sandbox.deleteContext(b);     // free its resources

Передайте либо context либо language в runCode, не оба сразу — у контекста уже привязан язык.

Контрольная точка сессии

Поскольку CodeSandbox — это песочница, пауза и возобновление работают так же. Установите тяжёлый стек зависимостей один раз, поставьте на паузу и возобновите позже с сохранённым состоянием ядра:

const sandbox = await CodeSandbox.create({ project: 'my-project' });
await sandbox.runCode('import subprocess; subprocess.run(["pip", "install", "scikit-learn"])');
const id = sandbox.sandboxId;
await sandbox.pause();
 
// Later — resume with packages and kernel variables already in place
const resumed = await CodeSandbox.connect(id);
const out = await resumed.runCode('import sklearn; print(sklearn.__version__)');
console.log(out.stdout);
await resumed.kill();

См. также

  • Справочник SDK — каждый метод CodeSandbox и параметр runCode.
  • Persistent Volumes — подключите хранилище, которое переживает одну песочницу.
Справочник SDKPersistent Volumes