Sandbox-Lebenszyklus - Documentation

Eine Sandbox läuft weiter, bis ihr Zeitlimit abläuft oder bis Sie sie manuell stoppen. Standardmäßig bleibt eine neue Sandbox 5 Minuten aktiv. Sie können beim Erstellen der Sandbox ein anderes Zeitlimit festlegen, das Zeitlimit während der Ausführung aktualisieren, Sandbox-Informationen prüfen oder sie beenden, wenn Sie fertig sind.

Eine Sandbox mit einem Zeitlimit erstellen

Legen Sie das Zeitlimit bei der Erstellung fest, wenn Sie wissen, wie lange die Arbeit laufen soll.

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

// Timeout is in milliseconds.
const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

# Timeout is in seconds.
sandbox = Sandbox.create(timeout=60)

sandbox.kill()

Das Zeitlimit aktualisieren

Sie können die Methode setTimeout verwenden, um zurückzusetzen, wie lange die Sandbox noch aktiv bleiben soll. Das ist nützlich, wenn die Benutzeraktivität fortgesetzt wird, nachdem das ursprüngliche Zeitlimit abgelaufen wäre.

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

const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

await sandbox.setTimeout(300_000)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create(timeout=60)

sandbox.set_timeout(300)

sandbox.kill()

Sandbox-Informationen abrufen

Sie können die Methode getInfo in JavaScript oder die Methode get_info in Python verwenden, um die Sandbox-ID, die Vorlage, Metadaten, den aktuellen Zustand und die Ablaufzeit der Sandbox zu prüfen.

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

const sandbox = await Sandbox.create({ timeoutMs: 60_000 })

const info = await sandbox.getInfo()

console.log(info.sandboxId)
console.log(info.templateId)
console.log(info.state)
console.log(info.startedAt)
console.log(info.endAt)

await sandbox.kill()

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create(timeout=60)

info = sandbox.get_info()

print(info.sandbox_id)
print(info.template_id)
print(info.state)
print(info.started_at)
print(info.end_at)

sandbox.kill()

Eine Sandbox beenden

Sie können die Methode kill verwenden, um eine Sandbox herunterzufahren, bevor ihr Zeitlimit abläuft, wenn Sie sie nicht mehr benötigen.

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

const sandbox = await Sandbox.create({ timeoutMs: 60_000 })
const sandboxId = sandbox.sandboxId

await sandbox.kill()

// Or kill by ID.
await Sandbox.kill(sandboxId)

from novita_sandbox.code_interpreter import Sandbox

sandbox = Sandbox.create(timeout=60)
sandbox_id = sandbox.sandbox_id

sandbox.kill()

# Or kill by ID.
Sandbox.kill(sandbox_id)

Nächste Schritte

Um den Zustand einer Sandbox für die spätere Verwendung beizubehalten, siehe Sandbox-Persistenz.
Um wiederverwendbare gespeicherte Zustände zu erstellen, siehe Sandbox-Snapshot.

Zuletzt geändert am 10. August 2026

⌘I