Agents gérésRéférence

Référence

Types d'événements, indicateurs 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 dans chaque section. Pour les opérations sur la ressource de session, consultez Opérations de session.

Les requêtes de l'API Managed Agents nécessitent l'en-tête bêta managed-agents-2026-04-01, à l'exception des points de terminaison du magasin de mémoire, qui utilisent agent-memory-2026-07-22 à la place. Le SDK définit automatiquement l'en-tête bêta correct. Consultez En-têtes bêta.

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 réservés au flux (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.

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é provenant de l'agent.
`user.tool_confirmation`	Approuve ou refuse un appel d'outil d'agent ou MCP lorsqu'une politique de permissions exige une confirmation.
`user.define_outcome`	Définit un résultat 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 indicateurs CLI ant beta:worker pour le worker préconstruit qui pilote un environnement self_hosted. Consultez Bacs à sable auto-hébergés pour la configuration de l'environnement, l'exécution d'un worker et les options d'assistance du SDK.

Indicateur	Description
`--environment-id`	L'environnement à interroger pour obtenir du travail. Lit également depuis `ANTHROPIC_ENVIRONMENT_ID`.
`--environment-key`	Authentifie le worker auprès de cet environnement. Lit également depuis `ANTHROPIC_ENVIRONMENT_KEY`.
`--workdir`	Répertoire où les compétences 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 un bac à sable ; elle ne contraint pas bash.
`--max-idle`	Durée d'attente après que la session passe à l'état inactif 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`.

Types de serveurs MCP pris en charge

Claude Managed Agents se connecte à des 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 obsolète 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 limites de débit par organisation :

Opération	Limite
Points de terminaison de création (tels que les agents, les sessions et les environnements)	300 requêtes par minute
Points de terminaison de lecture (tels que la récupération, le listage et le flux)	1 200 requêtes par minute

Les limites de dépenses et les limites de débit par palier 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 existant)

Non autorisé :

« Claude Code » ou « Claude Code Agent »
« Claude Cowork » ou « Claude Cowork Agent »
Art ASCII de marque Claude Code ou éléments visuels qui imitent Claude Code

Votre produit doit conserver sa propre identité de marque et ne pas donner l'impression d'être Claude Code, Claude Cowork ou tout autre produit Anthropic. Pour toute question concernant la conformité de la marque, contactez l'équipe commerciale d'Anthropic.

Was this page helpful?

Agents gérésRéférence

Référence

Types d'événements, indicateurs 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.

Types d'événements

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é provenant de l'agent.
`user.tool_confirmation`	Approuve ou refuse un appel d'outil d'agent ou MCP lorsqu'une politique de permissions exige une confirmation.
`user.define_outcome`	Définit un résultat 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é

Indicateur	Description
`--environment-id`	L'environnement à interroger pour obtenir du travail. Lit également depuis `ANTHROPIC_ENVIRONMENT_ID`.
`--environment-key`	Authentifie le worker auprès de cet environnement. Lit également depuis `ANTHROPIC_ENVIRONMENT_KEY`.
`--workdir`	Répertoire où les compétences 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 un bac à sable ; elle ne contraint pas bash.
`--max-idle`	Durée d'attente après que la session passe à l'état inactif 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`.

Types de serveurs MCP pris en charge

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 limites de débit par organisation :

Opération	Limite
Points de terminaison de création (tels que les agents, les sessions et les environnements)	300 requêtes par minute
Points de terminaison de lecture (tels que la récupération, le listage et le flux)	1 200 requêtes par minute

Les limites de dépenses et les limites de débit par palier 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 existant)

Non autorisé :

« Claude Code » ou « Claude Code Agent »
« Claude Cowork » ou « Claude Cowork Agent »
Art ASCII de marque Claude Code ou éléments visuels qui imitent Claude Code

Was this page helpful?

Types d'événements

Worker auto-hébergé

Types de serveurs MCP pris en charge

Limites de débit

Directives de marque

Types d'événements

Worker auto-hébergé

Types de serveurs MCP pris en charge

Limites de débit

Directives de marque

Types d'événements

Worker auto-hébergé

Types de serveurs MCP pris en charge

Limites de débit

Directives de marque

Types d'événements

Worker auto-hébergé

Types de serveurs MCP pris en charge

Limites de débit

Directives de marque