Português
Começar

Agent Sandboxes Pausa sozinho quando ocioso

Sandboxes ociosos pausam e param sozinhos

Você não escreve o código que faz a limpeza depois de um agente. Três timers em cada sandbox decidem o que um ocioso vira: pausado depois de 5 minutos, parado depois de 30, nunca excluído. Cada um é definido por sandbox, e 0 o desativa.

O que conta como ocioso

Um sandbox está ocioso enquanto nada acontece nele: nenhuma chamada a ele e nenhum stream aberto, nenhum link aberto, sessão SSH ou requisição a uma das portas dele, nenhum turno de agente rodando e nenhum comando rodando que tenha sido iniciado com keep_awake. Um processo em segundo plano sozinho não o mantém acordado: quando o sandbox pausa, o processo congela com ele e continua ao acordar. Cada servidor olha cada um dos seus sandboxes uma vez por segundo.

Os três timers: pausa, parada e exclusão automáticas

  • pause_after_idle_seconds, 300 por padrão: um sandbox rodando pausa, com memória e processos guardados, por 30% do preço rodando.
  • stop_after_idle_seconds, 1800 por padrão: um sandbox rodando ou pausado para; os processos terminam, e o disco vai para o armazenamento de objetos por US$ 0,03 por GiB ao mês dos próprios dados.
  • delete_after_idle_seconds, 0 por padrão, ou seja, nunca: um sandbox em qualquer estado é excluído.

Os três correm no mesmo relógio, o tempo desde que algo aconteceu no sandbox pela última vez. Um timer de parada que não vence depois do de pausa faz um sandbox rodando parar sem pausar antes. get_sandbox diz o que o ciclo de vida faz a seguir e quando, em next_state e next_state_time. Você define os timers ao criar um sandbox, muda depois com update_sandbox, e um template pode levá-los para todos os sandboxes criados a partir dele.

from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # lê o PETHOST_TOKEN
lifecycle = Lifecycle(
    pause_after_idle_seconds=60,  # pausado após um minuto ocioso
    stop_after_idle_seconds=3600,  # parado após uma hora ociosa
    delete_after_idle_seconds=7 * 86400,  # excluído após uma semana ociosa
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))

# Trabalho que ninguém chama enquanto roda: keep_awake adia a pausa, por uma hora no máximo.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)
id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'

Quando um servidor fica sem folga

Um servidor pode pausar ou parar sandboxes antes dos timers. Quando a memória fica curta, ele pausa sandboxes rodando que estão ociosos há um minuto ou mais; quando o disco fica curto, os sandboxes pausados ociosos há mais tempo são parados. Nada se perde em nenhum dos casos: um sandbox pausado acorda como qualquer outro, um parado inicia de novo a partir do disco, e state_message diz por que aconteceu.

Acordar um sandbox parado

Uma chamada a um sandbox parado é recusada por padrão (FAILED_PRECONDITION com Stopped), e uma requisição a uma das portas dele recebe 503, até resume_sandbox iniciá-lo. Com wake_when_stopped ativado, um sandbox parado acorda com uma chamada, um login SSH ou uma requisição a uma porta, como um pausado: em cerca de 0,2 s, ou cerca de 10 s por GiB quando o disco precisa ser buscado de volta do armazenamento de objetos. As vCPUs dele então contam no seu plano enquanto está parado. Serve para um sandbox que um webhook chama de vez em quando.

Quanto custa o tempo ocioso

Nenhum sandbox tem tempo de vida máximo: um mantido acordado roda até você pará-lo, e um deixado em paz custa menos a cada etapa. Pegue um sandbox SMALL em que um agente trabalha 2 horas por dia e que fica ocioso nas outras 22, ao longo de um mês de 30 dias. Pausado enquanto ocioso, ele custa US$ 4,64 de uso: 60 horas a US$ 0,018 e 660 a US$ 0,0054. Deixado rodando, custaria US$ 12,96. Parado enquanto ocioso, com 5 GiB de dados próprios, custa US$ 1,22, mas aí cada início dá boot a partir do disco, sem os processos. A cobrança por segundo diz como cada um desses segundos é contado.

Como se compara

Outros fornecedores limitam quanto tempo um sandbox vive. Como as páginas deles diziam em 21 de novembro de 2026, as sessões do E2B duram até 1 hora no Hobby e 24 horas no Pro, e uma pausa recomeça a contagem; os sandboxes do Modal vivem 5 minutos por padrão e 24 horas no máximo; e as sessões do Vercel Sandbox duram 45 minutos no Hobby e 24 horas no Pro. O Pethost não impõe limite: um sandbox pausa e para pelos timers, e vive até você, ou um timer de exclusão que você definiu, removê-lo.

Ler a documentação

Perguntas

Um build longo vai ser pausado no meio?

Não se você iniciá-lo com keep_awake: o sandbox não pausa por ociosidade enquanto esse comando roda. Passe também timeout_seconds, para que um comando travado não o mantenha acordado para sempre.

Um sandbox pode nunca pausar?

Sim: defina pause_after_idle_seconds como 0. Ele então roda, cobrado como rodando, até o timer de parada ou até você pará-lo.

O que acorda um sandbox parado?

resume_sandbox ou, com wake_when_stopped ativado, qualquer chamada a ele, login SSH ou requisição a uma das portas dele.

A pausa e a parada automáticas excluem alguma coisa?

Não. Uma pausa guarda memória, processos e disco, uma parada guarda o disco, e nada é excluído a não ser que você defina delete_after_idle_seconds.

Existe um tempo de vida máximo?

Não. Um sandbox vive até você excluí-lo, ou até um timer de exclusão que você definiu fazer isso.

Relacionados

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

Começar o teste grátis