Agents gérésPremiers pas

Présentation de Claude Managed Agents

Harnais d'agent préconfiguré et personnalisable 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
Description	Accès direct au modèle via des prompts	Harnais d'agent préconfiguré et personnalisable qui s'exécute dans une infrastructure gérée
Idéal pour	Boucles d'agent personnalisées et contrôle granulaire	Tâches de longue durée et travail asynchrone
En savoir plus	Documentation Messages API	Documentation Claude Managed Agents

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 propre exécution d'outils et votre propre environnement d'exécution, vous bénéficiez 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 la mise en cache des prompts intégrée, la compaction et d'autres optimisations de performance pour des sorties d'agent efficaces et de haute qualité.

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 dans le guide Claude Platform sur AWS.

Démarrage rapide

Créez votre première session d'agent

Démarrer une session

Créez une session et envoyez votre premier événement

Référence

Types d'événements, limites de débit, options CLI et autres tableaux de référence

Concepts fondamentaux

Claude Managed Agents repose sur 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 dans 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 compétences. Créez l'agent une seule fois et référencez-le par son ID dans toutes les sessions.
Créer un environnement
Configurez l'emplacement d'exécution de l'agent : un bac à sable cloud ou un bac à sable auto-hébergé sur votre propre infrastructure.
Démarrer une session
Lancez une session qui référence votre configuration d'agent et d'environnement.
Envoyer des événements et diffuser les réponses
Envoyez des 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 bacs à sable sécurisés avec des packages préinstallés et un accès réseau.
Une exécution auto-hébergée : des bacs à sable sur une infrastructure que vous contrôlez pour répondre aux exigences de conformité ou de résidence des données.
Une infrastructure minimale : aucun besoin de construire votre propre boucle d'agent, bac à sable ou couche d'exécution d'outils.
Des sessions avec état : des systèmes de fichiers persistants et un historique de conversation conservé au fil de multiples interactions.
Une exécution planifiée : des exécutions d'agent récurrentes selon un calendrier cron via les 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 bac à sable.
Opérations sur les fichiers : lire, écrire, modifier, rechercher par glob et par grep des fichiers dans le bac à sable.
Recherche et récupération web : effectuer des recherches sur le web et récupérer du contenu à partir d'URL.
Serveurs MCP : se connecter à des fournisseurs d'outils externes.

Consultez Outils pour obtenir la liste complète et les options de configuration.

Accès bêta

Claude Managed Agents est actuellement 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 sorties.

Pour commencer, vous avez besoin de :

Une clé API Claude
L'en-tête bêta managed-agents-2026-04-01 sur toutes les requêtes
L'accès à Claude Managed Agents (activé par défaut pour tous les comptes API)

Dans le cadre 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 des pauses et stockent l'historique des conversations, l'état du bac à sable et les sorties côté serveur. Pour cette raison, Managed Agents n'est actuellement pas éligible à la rétention zéro des données ni à la couverture par un accord d'associé commercial HIPAA (BAA). Vous conservez 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 toutes les fonctionnalités, consultez API et rétention des données.

Consultez Limites de débit et Directives de marque dans la référence.

Was this page helpful?

Agents gérésPremiers pas

Présentation de Claude Managed Agents

Harnais d'agent préconfiguré et personnalisable 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
Description	Accès direct au modèle via des prompts	Harnais d'agent préconfiguré et personnalisable qui s'exécute dans une infrastructure gérée
Idéal pour	Boucles d'agent personnalisées et contrôle granulaire	Tâches de longue durée et travail asynchrone
En savoir plus	Documentation Messages API	Documentation Claude Managed Agents

Démarrage rapide

Créez votre première session d'agent

Démarrer une session

Créez une session et envoyez votre premier événement

Référence

Types d'événements, limites de débit, options CLI et autres tableaux de référence

Concepts fondamentaux

Claude Managed Agents repose sur 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 dans 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 compétences. Créez l'agent une seule fois et référencez-le par son ID dans toutes les sessions.
Créer un environnement
Configurez l'emplacement d'exécution de l'agent : un bac à sable cloud ou un bac à sable auto-hébergé sur votre propre infrastructure.
Démarrer une session
Lancez une session qui référence votre configuration d'agent et d'environnement.
Envoyer des événements et diffuser les réponses
Envoyez des 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 bacs à sable sécurisés avec des packages préinstallés et un accès réseau.
Une exécution auto-hébergée : des bacs à sable sur une infrastructure que vous contrôlez pour répondre aux exigences de conformité ou de résidence des données.
Une infrastructure minimale : aucun besoin de construire votre propre boucle d'agent, bac à sable ou couche d'exécution d'outils.
Des sessions avec état : des systèmes de fichiers persistants et un historique de conversation conservé au fil de multiples interactions.
Une exécution planifiée : des exécutions d'agent récurrentes selon un calendrier cron via les 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 bac à sable.
Opérations sur les fichiers : lire, écrire, modifier, rechercher par glob et par grep des fichiers dans le bac à sable.
Recherche et récupération web : effectuer des recherches sur le web et récupérer du contenu à partir d'URL.
Serveurs MCP : se connecter à des fournisseurs d'outils externes.

Consultez Outils pour obtenir la liste complète et les options de configuration.

Accès bêta

Pour commencer, vous avez besoin de :

Une clé API Claude
L'en-tête bêta managed-agents-2026-04-01 sur toutes les requêtes
L'accès à Claude Managed Agents (activé par défaut pour tous les comptes API)

Dans le cadre 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.

Consultez Limites de débit et Directives de marque dans la référence.

Was this page helpful?

Concepts fondamentaux

Fonctionnement

Quand utiliser Claude Managed Agents

Outils pris en charge

Accès bêta

Concepts fondamentaux

Fonctionnement

Quand utiliser Claude Managed Agents

Outils pris en charge

Accès bêta

Concepts fondamentaux

Fonctionnement

Quand utiliser Claude Managed Agents

Outils pris en charge

Accès bêta

Concepts fondamentaux

Fonctionnement

Quand utiliser Claude Managed Agents

Outils pris en charge

Accès bêta