Référence
Types d'événements, options CLI du worker auto-hébergé, types de serveurs MCP pris en charge, limites de débit et directives de marque pour Claude Managed Agents.
Cette page rassemble la documentation de référence pour Claude Managed Agents. Pour des guides orientés tâches, suivez les liens de chaque section. Pour les opérations sur la ressource de session, consultez Opérations de session.
Types d'événements
Les chaînes de types d'événements persistés suivent une convention de nommage {domain}.{action} ; les deltas d'événements uniquement diffusés en streaming (voir l'onglet Deltas d'événements) constituent l'exception. Consultez Flux d'événements de session pour l'envoi, le streaming et le listage des événements. Les types d'événements de webhook sont listés séparément dans S'abonner aux webhooks, et certains de leurs noms diffèrent de ceux du flux (par exemple, session.status_idled plutôt que session.status_idle).
| Type | Description |
|---|---|
user.message | Un message utilisateur avec du contenu texte, image ou document. |
user.interrupt | Arrête l'agent en cours d'exécution. |
user.custom_tool_result | Réponse à un appel d'outil personnalisé de l'agent. |
user.tool_confirmation | Approuve ou refuse un appel d'outil d'agent ou MCP lorsqu'une politique d'autorisation exige une confirmation. |
user.define_outcome | Définit un résultat attendu vers lequel l'agent doit travailler. |
user.tool_result | Pour les sessions avec des environnements self_hosted uniquement, votre intégration est responsable de fournir les résultats agent_toolset. Les assistants du SDK et la CLI le font automatiquement. |
Worker auto-hébergé
Voici les options CLI ant beta:worker pour le worker préconstruit qui pilote un environnement self_hosted. Consultez Sandboxes auto-hébergées pour configurer l'environnement, exécuter un worker et connaître les options des assistants du SDK.
| Option | Description |
|---|---|
--environment-id | L'environnement à interroger pour obtenir du travail. Lit également ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Authentifie le worker auprès de cet environnement. Lit également ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Répertoire où les skills sont téléchargées et où les outils lisent et écrivent des fichiers. Par défaut . (le répertoire courant) ; le répertoire de travail par défaut du système est /workspace. |
--on-work | Script à appeler pour chaque élément de travail réclamé au lieu d'exécuter les outils dans le processus. Reçoit les détails de la session sous forme de variables d'environnement. |
--unrestricted-paths | Autorise les outils de fichiers à lire et écrire des chemins en dehors de --workdir. La vérification du workdir est un garde-fou pour les outils de fichiers uniquement, pas une sandbox ; elle ne contraint pas bash. |
--max-idle | Durée d'attente après que la session devient inactive avec une raison d'arrêt end_turn avant l'arrêt. Par défaut 60s. |
--log-format | Format de sortie des journaux. Utilisez json pour l'ingestion de journaux structurés. Par défaut text. |
Le worker CLI ne monte pas les magasins de mémoire : une session qui en attache un s'exécute toujours, mais l'agent ne trouve rien au mount_path du magasin et aucune modification n'est synchronisée vers le magasin. Pour utiliser des magasins de mémoire dans des sessions sur un environnement auto-hébergé, exécutez plutôt le worker du SDK ; consultez Utiliser les magasins de mémoire.
Types de serveurs MCP pris en charge
Claude Managed Agents se connecte aux serveurs MCP distants qui exposent un point de terminaison HTTP, ou à des serveurs MCP privés via des tunnels MCP. Le serveur doit prendre en charge le transport HTTP streamable du protocole MCP ; les serveurs qui ne prennent en charge que le transport SSE déprécié fonctionnent toujours grâce à un repli automatique. Consultez Connecteur MCP pour déclarer des serveurs sur un agent.
Pour plus d'informations sur MCP et la création de serveurs MCP, consultez la documentation MCP.
Limites de débit
Les points de terminaison Managed Agents sont soumis à des « rate limits » (limites de débit) par organisation :
| Opération | Limite |
|---|---|
| Points de terminaison de création (tels que agents, sessions et environnements) | 300 requêtes par minute |
| Points de terminaison de lecture (tels que récupération, listage et streaming) | 1 200 requêtes par minute |
Les limites de dépenses et limites de débit par niveau d'utilisation au niveau de l'organisation s'appliquent également.
Directives de marque
Pour les partenaires intégrant Claude Managed Agents, l'utilisation de la marque Claude est facultative. Lorsque vous faites référence à Claude dans votre produit :
Autorisé :
- « Claude Agent » (préféré pour les menus déroulants)
- « Claude » (lorsqu'il se trouve dans un menu déjà intitulé « Agents »)
- « {YourAgentName} Powered by Claude » (si vous avez déjà un nom d'agent)
Non autorisé :
- « Claude Code » ou « Claude Code Agent »
- « Claude Cowork » ou « Claude Cowork Agent »
- Art ASCII à la marque Claude Code ou éléments visuels imitant Claude Code
Votre produit doit conserver sa propre marque et ne pas sembler être Claude Code, Claude Cowork ou tout autre produit Anthropic. Pour toute question sur la conformité de la marque, contactez l'équipe commerciale d'Anthropic.
Was this page helpful?