Persistencia heredada de sandbox

Esta página heredada se mantiene para los usuarios que todavía usan la línea de SDK 1.x o beta. Las nuevas integraciones con el SDK 2.x deben seguir la documentación actual de Sandbox.

La persistencia del sandbox te permite pausar tu sandbox y reanudarlo más tarde desde el mismo estado en el que estaba cuando lo pausaste. Esto incluye no solo el estado del sistema de archivos del sandbox, sino también la memoria del sandbox. Esto significa todos los procesos en ejecución, variables cargadas, datos, etc.

Ten en cuenta:

Se tarda aproximadamente 4 segundos por cada 1 GB de RAM en pausar el sandbox.
Se tarda aproximadamente 1 segundo en reanudar el sandbox.
Los datos de un sandbox pausado se conservan permanentemente hasta que llames explícitamente al método kill.

Pausar sandbox

Cuando pausas un sandbox, se guardarán tanto el sistema de archivos del sandbox como el estado de la memoria. Esto incluye todos los archivos en el sistema de archivos del sandbox y todos los procesos en ejecución, variables cargadas, datos, etc.

import { Sandbox } from 'novita-sandbox/code-interpreter'

const sandbox = await Sandbox.create()
console.log('Sandbox created', sandbox.sandboxId)

// Pause the sandbox.
// You can save the sandbox ID in your database
// to resume the sandbox later
const result = await sandbox.betaPause()
console.log('Sandbox paused', sandbox.sandboxId, result)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create()
print('Sandbox created', sandbox.sandbox_id)

# You can save the sandbox ID in your database
# to resume the sandbox later
sandbox.beta_pause()
print('Sandbox paused', sandbox.sandbox_id)

sandbox.kill()

Nota: breve período de transición después de pausarPausar es una operación asíncrona. Después de llamar a beta_pause(), el sandbox se pausa en segundo plano.Durante este período de transición, antes de que la pausa se complete:

Operaciones de solo lectura (p. ej., get_info, list): devuelven resultados normalmente; el estado se muestra como paused
Operaciones de ejecución (p. ej., commands.run, acceder a URLs públicas del sandbox): devolverán errores; este es el comportamiento esperado. Espera a que se complete la pausa antes de volver a intentarlo (el tiempo varía según el tamaño de la memoria; consulta la nota anterior)
Operación de reanudación (connect): espera automáticamente a que se complete la pausa antes de reanudar el sandbox; no se necesita sondeo ni reintento manual

Reanudar sandbox

Cuando reanudas un sandbox, estará en el mismo estado en el que estaba cuando lo pausaste. Esto significa que se restaurarán todos los archivos del sistema de archivos del sandbox y todos los procesos en ejecución, variables cargadas, datos, etc.

Si llamas a connect() inmediatamente después de llamar a beta_pause(), connect() espera automáticamente a que se complete la pausa antes de reanudar el sandbox. No se requiere sondeo manual: todo el proceso es transparente para el llamador.

Si intentas reanudar un sandbox que se ha destruido o no existe:

JavaScript SDK lanzará NotFoundError
Python SDK lanzará NotFoundException

import { Sandbox } from 'novita-sandbox/code-interpreter'

const sandbox = await Sandbox.create()
console.log('Sandbox created', sandbox.sandboxId)

// Pause the sandbox.
// You can save the sandbox ID in your database
// to resume the sandbox later
const result = await sandbox.betaPause()
console.log('Sandbox paused', sandbox.sandboxId, result)

// Resume the sandbox.
// Even if called before pausing completes, connect() automatically waits for the pause to finish.
const resumedSandbox = await sandbox.connect()
console.log('Sandbox resumed', resumedSandbox.sandboxId)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create()
print('Sandbox created', sandbox.sandbox_id)

# Pause the sandbox.
# You can save the sandbox ID in your database
# to resume the sandbox later
sandbox.beta_pause()
print('Sandbox paused', sandbox.sandbox_id)

# Resume the sandbox.
# Even if called before pausing completes, connect() automatically waits for the pause to finish.
connectedSandbox = sandbox.connect()
print('Sandbox resumed', connectedSandbox.sandbox_id)

sandbox.kill()

Listar sandboxes pausados

Puedes listar todos los sandboxes pausados llamando al método Sandbox.list y proporcionando el parámetro de consulta state. Puedes encontrar más información sobre cómo usar el método en List Sandboxes.

import { Sandbox, SandboxInfo } from 'novita-sandbox/code-interpreter'

const sandbox = await Sandbox.create()

// List all paused sandboxes.
const paginator = Sandbox.list({ query: { state: ['paused'] } })

// Get all paused sandboxes.
const sandboxes: SandboxInfo[] = []
while (paginator.hasNext) {
  const items = await paginator.nextItems()
  sandboxes.push(...items)
}

console.log('all paused sandboxes', sandboxes)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox, SandboxQuery, SandboxState, SandboxInfo

sandbox = Sandbox.create()

sandbox.beta_pause()
print('Sandbox paused', sandbox.sandbox_id)

# List all paused sandboxes.
paginator = Sandbox.list(query=SandboxQuery(state=[SandboxState.PAUSED]))

# Get all paused sandboxes.
sandboxes: list[SandboxInfo] = []
while paginator.has_next:
  items = paginator.next_items()
  sandboxes.extend(items)

print('all paused sandboxes', sandboxes)

sandbox.kill()

Eliminar sandboxes pausados

Puedes eliminar sandboxes pausados llamando al método kill en la instancia del sandbox.

import { Sandbox } from 'novita-sandbox/code-interpreter'

const sandbox = await Sandbox.create()
console.log('Sandbox created', sandbox.sandboxId)

// Pause the sandbox.
await sandbox.betaPause()

// Kill the paused sandbox.
await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create()

# Pause the sandbox.
sandbox.beta_pause()

# Kill the paused sandbox.
sandbox.kill()

Tiempo de espera del sandbox

Cuando reanudas un sandbox, el tiempo de espera del sandbox se restablece al tiempo de espera predeterminado de un sandbox: 5 minutos. Puedes pasar un tiempo de espera personalizado al método Sandbox.connect() así:

import { Sandbox } from 'novita-sandbox/code-interpreter'

const sandbox = await Sandbox.create()

const connectedSandbox = await Sandbox.connect(sandbox.sandboxId, { timeoutMs: 60 * 1000 })
console.log('Sandbox connected', connectedSandbox.sandboxId)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create()

connectedSandbox = Sandbox.connect(sandbox.sandbox_id, timeout=60) # 60 seconds
print('Sandbox connected', connectedSandbox.sandbox_id)

sandbox.kill()

Red

Si tienes un servicio (por ejemplo, un servidor) ejecutándose dentro de tu sandbox y pausas el sandbox, el servicio no será accesible desde el exterior y todos los clientes se desconectarán. Si reanudas el sandbox, el servicio volverá a ser accesible, pero tendrás que conectar los clientes de nuevo.

Get started

Model APIs

Agent Sandbox

GPUs

Observability

Resources

Persistencia heredada de sandbox

Pausar sandbox

Reanudar sandbox

Listar sandboxes pausados

Eliminar sandboxes pausados

Tiempo de espera del sandbox

Red

​Pausar sandbox

​Reanudar sandbox

​Listar sandboxes pausados

​Eliminar sandboxes pausados

​Tiempo de espera del sandbox

​Red

Pausar sandbox

Reanudar sandbox

Listar sandboxes pausados

Eliminar sandboxes pausados

Tiempo de espera del sandbox

Red