--- title: Référence url: https://platform.claude.com/docs/fr/managed-agents/reference description: 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. featureMetadata: topic: title: Managed Agents url: https://platform.claude.com/docs/en/managed-agents/overview status: beta betaHeader: managed-agents-2026-04-01 --- 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](https://platform.claude.com/docs/fr/managed-agents/session-operations). ## 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](https://platform.claude.com/docs/fr/managed-agents/events-and-streaming) 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](https://platform.claude.com/docs/fr/managed-agents/webhooks#supported-event-types), 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. Il ne met fin à aucune [exécution de workflow](https://platform.claude.com/docs/fr/managed-agents/workflow-runs#interrupt-a-session-with-runs-open). | | `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](https://platform.claude.com/docs/fr/managed-agents/define-outcomes) vers lequel l'agent doit travailler. | | `user.tool_result` | Pour les sessions avec des [environnements](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes) `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. | | Type | Description | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | Blocs de contenu de la réponse de l'agent. | | `agent.thinking` | Signale que l'agent progresse grâce à la « extended thinking » (réflexion étendue). Il s'agit uniquement d'un signal de progression, qui ne contient pas le contenu de la réflexion. | | `agent.tool_use` | L'agent invoque un outil d'agent prédéfini (bash, opérations sur les fichiers, etc.). Contient `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) et, généralement, `evaluation` (csharp, go: `Evaluation`) (voir [comment chaque appel a été évalué](https://platform.claude.com/docs/fr/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.tool_result` | Résultat de l'exécution d'un outil d'agent prédéfini. | | `agent.mcp_tool_use` | L'agent invoque un outil de serveur MCP. Contient `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) et, généralement, `evaluation` (csharp, go: `Evaluation`) (voir [comment chaque appel a été évalué](https://platform.claude.com/docs/fr/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.mcp_tool_result` | Résultat de l'exécution d'un outil MCP. | | `agent.custom_tool_use` | L'agent invoque l'un de vos outils personnalisés. Répondez avec un événement `user.custom_tool_result`. | | `agent.thread_context_compacted` | L'historique de la conversation a été compacté pour tenir dans la « context window » (fenêtre de contexte). | | `agent.thread_message_received` | Dans une session [multi-agents](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration), un message provenant d'un autre fil est arrivé sur le fil dont le flux transporte cet événement ; sur le fil principal, un agent a envoyé un rapport ou une question à l'agent exécuté par la session. | | `agent.thread_message_sent` | Dans une session [multi-agents](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration), le fil dont le flux transporte cet événement a envoyé un message à un autre fil ; sur le fil principal, l'agent exécuté par la session a envoyé une tâche ou un message de suivi à un autre agent. | Le contenu des messages dans ces événements peut inclure un bloc de contenu `redacted`, `{"type": "redacted"}` : un espace réservé pour du contenu retenu en vertu de la politique de modèle d'Anthropic. Le bloc ne comporte aucun autre champ. Les blocs masqués n'apparaissent que dans le contenu émis par la plateforme ; un événement utilisateur qui en inclut un est rejeté avec une erreur 400. | Type | Description | | ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `session.status_running` | L'agent est en cours de traitement. | | `session.status_idle` | L'agent a terminé sa tâche en cours et attend une entrée. Inclut un `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`) indiquant pourquoi l'agent s'est arrêté. | | `session.status_rescheduled` | Une erreur transitoire s'est produite et la session réessaie automatiquement. | | `session.status_terminated` | La session s'est terminée, soit en raison d'une erreur irrécupérable, soit parce qu'elle a été archivée. | | `session.deleted` | La session a été supprimée. Met fin à tout flux d'événements actif ; aucun autre événement n'est émis pour cette session. | | `session.updated` | Une requête de mise à jour de la session a modifié au moins un champ. Inclut uniquement les champs modifiés. Les mises à jour s'appliquent au tour suivant. | | `session.error` | Une erreur s'est produite pendant le traitement. Inclut un objet `error` (csharp, go: `Error`) typé avec un `retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`). | | `session.usage` | Instantané de l'utilisation cumulée de la session et du coût catalogue suivi. Contient les totaux d'utilisation de la session et, si la session en possède un, son [budget](https://platform.claude.com/docs/fr/managed-agents/budgets). | | `session.thread_created` | Un fil [multi-agents](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration) a été créé. Il inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) : l'ID de l'exécution pour le fil d'une [exécution de workflow](https://platform.claude.com/docs/fr/managed-agents/workflow-runs#a-runs-threads), et `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) pour tout autre fil. | | `session.thread_status_running` | Un fil de session a commencé à s'exécuter. Chaque session émet cet événement pour son fil principal ; dans les sessions [multi-agents](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration), les transitions des fils enfants sont également republiées sur le flux principal. | | `session.thread_status_idle` | Un thread de session a terminé son tour et attend une entrée. Inclut `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`). | | `session.thread_status_rescheduled` | Un thread de session a rencontré une erreur transitoire et réessaie automatiquement. | | `session.thread_status_terminated` | Un fil de session s'est terminé et n'accepte plus aucune entrée, par exemple parce qu'il a été archivé ou a rencontré une erreur irrécupérable. Un fil du conseiller se termine également à la fin de sa consultation. Le serveur archive lui-même les fils d'une exécution de workflow. | Dans une session dont l'agent a les [workflows dynamiques](https://platform.claude.com/docs/fr/managed-agents/multiagent-orchestration#dynamic-workflows) activés, ces événements `workflow_run.*` arrivent sur le flux de la session : | Type | Description | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | Une exécution de workflow a été créée. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), le `name` (csharp, go: `Name`) et la `description` (csharp, go: `Description`) de l'exécution, ainsi que `phases` (csharp, go: `Phases`), les phases déclarées pour l'exécution. Un événement de statut suit, bien qu'après une interruption ce ne soit pas forcément le cas. | | `workflow_run.status_running` | Une exécution de workflow est en cours. Envoyé lorsque l'exécution commence, ce qui peut survenir un certain temps après `workflow_run.created`, puis à nouveau lorsqu'elle reprend après une pause due au budget. Une reprise après une interruption peut ne pas l'envoyer. Une exécution inactive dès le départ peut recevoir `workflow_run.status_idle` en premier. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_idle` | Une exécution de workflow est devenue inactive : elle a été mise en pause, par exemple en atteignant le budget de la session. Une pause après une interruption peut ne pas l'envoyer. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_ended` | Une exécution de workflow s'est terminée. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) et `result` (csharp, go: `Result`), dont le `type` (csharp, go: `Type`) indique comment l'exécution s'est terminée. | | `workflow_run.error` | Une erreur d'une exécution de workflow, ou un démarrage refusé par le serveur. Une exécution qui se termine en erreur le reçoit, avec la même erreur, avant son `workflow_run.status_ended`. Inclut `error` (csharp, go: `Error`) et `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), qui vaut `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) lorsqu'aucune exécution n'a été créée. | | `workflow_run.phase_started` | Une exécution de workflow est entrée dans l'une de ses phases. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) et `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`). | | `workflow_run.phase_ended` | Une exécution de workflow a quitté une phase. Inclut `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`) et `phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`). | Les événements de span sont des marqueurs d'observabilité qui encadrent l'activité pour le suivi du temps et de l'utilisation. | Type | Description | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `span.model_request_start` | Un appel d'inférence de modèle a démarré. | | `span.model_request_end` | Un appel d'inférence du modèle s'est terminé. Inclut `model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`) avec le nombre de tokens. | | `span.outcome_evaluation_start` | L'évaluation du [résultat attendu](https://platform.claude.com/docs/fr/managed-agents/define-outcomes) a démarré. | | `span.outcome_evaluation_ongoing` | Signal de vie pendant une évaluation de [résultat attendu](https://platform.claude.com/docs/fr/managed-agents/define-outcomes) en cours. | | `span.outcome_evaluation_end` | Un cycle d'évaluation de [résultat attendu](https://platform.claude.com/docs/fr/managed-agents/define-outcomes) s'est terminé. Un résultat `needs_revision` signifie qu'un autre cycle suit ; `satisfied`, `max_iterations_reached`, `failed` et `interrupted` sont terminaux. | | Type | Description | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `system.message` | Ajoute un contexte privilégié de niveau système qui s'applique au tour associé et à tous les tours suivants. Pour les modèles qui l'acceptent, consultez [Modèles pris en charge](https://platform.claude.com/docs/fr/managed-agents/events-and-streaming#supported-models). Sur un modèle principal non pris en charge, l'événement est rejeté avec `model_does_not_support_mid_conversation_system`. | Les deltas d'événements sont des événements d'aperçu propres au flux. Ils sont émis sur les connexions de flux (au niveau de la session ou par thread) qui les activent avec le paramètre `event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`), et ils ne sont jamais persistés dans l'historique des événements de la session. Consultez [Prévisualiser les réponses avec les deltas d'événements](https://platform.claude.com/docs/fr/managed-agents/event-deltas) pour savoir comment les activer, les accumuler et les réconcilier. | Type | Description | | ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event_start` | La génération d'un événement prévisualisé a commencé. Contient le `type` (csharp, go: `Type`) et l'`id` (csharp, go: `ID`) de l'événement à venir. Propre au flux et jamais persisté. | | `event_delta` | Contenu incrémental d'un événement prévisualisé, identifié par `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`). Propre au flux et jamais persisté. | ## Worker auto-hébergé Consultez la [Référence des workers auto-hébergés](https://platform.claude.com/docs/fr/managed-agents/self-hosted-sandboxes-reference) pour les options CLI `ant beta:worker`, les variables d'environnement, les chemins du système de fichiers et les options des helpers du SDK des workers préconstruits qui pilotent un environnement `self_hosted`. ## Types de serveurs MCP pris en charge Claude Managed Agents se connecte aux [serveurs MCP distants](https://platform.claude.com/docs/fr/agents-and-tools/remote-mcp-servers) qui exposent un point de terminaison HTTP, ou à des serveurs MCP privés via des [tunnels MCP](https://platform.claude.com/docs/fr/agents-and-tools/mcp-tunnels/overview). 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](https://platform.claude.com/docs/fr/managed-agents/mcp-connector) 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](https://modelcontextprotocol.io). ## 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](https://platform.claude.com/docs/fr/api/rate-limits) 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](https://www.anthropic.com/contact-sales) d'Anthropic.