Português
Começar

Agent Sandboxes Pausa com a memória

Pause um sandbox com a memória e acorde-o em 0,1 s

O sandbox de um agente passa a maior parte da vida esperando o modelo. Uma pausa guarda tudo o que há nele, inclusive os processos rodando, por 30% do preço rodando, e a próxima chamada o acorda em cerca de 0,1 s, exatamente onde estava.

O que uma pausa guarda

Um sandbox pausado guarda a memória, os processos e o disco no disco do servidor. Um dev server mantém a porta aberta, uma sessão Python mantém as variáveis, a conversa de um agente de código fica onde estava, e um build pela metade continua de onde parou. Você pausa um sandbox com uma chamada, pause_sandbox, ou deixa o timer de ociosidade fazer isso: por padrão, depois de 5 minutos sem nada acontecer nele.

O que o acorda

Qualquer coisa que chegue até ele: um comando, uma leitura ou escrita de arquivo, um stream aberto, um prompt a um agente, um login SSH ou uma requisição a uma das portas dele. Você nunca precisa retomá-lo antes: a chamada que precisa dele o acorda e recebe a resposta. resume_sandbox existe para quando você o quer rodando sem nada para fazer.

Medido nos nossos servidores: uma retomada leva 41 ms no servidor e 124 ms pela API; um comando enviado a um sandbox pausado responde em 80 ms, com o despertar incluído; e uma visita à URL de preview de um sandbox pausado leva cerca de 200 ms.

Como a pausa e a retomada funcionam

Uma pausa faz o guest gravar os sistemas de arquivos, pausa a VM e tira um snapshot diferencial: só a memória que a VM escreveu desde o último snapshot é gravada, e as sequências de páginas que só têm zeros ficam de fora. Logo depois de uma criação, uma pausa levou 52 ms na mediana para um sandbox SMALL e 85 ms para um LARGE, pela API.

Um sandbox pausado mantém o lugar no servidor: o servidor guarda a memória de que o despertar vai precisar, então acordar nunca é recusado por falta de espaço. Por isso ele só retoma ali, no mesmo Firecracker, processador e base, e por isso uma pausa custa 30% do preço rodando, e não zero.

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # lê o PETHOST_TOKEN
sandbox = sandboxes.create_sandbox("base")

# Um processo servidor; a chamada responde quando ele escuta na porta 8000.
sandboxes.run_command(sandbox.sandbox_id, command="python3 -m http.server 8000", wait_for_port=8000)
sandboxes.pause_sandbox(sandbox.sandbox_id)  # memória, processos e disco guardados no servidor

# Esta chamada o acorda, e o mesmo processo servidor responde.
page = sandboxes.run_command(sandbox.sandbox_id, command="curl -s localhost:8000 | head -n 1")
print(page.stdout)
id=$(pethost sandbox new)
pethost sandbox run "$id" -d --wait-for-port 8000 -- python3 -m http.server 8000
pethost sandbox pause "$id"
pethost sandbox run "$id" -- 'curl -s localhost:8000 | head -n 1'   # acorda o sandbox

Quanto custa um sandbox pausado

Um sandbox pausado é cobrado por segundo inteiro, a 30% do preço rodando do tamanho dele, sem mínimo: US$ 0,0054 por hora para SMALL, até US$ 0,0432 para XLARGE. O tempo rodando nunca vira tempo pausado, e nenhum segundo conta duas vezes. Quando reiniciamos a máquina de um servidor, os sandboxes rodando nela são pausados e retomados depois, e esses segundos não custam nada.

Pausar ou parar

Parar é o outro jeito de guardar um sandbox que você não está usando. A pausa o deixa pronto; parar o deixa barato:

PausadoParado
Onde ficaNo disco do servidorNo armazenamento de objetos
O que fica guardadoMemória, processos e discoO disco; os processos terminam
Preço, SMALLUS$ 0,0054 por horaUS$ 0,03 por GiB ao mês dos próprios dados
De volta a rodarCerca de 0,1 s, na próxima chamadaCerca de 0,2 s por resume_sandbox, ou cerca de 10 s por GiB quando o disco é buscado de volta

Por padrão, um sandbox é parado depois de 30 minutos ocioso, pausado ou não; o ciclo de vida diz como mudar isso.

Limites

O tamanho de um sandbox pausado não pode mudar: um novo tamanho é recusado até ele ser retomado ou parado. As vCPUs dele contam no limite do seu plano enquanto está pausado, como as de um sandbox rodando. Quando o disco do servidor fica curto, os sandboxes pausados ociosos há mais tempo são parados antes, com o disco guardado, e state_message diz isso. Quando o uso incluído e o saldo de um espaço de trabalho acabam, os sandboxes pausados dele são parados.

Como se compara

Como as páginas deles diziam em 21 de novembro de 2026: o E2B também guarda a memória e não cobra nada enquanto um sandbox está pausado, mas cobra US$ 0,1656 por hora rodando por 2 vCPU e 4 GiB, contra US$ 0,018 aqui, e a documentação dele dá cerca de 4 segundos por GiB de memória para uma pausa e cerca de 1 segundo para uma retomada. O Daytona só pausa a classe de VM Linux dele, e enquanto pausado cobra só o disco. O boat.dev não tem pausa: parar remove a VM e guarda o disco.

Ler a documentação

Perguntas

Pausar e retomar um sandbox mantém os processos rodando?

Sim, com a memória e o disco. Enquanto ele está pausado, os processos ficam congelados com o resto da memória e continuam de onde estavam ao acordar. Um comando iniciado com keep_awake impede o sandbox de pausar enquanto roda, para um build ou um job que ninguém acompanha.

Quanto custa um sandbox pausado?

30% do preço rodando, por segundo: US$ 0,0054 por hora para SMALL, US$ 0,0108 para DEFAULT, US$ 0,0216 para LARGE e US$ 0,0432 para XLARGE.

Acordar pode falhar por falta de espaço?

Não: um sandbox pausado mantém o lugar no servidor. Acordar só é recusado quando o espaço de trabalho tem mais vCPUs do que o plano permite agora, depois de mudar para um plano menor, por exemplo.

Devo pausar ou parar um sandbox?

Pause o que você vai usar de novo em breve: guarda memória e processos por 30% do preço rodando e volta em cerca de 0,1 s. Pare o que pode esperar: os processos terminam, o disco fica no armazenamento de objetos por US$ 0,03 por GiB ao mês, e um início dá boot de novo a partir desse disco.

Relacionados

Dê um computador ao seu agente em 0,15 s

Começar o teste grátis