Choisir un environnement d'agent
Décidez si les outils et le code de Claude Managed Agents s'exécutent dans un environnement cloud géré par Anthropic ou dans un sandbox auto-hébergé, et découvrez ce qui change si vous passez de l'un à l'autre.
Un environnement détermine où s'exécutent les outils et le code de votre agent. Ils s'exécutent dans un « sandbox » (bac à sable). Un sandbox est un espace de travail isolé, tel qu'un conteneur, dans lequel l'agent exécute des commandes et travaille sur des fichiers. Vous disposez de deux options :
- Environnement cloud : Anthropic exécute le sandbox pour vous. Chaque session obtient son propre conteneur Linux neuf sur une infrastructure gérée par Anthropic, avec les langages, bases de données et utilitaires courants déjà installés. Vous choisissez ses règles réseau et les éventuels paquets supplémentaires à installer.
- Sandbox auto-hébergé : Vous exécutez le sandbox sur votre propre infrastructure. Claude s'exécute toujours du côté d'Anthropic et décide quel outil appeler ensuite. Un programme que vous exécutez, appelé « worker » (processus de travail), effectue les appels aux outils bash et de fichiers de l'agent sur vos machines et renvoie chaque résultat. Il peut également servir des outils personnalisés.
La définition de l'agent est la même quelle que soit l'option choisie. Vous définissez le modèle, le prompt et les outils sur l'agent, et non sur l'environnement.
Commencer avec un environnement cloud
Si vous ne savez pas quelle option choisir, ou si vous découvrez Claude Managed Agents, commencez avec un environnement cloud, comme le fait le guide de démarrage rapide. Anthropic exécute un conteneur isolé pour chaque session, avec les langages et outils courants déjà installés, vous n'avez donc rien à héberger. Choisissez un sandbox auto-hébergé uniquement si les outils doivent s'exécuter sur une infrastructure que vous contrôlez.
Comparer les options
Le tableau compare les deux options.
| Environnement cloud (par défaut) | Sandbox auto-hébergé | |
|---|---|---|
| Où s'exécutent les outils et le code | Un sandbox géré par Anthropic | Votre worker, sur votre infrastructure |
| Ce qui parvient à Anthropic | L'historique de conversation, les résultats des outils, les fichiers et l'état du sandbox, les skills et les magasins de mémoire | L'historique de conversation, les résultats des outils, les skills et les magasins de mémoire. Les fichiers et processus du sandbox restent sur votre worker. |
| Ce que vous exploitez | Rien | Les hôtes des workers, leur durcissement, leurs limites réseau et la clé d'environnement avec laquelle votre worker s'authentifie |
| Portée réseau | Les règles réseau que vous définissez sur l'environnement | Votre propre politique réseau |
| Montage de fichiers et de dépôts GitHub | Géré par Anthropic | Géré par vous |
| Magasins de mémoire | Montés par Anthropic dans /mnt/memory/ | Téléchargés dans /mnt/memory/ et synchronisés par le worker |
| Cycle de vie du sandbox | Géré par Anthropic | Géré par vous |
| Choisissez-le lorsque | C'est l'option par défaut. Vous n'avez pas besoin que les outils s'exécutent sur votre propre infrastructure. | Les outils doivent s'exécuter sur une infrastructure que vous contrôlez. |
Quand choisir un sandbox auto-hébergé
Un sandbox auto-hébergé convient lorsque l'agent doit effectuer l'une des actions suivantes :
- Travailler sur des données qui ne peuvent pas quitter votre réseau : Les fichiers et processus de l'agent restent sur votre worker. Ce qu'un outil renvoie au modèle parvient tout de même au service Managed Agents.
- Atteindre des services internes qui ne sont pas routables publiquement : Les outils bash et de fichiers de l'agent, ainsi que tous les outils personnalisés servis par votre worker, s'exécutent au sein de votre réseau. C'est Anthropic, et non votre worker, qui se connecte aux serveurs MCP de l'agent. Un serveur privé peut se trouver devant votre système de tickets interne ou le wiki de votre entreprise. Pour l'atteindre, vous pouvez utiliser un tunnel MCP avec l'une ou l'autre option. Les tunnels MCP sont en aperçu de recherche et nécessitent une demande d'accès. Consultez Sandboxes auto-hébergés et tunnels MCP.
- S'exécuter sous les propres contrôles de conformité et d'audit de votre organisation : Les outils s'exécutent sur des hôtes que vous configurez, journalisez et auditez.
Ce qu'un sandbox auto-hébergé ne change pas
Avec l'une ou l'autre option, l'historique de conversation et les résultats des outils sont envoyés au service Managed Agents, exploité par Anthropic. C'est ainsi que le modèle reçoit le résultat de chaque appel d'outil. Les outils de recherche web et de récupération web s'exécutent également du côté d'Anthropic, et non dans le sandbox. Consultez Restreindre les domaines de recherche web et de récupération web. Aucune des deux options ne modifie la couverture de conformité de Managed Agents ni la durée de conservation de l'historique de conversation. Consultez API et conservation des données.
Ce que vous prenez en charge et ce à quoi vous renoncez avec un sandbox auto-hébergé
Un sandbox auto-hébergé fait de vous l'opérateur des hôtes des workers. Vous durcissez l'image du sandbox, contrôlez le trafic réseau sortant, stockez et renouvelez la clé d'environnement, et isolez les sessions les unes des autres. La page Modèle de sécurité fournit les détails.
Vous renoncez également à ces fonctionnalités de l'environnement cloud :
- Les ressources de session
fileetgithub_repository. Vous préparez vous-même les fichiers d'entrée, et vous êtes également responsable du montage de votre propre dépôt GitHub. - La découverte de skills dans un dépôt.
- Les identifiants sous forme de variables d'environnement dans les coffres.
- Les environnements d'exécution et paquets préinstallés d'un sandbox cloud. Un sandbox auto-hébergé dispose de ce que votre worker fournit.
Différences sur Claude Platform on AWS
Si vous utilisez Claude Managed Agents via Claude Platform on AWS, Anthropic exploite toujours le service. Dans ce cas, un sandbox auto-hébergé ne peut pas utiliser de magasins de mémoire, les workers n'utilisent pas de clé d'environnement et les tunnels MCP ne sont pas disponibles. Consultez Claude Managed Agents sur Claude Platform on AWS et Fonctionnalités non prises en charge.
Passer d'un environnement cloud à un sandbox auto-hébergé
Pour passer à un sandbox auto-hébergé, vous conservez l'agent, créez un environnement self_hosted et référencez son ID dans les nouvelles sessions et les nouveaux déploiements.
- Ce qui est conservé : La définition de l'agent, la clé API ou les identifiants AWS utilisés par votre application, vos skills, vos serveurs MCP et vos magasins de mémoire.
- Ce qui est nouveau : Un environnement
self_hosted, une clé d'environnement que vous générez dans la Claude Console, et un worker que vous exécutez. Le guide de démarrage rapide des sandboxes auto-hébergés couvre ces trois éléments. - Ce qui cesse de fonctionner : Les fonctionnalités répertoriées dans Ce que vous prenez en charge et ce à quoi vous renoncez avec un sandbox auto-hébergé.
Sur Claude Platform on AWS, les magasins de mémoire ne sont pas conservés lors du passage à un sandbox auto-hébergé, et le worker n'utilise pas de clé d'environnement. Consultez Différences sur Claude Platform on AWS.
Was this page helpful?