Docs do Pethost Agent Sandboxes
Um sandbox é uma microVM Linux para código, agentes de código e um desktop com Chrome: uma VM Firecracker com kernel próprio e root lá dentro. Ele inicia a partir de um template em cerca de 0,15 s, pausa com a memória e os processos quando nada acontece nele, acorda na próxima chamada em cerca de 0,1 s e para no armazenamento de objetos quando fica ocioso por mais tempo. Você paga por segundo pelo que cada estado guarda.
Na memória do servidor
Roda os seus processos e responde a toda chamada.
US$ 0,018 por hora, SMALL
Ocioso por 5min: ele pausa
A próxima chamada o acorda
No disco do servidor
Guarda memória, processos e disco.
US$ 0,0054 por hora, SMALL
Ocioso por 30min: ele para
No armazenamento de objetos
Guarda o disco; os processos terminam.
US$ 0,03 por GiB ao mês
ResumeSandbox o inicia de novo, com os arquivos como ele os deixou
Por onde começar
Em números
- 0,15 s para iniciar um sandbox, medido por um painel a 16 ms do servidor dele
- 0,1 s para acordar um pausado, na próxima chamada
- US$ 0,018 por hora para 2 vCPUs e 4 GiB, por segundo
- 30% desse preço enquanto ele está pausado
O que um sandbox faz
- Comandos, arquivos e um terminal. Rode um comando e espere pela porta dele, edite um arquivo por substituição exata, transmita a saída ou abra um terminal no navegador: comandos e arquivos.
- Portas. Qualquer porta em
https://<port>-<id>.<server>, pública ou atrás de um token: portas e previews. - Agentes de código. O Claude Code, o Codex e o OpenCode vêm instalados. Uma chamada dá um prompt a um agente, outra transmite cada chamada de ferramenta que ele faz: agentes de código.
- Um desktop. Chrome em uma tela de 1280×800, que inicia no primeiro uso: clique, digite e tire uma captura de tela em uma chamada, ou assista ao vivo: uso do computador.
- Templates, forks e volumes. Salve o disco de um sandbox e inicie novos a partir dele (templates); copie um sandbox rodando, com memória e tudo, em até 100 cópias (forks); guarde dados em um disco fora de qualquer sandbox, em um servidor (volumes).
- Segredos e saída. Chaves de API que o sandbox nunca guarda e uma lista de permissões dos lugares a que ele pode se conectar: segredos e saída.
- SSH e observabilidade.
ssh,scpessh -Lpuros (SSH), e as métricas, os eventos e o uso de cada sandbox (observabilidade).
Agent Sandboxes e App Platform
O Pethost tem dois tipos de espaço de trabalho. O App Platform é a máquina de um plano para os seus apps Docker Compose, por um preço fixo por mês: a documentação dele é a documentação do App Platform. O Agent Sandboxes é o assunto destas páginas: microVMs que o seu código ou o seu agente inicia, usa e para por uma API, cobradas por segundo. Cada espaço de trabalho é de um tipo, e uma conta pode ter os dois.
Todas as páginas
Começar
-
Como o Pethost Agent Sandboxes funciona
O que é um sandbox, seus três estados RUNNING, PAUSED e STOPPED, o que o acorda, as duas APIs e onde ficam a memória, os processos e os arquivos dele.
-
Início rápido: o seu primeiro sandbox
Crie um sandbox, rode um comando, grave um arquivo, abra uma porta e faça a limpeza: em Python, TypeScript, Go, Rust, pela CLI pethost ou pelo seu agente.
-
Conecte um agente aos sandboxes por MCP
Dê sandboxes como ferramentas ao Claude Code, Codex, Cursor ou Claude: adicione o servidor MCP do Pethost Agent Sandboxes e escolha um espaço de trabalho.
Conceitos
-
Ciclo de vida do sandbox: pausa automática, parada automática e ociosidade
Quando um sandbox ocioso pausa, para ou é excluído: o que conta como atividade, os três timers, keep_awake, wake_when_stopped e valores por caso de uso.
-
Preços e cobrança de sandboxes: por segundo, por estado
Quanto um sandbox custa a cada segundo rodando, pausado ou dormindo, o que um plano inclui, inícios grátis e seus limites, o teste grátis e exemplos calculados.
-
Boas práticas do Pethost Agent Sandboxes
As escolhas que fazem sandboxes iniciarem rápido, custarem menos e ficarem seguros: templates, pausa, jobs em lote, keep_awake, request_id, segredos, saída.
Tarefas
-
Rode comandos e edite arquivos em um sandbox
Rode comandos de shell em um sandbox e espere a saída ou a porta, transmita os longos, edite arquivos por substituição exata e mova arquivos grandes por links.
-
Portas e previews: as URLs de um sandbox
Dê a qualquer porta de um sandbox um endereço HTTPS, público ou atrás de um token, espere um servidor de desenvolvimento escutar e rode previews que dormem.
-
Rode Claude Code, Codex e OpenCode em um sandbox
Dê um prompt ao Claude Code, Codex ou OpenCode em um sandbox com uma chamada, transmita as chamadas de ferramenta e faça o login sem a chave entrar no sandbox.
-
Uso do computador: Chrome em um desktop dentro de um sandbox
Clique, digite e tire uma captura de tela de um desktop com Chrome em uma chamada, para um agente de uso do computador, ou veja a tela do sandbox ao vivo.
-
Templates: inicie sandboxes prontos para trabalhar
Salve o disco de um sandbox como template, com os seus pacotes e imagens Docker, e inicie novos sandboxes a partir dele em qualquer servidor em cerca de 0,2 s.
-
Segredos e saída: chaves que um sandbox nunca guarda
Dê a um sandbox chaves de API que ele nunca guarda, trocadas pelo proxy de saída para os hosts indicados, e limite as conexões com uma lista de permissões.
-
Faça fork de um sandbox, com memória e processos
Copie um sandbox rodando, com memória, processos e disco, para até 100 sandboxes em uma chamada, e tente várias coisas a partir do mesmo ponto ao mesmo tempo.
-
Volumes: um disco que sobrevive aos sandboxes
Crie um volume, monte-o em sandboxes em um caminho, com leitura e escrita por um ou só leitura por muitos, e saiba onde ele fica e quanto custa.
-
SSH em um sandbox: shell, scp, SFTP e túneis
Entre em qualquer sandbox com ssh puro, copie arquivos com scp e SFTP e encaminhe portas com ssh -L, com uma chave do espaço de trabalho ou um token como senha.
-
Observabilidade: métricas, eventos e uso de um sandbox
Leia CPU, memória, disco e rede de um sandbox, liste e transmita ciclo de vida, comandos, conexões, requisições e turnos de agente, e veja quanto ele custou.
Referência
-
Limites do Pethost Agent Sandboxes
Todos os limites do Pethost Agent Sandboxes em um só lugar: tamanhos, orçamentos, inícios, limites por sandbox e por chamada, histórico guardado e rede.
-
Erros da API de sandboxes, e o que fazer
Cada recusa da API de sandboxes, o código e o detalhe tipado dela, o que significa e o que o seu programa ou agente deve fazer em seguida.
Experimente o Pethost Agent Sandboxes
Um teste grátis de 7 dias com US$ 1 de uso e 4 vCPUs; é preciso um cartão. Depois, um plano a partir de US$ 20 por mês, que inclui esse mesmo valor em uso.