Documentation de Pethost Agent Sandboxes
Une sandbox est une microVM Linux pour du code, des agents de code et un bureau avec Chrome : une VM Firecracker avec son propre noyau, et vous y êtes root. Elle démarre depuis un template en 0,15 s environ, se met en pause avec sa mémoire et ses processus quand il ne s’y passe rien, se réveille au prochain appel en 0,1 s environ, et s’arrête vers le stockage objet quand elle reste inactive plus longtemps. Vous payez à la seconde ce que garde chaque état.
Dans la mémoire de son serveur
Fait tourner vos processus et répond à chaque appel.
0,018 $ de l’heure, SMALL
Inactive 5 min : elle se met en pause
Le prochain appel la réveille
Sur le disque de son serveur
Garde mémoire, processus et disque.
0,0054 $ de l’heure, SMALL
Inactive 30 min : elle s’arrête
En stockage objet
Garde son disque ; ses processus prennent fin.
0,03 $ par GiB et par mois
ResumeSandbox la redémarre, ses fichiers tels qu’elle les a laissés
Par où commencer
En chiffres
- 0,15 s pour démarrer une sandbox, mesuré via une console à 16 ms de son serveur
- 0,1 s pour réveiller une sandbox en pause, à son prochain appel
- 0,018 $ de l’heure pour 2 vCPU et 4 GiB, à la seconde
- 30 % de ce prix tant qu’elle est en pause
Ce que fait une sandbox
- Commandes, fichiers et terminal. Lancez une commande et attendez son port, modifiez un fichier par remplacement exact, suivez la sortie en direct, ou ouvrez un terminal dans un navigateur : commandes et fichiers.
- Ports. N’importe quel port à
https://<port>-<id>.<server>, public ou derrière un token : ports et prévisualisations. - Agents de code. Claude Code, Codex et OpenCode sont installés. Un appel donne un prompt à un agent, un autre diffuse chacun de ses appels d’outils : agents de code.
- Un bureau. Chrome sur un écran 1280×800, qui démarre à sa première utilisation : cliquer, taper et prendre une capture d’écran en un appel, ou suivre en direct : computer use.
- Templates, duplications et volumes. Enregistrez le disque d’une sandbox et démarrez-en de nouvelles à partir de lui (templates) ; copiez une sandbox active, mémoire comprise, en 100 copies au plus (duplications) ; gardez des données sur un disque hors de toute sandbox, sur un serveur (volumes).
- Secrets et trafic sortant. Des clés d’API que la sandbox ne détient jamais, et une liste d’autorisation des destinations où elle peut se connecter : secrets et trafic sortant.
- SSH et observabilité.
ssh,scpetssh -Lstandard (SSH), et les métriques, les événements et la consommation de chaque sandbox (observabilité).
Agent Sandboxes et App Platform
Pethost a deux sortes d’espaces de travail. App Platform est la machine d’une offre pour vos applications Docker Compose, à prix fixe chaque mois : sa documentation est celle d’App Platform. Agent Sandboxes est le sujet de ces pages : des microVM que votre code ou votre agent démarre, utilise et arrête par une API, facturées à la seconde. Chaque espace de travail est d’une seule sorte, et un même compte peut avoir les deux.
Toutes les pages
Premiers pas
-
Comment marchent Pethost Agent Sandboxes
Ce qu’est une sandbox, ses trois états RUNNING, PAUSED et STOPPED, ce qui la réveille, les deux API, et où vivent sa mémoire, ses processus et ses fichiers.
-
Démarrage rapide : votre première sandbox
Créez une sandbox, lancez une commande, écrivez un fichier, ouvrez un port et supprimez-la : en Python, TypeScript, Go, Rust, avec la CLI pethost ou un agent.
-
Connecter un agent aux sandboxes par MCP
Donnez des sandboxes comme outils à Claude Code, Codex, Cursor ou Claude : ajoutez le serveur MCP de Pethost Agent Sandboxes et connectez un espace de travail.
Notions
-
Cycle de vie d’une sandbox : pause, arrêt et inactivité
Quand une sandbox inactive se met en pause, s’arrête ou est supprimée : ce qui compte comme activité, les trois délais, keep_awake et wake_when_stopped.
-
Prix et facturation des sandboxes : à la seconde, selon l’état
Ce que coûte une sandbox à chaque seconde active, en pause ou arrêtée, ce qu’inclut une offre, les démarrages gratuits, l’essai et des exemples chiffrés.
-
Bonnes pratiques pour Pethost Agent Sandboxes
Les quelques choix qui font démarrer vite les sandboxes, baissent leur coût et les gardent sûres : templates, pause, lots, keep_awake, request_id, secrets.
Tâches
-
Lancer des commandes et modifier des fichiers dans une sandbox
Lancez des commandes shell dans une sandbox et attendez leur sortie ou leur port, suivez les longues, modifiez des fichiers et déplacez les gros par des liens.
-
Ports et prévisualisations : les URL d’une sandbox
Donnez à tout port d’une sandbox une adresse HTTPS, publique ou derrière un token, attendez qu’un serveur écoute, et lancez des prévisualisations qui dorment.
-
Faire tourner Claude Code, Codex et OpenCode dans une sandbox
Donnez un prompt à Claude Code, Codex ou OpenCode dans une sandbox en un appel, suivez ses appels d’outils et connectez-le sans y faire entrer sa clé.
-
Computer use : Chrome sur un bureau dans une sandbox
Cliquez, tapez et capturez l’écran d’un bureau avec Chrome en un appel, pour un agent de computer use, ou suivez l’écran de la sandbox en direct.
-
Templates : des sandboxes prêtes à travailler dès le démarrage
Enregistrez le disque d’une sandbox comme template, avec vos paquets et vos images Docker, et démarrez-en de nouvelles sur tout serveur en 0,2 s environ.
-
Secrets et trafic sortant : des clés qu’une sandbox ne détient jamais
Donnez à une sandbox des clés d’API qu’elle ne détient jamais, insérées par le proxy de sortie pour vos hôtes, et limitez où elle se connecte par une liste.
-
Dupliquer une sandbox (fork), mémoire et processus compris
Copiez une sandbox active, avec sa mémoire, ses processus et son disque, dans 100 sandboxes au plus en un appel, pour tenter plusieurs pistes du même point.
-
Volumes : un disque qui survit aux sandboxes
Créez un volume, montez-le dans des sandboxes, en lecture-écriture par une ou en lecture seule par plusieurs, et sachez où il vit et ce qu’il coûte.
-
SSH dans une sandbox : shell, scp, SFTP et tunnels
Connectez-vous à toute sandbox en ssh standard, copiez avec scp et SFTP, redirigez ses ports avec ssh -L, par clé ou avec un token comme mot de passe.
-
Observabilité : métriques, événements et consommation d’une sandbox
Lisez CPU, mémoire, disque et réseau d’une sandbox, suivez son cycle de vie, ses commandes, connexions, requêtes et tours d’agents, et voyez son coût.
Référence
-
Limites de Pethost Agent Sandboxes
Toutes les limites de Pethost Agent Sandboxes au même endroit : tailles, budgets des offres, démarrages, limites par sandbox et par appel, historique et réseau.
-
Erreurs de l’API des sandboxes, et que faire
Chaque refus de l’API des sandboxes, son code et son détail typé, ce qu’il veut dire et ce que votre programme ou votre agent doit faire ensuite.
Essayez Pethost Agent Sandboxes
Un essai gratuit de 7 jours avec 1 $ de consommation et 4 vCPU, avec une carte. Ensuite, une offre dès 20 $ par mois, qui inclut autant de consommation.