---
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
  zdr:
    eligibility: not-eligible
    note: Non éligible à la ZDR, sauf pour Managed Agents auto-hébergé. Les sessions sont des ressources avec état ; les transcriptions persistent jusqu’à ce que vous les supprimiez.
  supportedModels:
    - claude-fable-5-2
    - claude-mythos-5-2
    - claude-fable-5-1
    - claude-mythos-5-1
    - claude-fable-5
    - claude-mythos-5
    - claude-mythos-preview
    - claude-opus-5-5
    - claude-opus-5
    - claude-sonnet-5-5
    - claude-sonnet-5
    - claude-haiku-5-5
    - claude-haiku-4-5-20251001
    - claude-opus-4-8
    - claude-opus-4-7
    - claude-opus-4-6
    - claude-sonnet-4-6
    - claude-opus-4-5-20251101
    - claude-sonnet-4-5-20250929
  supportedPlatforms:
    Claude API: beta
    Claude Platform on AWS: beta
    Claude Models on Google Cloud (Anthropic managed): beta
---

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).

<Note>
  Claude Managed Agents est également disponible sur Claude Models on Google Cloud (Anthropic managed) et Claude Platform on AWS, avec quelques différences dans la disponibilité des fonctionnalités et le comportement des sessions. Consultez le guide [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/anthropic-managed#claude-managed-agents) ou [Claude Managed Agents](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws#claude-managed-agents) dans le guide Claude Platform on AWS.
</Note>

<CardGroup cols={3}>
  <Card title="Démarrage rapide" icon="play" href="https://platform.claude.com/docs/fr/managed-agents/quickstart">
    Créez votre première session d’agent
  </Card>

  <Card title="Démarrer une session" icon="code-brackets" href="https://platform.claude.com/docs/fr/managed-agents/sessions">
    Créez une session et envoyez votre premier événement
  </Card>

  <Card title="Référence" icon="book" href="https://platform.claude.com/docs/fr/managed-agents/reference">
    Types d’événements, limites de débit, options CLI et autres tables de référence
  </Card>
</CardGroup>

## 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

<Steps>
  <Step title="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.
  </Step>

  <Step title="Créer un environnement">
    [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.
  </Step>

  <Step title="Démarrer une session">
    Lancez une session qui référence la configuration de votre agent et de votre environnement.
  </Step>

  <Step title="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. Le service Managed Agents conserve l’historique des événements, et vous pouvez le récupérer dans son intégralité.
  </Step>

  <Step title="Orienter ou interrompre">
    Envoyez des événements utilisateur supplémentaires pour guider l’agent pendant son exécution, ou interrompez-le pour changer de direction.
  </Step>
</Steps>

## 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
* **Un service auto-hébergé :** l’intégralité du service Managed Agents sur votre propre infrastructure, grâce à [Claude Managed Agents auto-hébergé](https://platform.claude.com/docs/fr/managed-agents/self-hosted)
* **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

<Note>
  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. Anthropic peut affiner les comportements entre les versions afin d’améliorer les résultats.
</Note>

Pour commencer, vous avez besoin :

1. D’une [clé API Claude](https://platform.claude.com/settings/keys) provenant de la Claude Console.
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 les [rêves](https://platform.claude.com/docs/fr/managed-agents/dreams) font l’objet d’un aperçu de recherche plus restreint. Pour les activer, [demandez l’accès à l’aperçu de recherche](https://claude.com/form/claude-managed-agents).

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. L’exception pour la Zero Data Retention est Claude Managed Agents auto-hébergé, où vous stockez vous-même ces données, comme le décrit [Durée de conservation des données](https://platform.claude.com/docs/fr/managed-agents/self-hosted-data-and-access#how-long-data-is-kept). 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.

## Disponibilité

Managed Agents sont en bêta sur tous les modèles.

### Prise en charge de l’API

| Statut | Plateformes cloud | Modèles |
| ----- | ----- | ----- |
| Bêta | Claude API, [Claude Platform on AWS](https://platform.claude.com/docs/fr/build-with-claude/claude-platform-on-aws), [Claude Models on Google Cloud (Anthropic managed)](https://platform.claude.com/docs/fr/build-with-claude/claude-models-on-google-cloud/anthropic-managed) | [Tous les modèles](https://platform.claude.com/docs/fr/models/overview) |

### En-têtes bêta requis

[Présentation des en-têtes bêta](https://platform.claude.com/docs/fr/api/beta-headers)

Les en-têtes bêta vous permettent d’accéder à des fonctionnalités expérimentales et à de nouvelles capacités des modèles avant qu’elles ne fassent partie de l’API standard.

* `managed-agents-2026-04-01`

### Traitement des données

[Présentation du traitement des données](https://platform.claude.com/docs/fr/manage-claude/api-and-data-retention#feature-eligibility)

| Élément | Zéro conservation des données | HIPAA |
| ----- | ----- | ----- |
| Statut | Non éligible | Non éligible |
| Détails | Non éligible à la ZDR, sauf pour Managed Agents auto-hébergé. Les sessions sont des ressources avec état ; les transcriptions persistent jusqu’à ce que vous les supprimiez. [En savoir plus](https://platform.claude.com/docs/fr/managed-agents/self-hosted-data-and-access#how-long-data-is-kept) | Non éligible à HIPAA. S’applique à toutes les sous-fonctionnalités de Managed Agents. |

Points de terminaison concernés :

* `/v1/agents`
* `/v1/sessions`
* `/v1/environments`
