Claude Platform Docs
Managed AgentsManaged Agents auto-hébergé

Claude Managed Agents auto-hébergé

Hébergez le service Claude Managed Agents et ses sandboxes sur votre propre infrastructure. Découvrez qui héberge chaque partie, quand choisir cette option et par où commencer.

Claude Managed Agents auto-hébergé est Managed Agents sur votre propre infrastructure, qui peut être un compte cloud ou un centre de données sur site. Vous hébergez le service et les sandboxes. Le modèle s’exécute chez Anthropic ou chez un fournisseur que vous choisissez.

Managed Agents comporte deux parties que vous pouvez héberger :

  • Sandboxes : les conteneurs, les VM ou d’autres espaces de travail isolés où les outils d’un agent exécutent des commandes et travaillent sur des fichiers. Consultez Sandboxes auto-hébergées.
  • Le service : l’API, la boucle de l’agent et le stockage des agents, des sessions et de l’historique des sessions.

Les sandboxes auto-hébergées vous transfèrent la première partie. Managed Agents auto-hébergé étend cette configuration : vous hébergez également le service. Le nom de chaque option indique ce que vous hébergez :

OptionSandboxesServiceModèle
Sandboxes cloud (par défaut)AnthropicAnthropicAnthropic
Sandboxes auto-hébergéesVousAnthropicAnthropic
Managed Agents auto-hébergéVousVousAnthropic, ou un fournisseur que vous choisissez

Sur ces pages, le service hébergé désigne le service tel qu’Anthropic l’exécute, et votre serveur désigne le service tel que vous l’exécutez, avec sa propre base de données. Tous deux disposent de la même API, de sorte que le SDK et la CLI ant fonctionnent avec votre serveur, et le reste de la documentation de Managed Agents s’applique. Différences avec le service hébergé répertorie les exceptions.

Vous découvrez Claude Managed Agents ?

Claude Managed Agents exécute Claude en tant qu’agent autonome : vous définissez un agent, démarrez une session et échangez des événements avec l’agent pendant qu’il travaille. Concepts fondamentaux explique les agents, les environnements, les sessions et les événements. Vous n’avez pas besoin d’utiliser d’abord le service hébergé.

Quand choisir Managed Agents auto-hébergé

Choisissez Managed Agents auto-hébergé lorsque vous avez besoin de l’un des éléments suivants :

  • Stockage sur votre infrastructure : vous devez stocker vous-même les agents, les sessions et l’historique des sessions.
  • Le choix de votre fournisseur d’inférence : les appels au modèle doivent être adressés à Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry ou votre propre passerelle de modèles. Consultez Fournisseur d’inférence.

Si vous avez uniquement besoin que les outils s’exécutent sur votre infrastructure, utilisez les sandboxes auto-hébergées, où Anthropic exécute le service. Consultez Choisir un environnement d’agent.

Avec Managed Agents auto-hébergé, vous exécutez et sécurisez un serveur, sa base de données et vos sandboxes, et vous installez vous-même chaque version. Certaines fonctionnalités n’existent que sur le service hébergé ; consultez donc Différences avec le service hébergé avant de décider.

Ce qui s’exécute où

Un ou plusieurs serveurs, leur base de données et vos sandboxes forment un déploiement.

  • Serveur (cma-server) : sert l’API, exécute la boucle de l’agent et stocke les agents, les sessions et l’historique de chaque session. Il appelle votre fournisseur d’inférence chaque fois que l’agent a besoin du modèle. Le serveur n’exécute jamais les outils shell ou fichiers d’un agent.
  • Base de données : PostgreSQL 16 ou version ultérieure. Sans base de données, le serveur conserve ses données en mémoire, et un redémarrage les efface.
  • Workers : programmes qui récupèrent du travail auprès du serveur et exécutent les outils shell et fichiers de l’agent dans vos sandboxes. Un worker est une commande ant beta:worker ou un worker du SDK.
  • Vos applications : votre propre code et vos scripts, qui accèdent au serveur avec le SDK ou la CLI ant.
  • Console de votre serveur : une page web à l’adresse du serveur, où les utilisateurs se connectent via votre fournisseur d’identité pour créer des agents et exécuter des sessions. Consultez Utiliser la console de votre serveur.
  • CLI d’administration (cma-server-admin) : crée les environnements et leurs clés d’environnement. Elle s’exécute sous Linux (x86-64 et Arm) et sous macOS sur Apple silicon.

Vos responsabilités en matière de sécurité

Le Modèle de sécurité des sandboxes auto-hébergées s’applique ici, à deux différences près. Ce que cette page attribue à Anthropic relève de votre responsabilité, y compris la sécurisation du serveur, l’hébergement des magasins de mémoire et la détection d’une utilisation inhabituelle. Cette page suggère également un espace de travail et un environnement distincts pour chaque limite de confiance. Ici, chaque niveau de confiance nécessite son propre déploiement, comme l’explique Multilocation.

Les trois identifiants

IdentifiantQui le détientCe qu’il authentifie
Clé API du serveurVos applications, la CLI ant et la CLI d’administrationLes requêtes adressées à votre serveur. La configuration génère cette clé. Elle joue le rôle que joue une clé API Claude avec le service hébergé.
Identifiant d’inférenceLe serveurLes appels au modèle du serveur vers votre fournisseur d’inférence. Par exemple, il peut s’agir d’une clé API Claude, de l’identifiant de votre fournisseur cloud ou du jeton qu’accepte votre passerelle de modèles. Les applications et les workers n’en ont pas besoin.
Clé d’environnementVos workers qui interrogent le serveurLa file de travail d’un environnement et les sessions de cet environnement.

Ce qui quitte votre réseau

Pour chaque appel au modèle, le serveur envoie la conversation jusqu’à ce point, y compris les entrées et les résultats des outils, à votre fournisseur d’inférence. Par défaut, il s’agit de l’API Claude. Un appel à l’API Claude transmet également les identifiants de sa session ainsi que ceux de l’agent et de l’environnement de cette session. Données et accès dans Claude Managed Agents auto-hébergé répertorie chaque connexion qu’établit le serveur. Cette page indique également où vont les journaux et qui peut accéder au serveur.

Par où commencer

Pour demander l’accès au téléchargement, contactez l’équipe de votre compte Anthropic. Suivez ensuite Démarrer avec Claude Managed Agents auto-hébergé pour démarrer un serveur et exécuter une première session.

L’archive de chaque version inclut un guide de l’opérateur propre à cette version, operator-guide.md. Demandez à Claude de lire ce fichier afin qu’il puisse vous aider à configurer et à exécuter votre serveur, ainsi qu’à écrire du code qui s’y connecte.

Cette page vous a-t-elle été utile ?