---
title: Présentation de Claude Managed Agents
url: https://platform.claude.com/docs/fr/managed-agents/overview
description: 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.
featureMetadata:
topic:
title: Managed Agents
url: https://platform.claude.com/docs/en/managed-agents/overview
status: beta
betaHeader: managed-agents-2026-04-01
---
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](https://platform.claude.com/docs/fr/build-with-claude/working-with-messages).
Claude Managed Agents est également disponible sur Claude Platform sur AWS, avec quelques différences en matière de disponibilité des fonctionnalités et de comportement des sessions. Consultez [Claude Managed Agents](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws#claude-managed-agents) dans le guide Claude Platform sur AWS.
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
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.
[Configurez l'endroit où l'agent s'exécute](https://platform.claude.com/docs/fr/managed-agents/choosing-an-environment) : un sandbox cloud, ou un [sandbox auto-hébergé](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes) sur votre propre infrastructure.
Lancez une session qui référence la configuration de votre agent et de votre environnement.
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é.
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](https://platform.claude.com/docs/fr/managed-agents/scheduled-deployments)
## 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](https://platform.claude.com/docs/fr/managed-agents/tools) pour la liste complète et les options de configuration.
## Accès bêta
Claude Managed Agents est en version bêta. Tous les points de terminaison Managed Agents nécessitent l'en-tête bêta `managed-agents-2026-04-01`. Le SDK définit automatiquement l'en-tête bêta. Les comportements peuvent être affinés entre les versions afin d'améliorer les résultats.
Pour commencer, vous avez besoin :
1. D'une [clé API Claude](https://platform.claude.com/settings/keys)
2. De l'en-tête bêta `managed-agents-2026-04-01` sur toutes les requêtes
3. 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](https://platform.claude.com/docs/fr/agents-and-tools/mcp-tunnels/overview) et le [dreaming](https://platform.claude.com/docs/fr/managed-agents/dreams) font l'objet d'un aperçu de recherche plus restreint. [Demandez l'accès](https://claude.com/form/claude-managed-agents) 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](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention#zero-data-retention-zdr-scope) (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](https://platform.claude.com/docs/fr/managed-agents/session-operations#deleting-a-session), et supprimer séparément tous les [fichiers](https://platform.claude.com/docs/fr/build-with-claude/files#delete-a-file) 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](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention#feature-eligibility).
Consultez [Limites de débit](https://platform.claude.com/docs/fr/managed-agents/reference#rate-limits) et [Directives relatives à la marque](https://platform.claude.com/docs/fr/managed-agents/reference#branding-guidelines) dans la référence.