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. Il ne met fin à aucune exécution de workflow. |
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. |
| 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 et, généralement, evaluation (voir comment chaque appel a été évalué). |
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 et, généralement, evaluation (voir comment chaque appel a été évalué). |
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, 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, 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 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 typé avec un retry_status. |
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. |
session.thread_created | Un fil multi-agents a été créé. Il inclut workflow_run_id : l'ID de l'exécution pour le fil d'une exécution de workflow, et None 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, 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. |
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 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, le name et la description de l'exécution, ainsi que 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. |
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. |
workflow_run.status_ended | Une exécution de workflow s'est terminée. Inclut workflow_run_id et result, dont le 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 et workflow_run_id, qui vaut None 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 et workflow_run_phase_id. |
workflow_run.phase_ended | Une exécution de workflow a quitté une phase. Inclut workflow_run_id, workflow_run_phase_id et phase_started_id. |
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 avec le nombre de tokens. |
span.outcome_evaluation_start | L'évaluation du résultat attendu a démarré. |
span.outcome_evaluation_ongoing | Signal de vie pendant une évaluation de résultat attendu en cours. |
span.outcome_evaluation_end | Un cycle d'évaluation de résultat attendu 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. 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, 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 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 et l'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. Propre au flux et jamais persisté. |
Worker auto-hébergé
Consultez la Référence des workers auto-hébergés 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 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?