Claude Managed Agents : harness d'agent managé en production sans infrastructure
Anthropic lance Claude Managed Agents en bêta publique le 8 avril 2026 : environnement d'exécution géré pour agents autonomes avec sandbox, outils intégrés, streaming SSE et persistance. Tarif : $0,08 par heure de runtime.
Depuis l'émergence des agents autonomes, les équipes passent une part significative de leur temps non pas à concevoir la logique métier de leurs agents, mais à construire l'infrastructure autour : boucle d'agent, gestion du contexte, sandboxing d'exécution, retry logic, streaming SSE, persistance d'historique… Le 8 avril 2026, Anthropic répond à ce problème avec le lancement en bêta publique de Claude Managed Agents, un harness d'agent entièrement managé accessible à tous les comptes API.
Ce que ça change concrètement
Claude Managed Agents introduit quatre concepts fondamentaux qui structurent l'exécution des agents :
- Agent : définition du modèle, prompt système, outils, serveurs MCP et skills. Créé une fois, référencé par ID dans toutes les sessions.
- Environment : template de conteneur cloud configuré avec des packages pré-installés (Python, Node.js, Go…), règles d'accès réseau et fichiers montés.
- Session : instance d'agent en cours d'exécution dans un environment, dédiée à une tâche précise.
- Events : messages échangés entre l'application et l'agent (turns utilisateur, résultats d'outils, mises à jour de statut) — persistés côté serveur et récupérables à tout moment.
Les outils built-in disponibles dans chaque session incluent Bash, les opérations fichier (read/write/edit/glob/grep), web search, web fetch et la connexion à des serveurs MCP. Le prompt caching et la compaction de contexte sont gérés automatiquement.
Architecture et workflow
import anthropic
client = anthropic.Anthropic()
# 1. Créer un agent
agent = client.beta.managed_agents.agents.create(
model="claude-opus-4-7",
system="Tu es un assistant d'analyse de code.",
betas=["managed-agents-2026-04-01"],
)
# 2. Créer un environment
env = client.beta.managed_agents.environments.create(
packages=["pandas", "numpy"],
betas=["managed-agents-2026-04-01"],
)
# 3. Démarrer une session et streamer les événements
with client.beta.managed_agents.sessions.stream(
agent_id=agent.id,
environment_id=env.id,
input="Analyse les performances de ce dataset...",
betas=["managed-agents-2026-04-01"],
) as stream:
for event in stream:
print(event)
Le header beta managed-agents-2026-04-01 est requis sur tous les appels. Le SDK Python et TypeScript l'ajoutent automatiquement dès que l'interface beta est utilisée.
Tarification
L'usage du modèle est facturé aux tarifs Claude standards ($5/$25 par million de tokens pour Opus 4.7). La couche infrastructure ajoute $0,08 par heure de runtime d'agent. Pour des tâches courtes (< 1 minute), le surcoût est inférieur à $0,002 par session. Pour des pipelines longs d'analyse de dépôts ou d'audit de code, le modèle économique mérite d'être modélisé : une session de 2 heures ajoute $0,16 d'infra.
Limites et pièges
Le harness est opinionated par conception. Quelques points de vigilance :
- Pas de contrôle fin de sampling :
temperature,top_pettop_kne sont pas exposés dans l'interface Managed Agents (ils sont retirés de Opus 4.7 de toute façon, mais les modèles antérieurs non plus). - Rate limits : 60 requêtes create/minute et 600 read/minute par organisation. Les équipes qui lancent de nombreuses sessions courtes en parallèle peuvent atteindre ces limites.
- Features en research preview : les capacités les plus puissantes — outcomes (auto-évaluation du succès de la tâche), multiagent (sous-agents), et memory (persistance cross-session) — nécessitent une demande d'accès séparée.
- Vendor lock-in : le format d'events SSE et la gestion des environments sont propriétaires à Anthropic. Une migration vers un autre orchestrateur implique un refactoring complet de la couche infrastructure.
Pour les cas d'usage nécessitant un contrôle total (intégration dans LangGraph, gestion d'un event loop custom, multi-fournisseur) ou un budget de tokens très serré, l'API Messages reste plus adaptée. Claude Managed Agents cible les équipes qui veulent aller vite et s'affranchir de l'infrastructure.
La documentation officielle inclut un quickstart et la référence API complète des endpoints /v1/managed-agents/agents, /v1/managed-agents/environments et /v1/managed-agents/sessions.