Skills

Vercel Sandbox : exécuter du code arbitraire dans une VM Linux isolée et éphémère

Pour les tâches qui doivent exécuter du code arbitraire dans une VM Linux isolée et éphémère. Délai par défaut 5 minutes ; Hobby max 45 minutes ; Pro/Enterprise max 24 heures.

Official source · Vercel Sandbox

Install

npx skills add vercel/sandbox

À qui ça s'adresse

Ouvrez cette Skill quand il faut exécuter du code arbitraire dans une VM Linux isolée et éphémère. La phrase officielle : Vercel Sandbox allows you to run arbitrary code in isolated, ephemeral Linux VMs. Le titre du dépôt dit qu'elle sert à exécuter en sécurité du code non fiable ou généré par l'utilisateur.

Ce n'est pas un manuel de calcul général. La Skill donne des motifs de code, des notes de pratique et une référence API pour le SDK @vercel/sandbox. Elle convient à qui a déjà choisi Vercel Sandbox et veut qu'un agent rassemble les points d'appel du SDK officiel. Si la tâche n'a pas besoin de VM isolée, cette Skill ne colle pas.

Page :

https://github.com/vercel/sandbox

Premier essai en 3 minutes

Prendre uniquement la commande d'installation Skill officielle. Ne pas choisir un autre chemin d'installation principal en même temps :

npx skills add vercel/sandbox

Prérequis : la tâche courante est bien « exécuter du code arbitraire dans une VM Linux isolée et éphémère », et l'environnement d'agent courant peut exécuter la commande npx skills add ci-dessus. Le texte officiel n'écrit pas de répertoire de destination ; n'inventez pas un chemin absent.

Après installation, d'abord un contrôle en lecture seule. Ne pas créer de bac à sable et ne pas changer les fichiers du projet. Demander à l'agent : selon la Sandbox Skill, que peut configurer l'option timeout de Sandbox.create(), et quelles sont la durée par défaut et les plafonds de forfait. Succès observable : l'agent dit défaut 5 minutes, Hobby max 45 minutes, Pro/Enterprise max 24 heures, et que ces durées s'ajustent via timeout sur Sandbox.create(). S'il répète seulement « ça peut exécuter du code » sans ces chiffres, il n'a pas encore utilisé cette Skill ; relancer la même commande d'installation et redemander.

Cas d'usage

Cas 1 : faire rassembler par l'agent les points d'appel @vercel/sandbox d'après la Skill. La page écrit que la Skill donne comprehensive guidance on using the @vercel/sandbox SDK, including code patterns, best practices, and API reference. Lui donner « exécuter un morceau de code arbitraire dans une VM Linux isolée et éphémère » et exiger qu'il liste, d'après la Skill seulement, le nom SDK et les motifs à vérifier à la création, et qu'il marque les champs absents de la page. Résultat vérifiable : la réponse reste autour de @vercel/sandbox et Sandbox.create(), sans inventer une autre commande d'installation.

Cas 2 : vérifier ressources et durée avant de créer. Plafonds officiels : Hobby/Pro jusqu'à 8 vCPU, Enterprise jusqu'à 32 vCPU, chaque vCPU correspondant à 2048 MB de mémoire ; bac à sable par défaut 5 minutes, Hobby max 45 minutes, Pro/Enterprise max 24 heures, ajustable avec timeout. Convient à un contrôle de capacité avant de vraiment lever une VM : la tâche doit-elle dépasser les 5 minutes par défaut, touchera-t-elle le plafond 45 minutes de Hobby. La page ne donne ni étapes de console ni actions de facturation ; le contrôle s'arrête à ces chiffres.

Limites d'usage

C'est une VM Linux éphémère et isolée, pas un hôte permanent ; la page ne promet pas que les fichiers locaux resteront.

Ressources écrites : Hobby/Pro 8 vCPU, Enterprise 32 vCPU, 2048 MB de mémoire par vCPU. Disque, réseau sortant et concurrence n'apparaissent pas ; ne pas combler les manques.

Durée par défaut 5 minutes ; Hobby max 45 minutes ; Pro/Enterprise max 24 heures. Pour une occupation au-delà de cette fenêtre, la page ne donne pas de méthode.

La Skill couvre motifs, pratiques et référence API de @vercel/sandbox. Elle ne liste pas de clients ; n'écrivez pas qu'un seul agent est pris en charge.

La même page donne aussi la commande d'installation SDK pnpm i @vercel/sandbox. C'est l'installation du paquet SDK, pas un second chemin principal Skill ; au premier essai, ne pas la placer à côté de npx skills add vercel/sandbox. Le texte officiel n'écrit pas d'autres gestionnaires de paquets ni d'installation marketplace.

La page ne décrit ni liaison de projet, ni variables d'environnement, ni saisie de secrets ; n'inventez pas d'étapes absentes.