Français
Commencer

Agent Sandboxes La pause garde la mémoire

Mettre une sandbox en pause avec sa mémoire, la réveiller en 0,1 s

La sandbox d’un agent passe l’essentiel de sa vie à attendre le modèle. Une pause y garde tout, processus en cours compris, à 30 % du prix d’exécution, et le prochain appel la réveille en 0,1 s environ, exactement là où elle en était.

Ce que garde une pause

Une sandbox en pause garde sa mémoire, ses processus et son disque sur le disque de son serveur. Un serveur de développement garde son port ouvert, une session Python ses variables, la conversation d’un agent de code reste où elle en était, et un build à moitié fait reprend là où il s’est arrêté. Vous mettez une sandbox en pause par un appel, pause_sandbox, ou vous laissez son délai d’inactivité le faire : par défaut, après 5 minutes sans que rien ne s’y passe.

Ce qui la réveille

Tout ce qui y touche : une commande, une lecture ou une écriture de fichier, un flux ouvert, un prompt à un agent, une connexion SSH ou une requête vers l’un de ses ports. Vous ne la reprenez jamais d’abord : l’appel qui en a besoin la réveille, et reçoit sa réponse. resume_sandbox sert quand vous voulez qu’elle tourne sans rien à faire.

Mesuré sur nos serveurs : une reprise prend 41 ms sur le serveur et 124 ms via l’API ; une commande envoyée à une sandbox en pause répond en 80 ms, réveil compris ; et une visite de l’URL de prévisualisation d’une sandbox en pause prend environ 200 ms.

Comment marchent la pause et la reprise

Une pause fait écrire au système invité ses systèmes de fichiers, met la VM en pause et prend un snapshot différentiel : seule la mémoire écrite par la VM depuis son dernier snapshot est écrite, et les suites de pages qui ne contiennent que des zéros sont laissées de côté. Juste après une création, une pause a pris 52 ms en médiane pour une sandbox SMALL et 85 ms pour une LARGE, via l’API.

Une sandbox en pause garde sa place sur son serveur : le serveur garde de côté la mémoire dont son réveil aura besoin, si bien qu’un réveil n’est jamais refusé faute de place. C’est pour cela qu’elle ne reprend que là, sur le même Firecracker, le même processeur et la même base, et qu’une pause coûte 30 % du prix d’exécution plutôt que rien.

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # lit PETHOST_TOKEN
sandbox = sandboxes.create_sandbox("base")

# Un processus serveur ; l'appel répond dès qu'il écoute sur le port 8000.
sandboxes.run_command(sandbox.sandbox_id, command="python3 -m http.server 8000", wait_for_port=8000)
sandboxes.pause_sandbox(sandbox.sandbox_id)  # mémoire, processus et disque gardés sur son serveur

# Cet appel la réveille, et le même processus serveur répond.
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'   # la réveille

Ce que coûte une sandbox en pause

Une sandbox en pause est facturée à la seconde entière, à 30 % du prix d’exécution de sa taille, sans minimum : 0,0054 $ de l’heure pour SMALL, jusqu’à 0,0432 $ pour XLARGE. Le temps d’exécution n’est jamais converti en temps de pause, et aucune seconde n’est comptée deux fois. Quand nous redémarrons la machine d’un serveur, ses sandboxes actives sont mises en pause puis reprises après, et ces secondes ne coûtent rien.

Pause ou arrêt

L’arrêt est l’autre façon de garder une sandbox dont vous ne vous servez pas. La pause la garde prête ; l’arrêt la garde bon marché :

En pauseArrêtée
Où elle estSur le disque de son serveurEn stockage objet
Ce qui est gardéMémoire, processus et disqueLe disque ; les processus prennent fin
Prix, SMALL0,0054 $ de l’heure0,03 $ par GiB et par mois de ses propres données
Retour à l’exécution0,1 s environ, au prochain appel0,2 s environ par resume_sandbox, ou 10 s environ par GiB quand son disque doit être rapatrié

Par défaut, une sandbox s’arrête après 30 minutes d’inactivité, en pause ou non ; le cycle de vie explique comment changer cela.

Limites

La taille d’une sandbox en pause ne peut pas changer : une nouvelle taille est refusée tant qu’elle n’est pas reprise ou arrêtée. Ses vCPU comptent dans le budget de votre offre pendant la pause, comme ceux d’une sandbox active. Quand le disque de son serveur vient à manquer, les sandboxes en pause inactives depuis le plus longtemps sont arrêtées plus tôt, leurs disques gardés, et state_message le dit. Quand la consommation incluse et le solde d’un espace de travail sont tous deux épuisés, ses sandboxes en pause sont arrêtées.

Face aux autres

D’après leurs pages au 21 novembre 2026 : E2B garde aussi la mémoire et ne facture rien pendant la pause, mais facture 2 vCPU et 4 GiB 0,1656 $ de l’heure en exécution, contre 0,018 $ ici, et sa documentation annonce environ 4 secondes par GiB de mémoire pour une pause et environ 1 seconde pour une reprise. Daytona ne met en pause que sa classe de VM Linux, et ne facture que le disque pendant la pause. boat.dev n’a pas de pause : un arrêt supprime la VM et garde son disque.

Lire la documentation

Questions

Mettre en pause puis reprendre une sandbox garde-t-il ses processus en cours ?

Oui, avec sa mémoire et son disque. Pendant la pause, ses processus sont figés avec le reste de sa mémoire, et ils repartent d’où ils étaient au réveil. Une commande lancée avec keep_awake empêche la sandbox de se mettre en pause tant qu’elle tourne, pour un build ou une tâche que personne n’attend.

Combien coûte une sandbox en pause ?

30 % de son prix d’exécution, à la seconde : 0,0054 $ de l’heure pour SMALL, 0,0108 $ pour DEFAULT, 0,0216 $ pour LARGE et 0,0432 $ pour XLARGE.

Un réveil peut-il échouer faute de place ?

Non : une sandbox en pause garde sa place sur son serveur. Un réveil n’est refusé que si l’espace de travail occupe plus de vCPU que son offre n’en permet désormais, après un passage à une offre plus petite par exemple.

Faut-il mettre une sandbox en pause ou l’arrêter ?

Mettez en pause ce à quoi vous reviendrez bientôt : elle garde mémoire et processus à 30 % du prix d’exécution et repart en 0,1 s environ. Arrêtez ce qui peut attendre : ses processus prennent fin, son disque est gardé en stockage objet à 0,03 $ par GiB et par mois, et un démarrage la relance depuis ce disque.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit