Português
Menu da documentação

Docs do Pethost Agent Sandboxes

Atualizado em · 3 min de leitura

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.

RUNNING

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

PAUSED

No disco do servidor

Guarda memória, processos e disco.

US$ 0,0054 por hora, SMALL

Ocioso por 30min: ele para

STOPPED

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

O ciclo de vida padrão. Cada timer pode ser alterado ou desativado, e um sandbox nunca é excluído a não ser que você peça: ciclo de vida e ociosidade.

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, scp e ssh -L puros (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

Tarefas

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.

Começar o teste grátis