Présentation de Claude Managed Agents
Harnais d'agent préconstruit et configurable qui s'exécute dans une infrastructure gérée. Idéal pour les tâches de longue durée et le travail asynchrone.
Anthropic propose deux façons de développer avec Claude, chacune adaptée à des cas d'usage différents :
| Messages API | Claude Managed Agents | |
|---|---|---|
| Ce que c'est | Accès direct au prompting du modèle | Harnais d'agent préconstruit et configurable qui s'exécute dans une infrastructure gérée |
| Idéal pour | Boucles d'agent personnalisées et contrôle précis | Tâches de longue durée et travail asynchrone |
Claude Managed Agents fournit le harnais et l'infrastructure nécessaires pour exécuter Claude en tant qu'agent autonome. Au lieu de construire votre propre boucle d'agent, votre exécution d'outils et votre environnement d'exécution, vous disposez d'un environnement entièrement géré dans lequel Claude peut lire des fichiers, exécuter des commandes, naviguer sur le web et exécuter du code en toute sécurité. Le harnais prend en charge nativement le « prompt caching » (mise en cache des prompts), la compaction et d'autres optimisations de performance pour des résultats d'agent efficaces et de haute qualité. Pour construire votre propre boucle d'agent avec un accès direct au modèle, consultez Utilisation de l'API Messages.
Créez votre première session d'agent
Créez une session et envoyez votre premier événement
Types d'événements, limites de débit, options CLI et autres tables de référence
Concepts fondamentaux
Claude Managed Agents s'articule autour de quatre concepts :
| Concept | Description |
|---|---|
| Agent | Le modèle, l'invite système, les outils, les serveurs MCP et les compétences |
| Environnement | Configuration de l'endroit où les sessions s'exécutent : un bac à sable cloud géré par Anthropic, ou un bac à sable auto-hébergé sur votre propre infrastructure |
| Session | Une instance d'agent en cours d'exécution au sein d'un environnement, effectuant une tâche spécifique et générant des sorties |
| Événements | Messages échangés entre votre application et l'agent (tours de l'utilisateur, résultats d'outils, mises à jour de statut) |
Fonctionnement
Créer un agent
Définissez le modèle, l'invite système, les outils, les serveurs MCP et les skills. Créez l'agent une seule fois et référencez-le par son ID d'une session à l'autre.
Créer un environnement
Configurez l'endroit où l'agent s'exécute : un sandbox cloud, ou un sandbox auto-hébergé sur votre propre infrastructure.
Démarrer une session
Lancez une session qui référence la configuration de votre agent et de votre environnement.
Envoyer des événements et recevoir les réponses en streaming
Envoyez les messages utilisateur sous forme d'événements. Claude exécute les outils de manière autonome et renvoie les résultats en streaming via des « server-sent events » (événements envoyés par le serveur), ou SSE. L'historique des événements est conservé côté serveur et peut être récupéré dans son intégralité.
Orienter ou interrompre
Envoyez des événements utilisateur supplémentaires pour guider l'agent en cours d'exécution, ou interrompez-le pour changer de direction.
Quand utiliser Claude Managed Agents
Claude Managed Agents convient particulièrement aux charges de travail qui nécessitent :
- Une exécution de longue durée : des tâches qui s'exécutent pendant des minutes ou des heures avec de multiples appels d'outils
- Une infrastructure cloud : des sandbox sécurisés avec des paquets préinstallés et un accès réseau
- Une exécution auto-hébergée : des sandbox sur une infrastructure que vous contrôlez, pour répondre à des exigences de conformité ou de résidence des données
- Une infrastructure minimale : nul besoin de construire votre propre boucle d'agent, votre sandbox ou votre couche d'exécution d'outils
- Des sessions avec état : des systèmes de fichiers et un historique de conversation persistants sur plusieurs interactions
- Une exécution planifiée : des exécutions d'agent récurrentes selon une planification cron grâce aux déploiements planifiés
Outils pris en charge
Claude Managed Agents donne à Claude accès à un ensemble d'outils intégrés :
- Bash : exécuter des commandes shell dans le sandbox
- Opérations sur les fichiers : lire, écrire, modifier, rechercher par glob et par grep des fichiers dans le sandbox
- Recherche et récupération web : effectuer des recherches sur le web et récupérer le contenu d'URL, avec une restriction facultative à une liste d'autorisation ou de blocage de domaines
- Serveurs MCP : se connecter à des fournisseurs d'outils externes
Consultez Outils pour la liste complète et les options de configuration.
Accès bêta
Pour commencer, vous avez besoin :
- D'une clé API Claude
- De l'en-tête bêta
managed-agents-2026-04-01sur toutes les requêtes - D'un accès à Claude Managed Agents (activé par défaut pour tous les comptes API)
Au sein de la bêta, les tunnels MCP et le dreaming font l'objet d'un aperçu de recherche plus restreint. Demandez l'accès pour les activer.
Claude Managed Agents est conçu pour être avec état : les sessions sont de longue durée, reprennent proprement après une pause et stockent côté serveur l'historique de conversation, l'état du sandbox et les résultats. Pour cette raison, Managed Agents n'est actuellement pas éligible à la Zero Data Retention (conservation zéro des données) ni à la couverture d'un « Business Associate Agreement » (accord de partenariat commercial) HIPAA, ou BAA. Vous gardez le contrôle de ces données : vous pouvez supprimer des sessions, et supprimer séparément tous les fichiers que vous avez téléversés, à tout moment via l'API. Pour connaître l'éligibilité de l'ensemble des fonctionnalités, consultez API et conservation des données.
Consultez Limites de débit et Directives relatives à la marque dans la référence.
Was this page helpful?