Français
Menu de la documentation

Documentation de Pethost Agent Sandboxes

Mis à jour le · 3 min de lecture

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.

RUNNING

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

PAUSED

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

STOPPED

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

Le cycle de vie par défaut. Chaque délai se modifie ou se désactive, et une sandbox n’est jamais supprimée sans que vous le demandiez : cycle de vie et inactivité.

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, scp et ssh -L standard (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

Notions

Tâches

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.

Démarrer l’essai gratuit