--- title: Referencia url: https://platform.claude.com/docs/es/managed-agents/reference description: Tipos de eventos, flags de la CLI del worker autoalojado, tipos de servidores MCP compatibles, límites de velocidad y directrices de marca para 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 --- Esta página reúne material de referencia para Claude Managed Agents. Para guías orientadas a tareas, sigue los enlaces de cada sección. Para las operaciones sobre el recurso de sesión, consulta [Operaciones de sesión](https://platform.claude.com/docs/es/managed-agents/session-operations). ## Tipos de eventos Las cadenas de tipo de evento persistidas siguen una convención de nombres `{domain}.{action}`; los deltas de eventos exclusivos del stream (consulta la pestaña Deltas de eventos) son la excepción. Consulta [Stream de eventos de sesión](https://platform.claude.com/docs/es/managed-agents/events-and-streaming) para enviar, hacer streaming y listar eventos. Los tipos de eventos de webhook se listan por separado en [Suscribirse a webhooks](https://platform.claude.com/docs/es/managed-agents/webhooks#supported-event-types), y algunos de sus nombres difieren de los del stream (por ejemplo, `session.status_idled` en lugar de `session.status_idle`). | Tipo | Descripción | | ------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `user.message` | Un mensaje de usuario con contenido de texto, imagen o documento. | | `user.interrupt` | Detiene al agente a mitad de la ejecución. No finaliza ninguna [ejecución de flujo de trabajo](https://platform.claude.com/docs/es/managed-agents/workflow-runs#interrupt-a-session-with-runs-open). | | `user.custom_tool_result` | Respuesta a una llamada de herramienta personalizada del agente. | | `user.tool_confirmation` | Aprueba o deniega una llamada de herramienta del agente o de MCP cuando una política de permisos requiere confirmación. | | `user.define_outcome` | Define un [resultado](https://platform.claude.com/docs/es/managed-agents/define-outcomes) hacia el cual el agente debe trabajar. | | `user.tool_result` | Solo para sesiones con [entornos](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes) `self_hosted`, tu integración es responsable de proporcionar los resultados de `agent_toolset`. Los helpers del SDK y la CLI lo hacen automáticamente. | | Tipo | Descripción | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `agent.message` | Bloques de contenido de la respuesta del agente. | | `agent.thinking` | Indica que el agente está avanzando mediante "extended thinking" (pensamiento extendido). Es solo una señal de progreso y no incluye el contenido del pensamiento. | | `agent.tool_use` | El agente invoca una herramienta de agente preconstruida (bash, operaciones de archivos, etc.). Incluye `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) y, normalmente, `evaluation` (csharp, go: `Evaluation`) (consulta [cómo se evaluó cada llamada](https://platform.claude.com/docs/es/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.tool_result` | Resultado de la ejecución de una herramienta de agente preconstruida. | | `agent.mcp_tool_use` | El agente invoca una herramienta de un servidor MCP. Incluye `evaluated_permission` (java, php: `evaluatedPermission`; csharp, go: `EvaluatedPermission`) y, normalmente, `evaluation` (csharp, go: `Evaluation`) (consulta [cómo se evaluó cada llamada](https://platform.claude.com/docs/es/managed-agents/permission-policies#see-how-each-call-was-evaluated)). | | `agent.mcp_tool_result` | Resultado de la ejecución de una herramienta de MCP. | | `agent.custom_tool_use` | El agente invoca una de tus herramientas personalizadas. Responde con un evento `user.custom_tool_result`. | | `agent.thread_context_compacted` | El historial de la conversación se compactó para caber en la "context window" (ventana de contexto). | | `agent.thread_message_received` | En una sesión [multiagente](https://platform.claude.com/docs/es/managed-agents/multiagent-orchestration), llegó un mensaje de otro hilo al hilo cuyo stream transporta este evento; en el hilo principal, un agente envió un informe o una pregunta al agente que ejecuta la sesión. | | `agent.thread_message_sent` | En una sesión [multiagente](https://platform.claude.com/docs/es/managed-agents/multiagent-orchestration), el hilo cuyo stream transporta este evento envió un mensaje a otro hilo; en el hilo principal, el agente que ejecuta la sesión envió una tarea o un mensaje de seguimiento a otro agente. | El contenido de los mensajes en estos eventos puede incluir un bloque de contenido `redacted`, `{"type": "redacted"}`: un marcador de posición para contenido retenido por la política de modelos de Anthropic. El bloque no incluye ningún otro campo. Los bloques redactados aparecen únicamente en contenido que emite la plataforma; un evento de usuario que incluya uno se rechaza con un error 400. | Tipo | Descripción | | ----------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `session.status_running` | El agente está procesando activamente. | | `session.status_idle` | El agente terminó su tarea actual y está esperando una entrada. Incluye un `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`) que indica por qué se detuvo el agente. | | `session.status_rescheduled` | Ocurrió un error transitorio y la sesión se está reintentando automáticamente. | | `session.status_terminated` | La sesión finalizó, ya sea por un error irrecuperable o porque se archivó. | | `session.deleted` | La sesión se eliminó. Termina cualquier stream de eventos activo; no se emiten más eventos para esta sesión. | | `session.updated` | Una solicitud de actualización de la sesión cambió al menos un campo. Incluye solo los campos que cambiaron. Las actualizaciones se aplican en el siguiente turno. | | `session.error` | Ocurrió un error durante el procesamiento. Incluye un objeto `error` (csharp, go: `Error`) tipado con un `retry_status` (java, php: `retryStatus`; csharp, go: `RetryStatus`). | | `session.usage` | Instantánea del uso acumulado de la sesión y del costo de lista registrado. Incluye los totales de uso de la sesión y, si la sesión tiene uno, su [presupuesto](https://platform.claude.com/docs/es/managed-agents/budgets). | | `session.thread_created` | Se creó un hilo [multiagente](https://platform.claude.com/docs/es/managed-agents/multiagent-orchestration). Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`): el ID de la ejecución para el hilo de una [ejecución de flujo de trabajo](https://platform.claude.com/docs/es/managed-agents/workflow-runs#a-runs-threads), y `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) para cualquier otro hilo. | | `session.thread_status_running` | Un hilo de sesión comenzó a ejecutarse. Cada sesión emite esto para su hilo principal; en las sesiones [multiagente](https://platform.claude.com/docs/es/managed-agents/multiagent-orchestration), las transiciones de los hilos hijos también se publican en el stream principal. | | `session.thread_status_idle` | Un hilo de sesión terminó su turno y está esperando una entrada. Incluye `stop_reason` (java, php: `stopReason`; csharp, go: `StopReason`). | | `session.thread_status_rescheduled` | Un hilo de sesión encontró un error transitorio y se está reintentando automáticamente. | | `session.thread_status_terminated` | Un hilo de sesión terminó y no acepta más entradas, por ejemplo porque se archivó o encontró un error irrecuperable. Un hilo del asesor también termina cuando finaliza su consulta. El servidor archiva por sí mismo los hilos de una ejecución de flujo de trabajo. | En una sesión cuyo agente tiene activados los [flujos de trabajo dinámicos](https://platform.claude.com/docs/es/managed-agents/multiagent-orchestration#dynamic-workflows), estos eventos `workflow_run.*` llegan al stream de la sesión: | Tipo | Descripción | | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `workflow_run.created` | Se creó una ejecución de flujo de trabajo. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), el `name` (csharp, go: `Name`) y la `description` (csharp, go: `Description`) de la ejecución, y `phases` (csharp, go: `Phases`), las fases declaradas para la ejecución. Le sigue un evento de estado, aunque después de una interrupción podría no hacerlo. | | `workflow_run.status_running` | Una ejecución de flujo de trabajo está en curso. Se envía cuando la ejecución comienza a ejecutarse, lo que puede ocurrir un tiempo después de `workflow_run.created`, y de nuevo cuando se reanuda tras una pausa por el presupuesto. Una reanudación después de una interrupción podría no enviarlo. Una ejecución que está inactiva desde el inicio podría recibir primero `workflow_run.status_idle`. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_idle` | Una ejecución de flujo de trabajo quedó inactiva: se pausó, por ejemplo al alcanzar el presupuesto de la sesión. Una pausa después de una interrupción podría no enviarlo. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`). | | `workflow_run.status_ended` | Una ejecución de flujo de trabajo finalizó. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) y `result` (csharp, go: `Result`), cuyo `type` (csharp, go: `Type`) indica cómo finalizó la ejecución. | | `workflow_run.error` | Un error de una ejecución de flujo de trabajo, o un inicio que el servidor rechazó. Una ejecución que finaliza con error lo recibe, con el mismo error, antes de su `workflow_run.status_ended`. Incluye `error` (csharp, go: `Error`) y `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), que es `null` (python: `None`; ruby: `nil`; java: `Optional.empty()`; go: `""`) cuando no se creó ninguna ejecución. | | `workflow_run.phase_started` | Una ejecución de flujo de trabajo entró en una de sus fases. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`) y `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`). | | `workflow_run.phase_ended` | Una ejecución de flujo de trabajo salió de una fase. Incluye `workflow_run_id` (java: `workflowRunId`; php: `workflowRunID`; csharp, go: `WorkflowRunID`), `workflow_run_phase_id` (java: `workflowRunPhaseId`; php: `workflowRunPhaseID`; csharp, go: `WorkflowRunPhaseID`) y `phase_started_id` (java: `phaseStartedId`; php: `phaseStartedID`; csharp, go: `PhaseStartedID`). | Los eventos de span son marcadores de observabilidad que envuelven la actividad para el seguimiento de tiempos y uso. | Tipo | Descripción | | --------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `span.model_request_start` | Se inició una llamada de inferencia del modelo. | | `span.model_request_end` | Se completó una llamada de inferencia del modelo. Incluye `model_usage` (java, php: `modelUsage`; csharp, go: `ModelUsage`) con los recuentos de tokens. | | `span.outcome_evaluation_start` | Se inició la evaluación de un [resultado](https://platform.claude.com/docs/es/managed-agents/define-outcomes). | | `span.outcome_evaluation_ongoing` | Latido durante una evaluación de [resultado](https://platform.claude.com/docs/es/managed-agents/define-outcomes) en curso. | | `span.outcome_evaluation_end` | Se completó un ciclo de evaluación de [resultado](https://platform.claude.com/docs/es/managed-agents/define-outcomes). Un resultado `needs_revision` significa que sigue otro ciclo; `satisfied`, `max_iterations_reached`, `failed` e `interrupted` son terminales. | | Tipo | Descripción | | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `system.message` | Agrega contexto privilegiado a nivel de sistema que se aplica al turno que lo acompaña y a todos los turnos posteriores. Para conocer los modelos que lo aceptan, consulta [Modelos compatibles](https://platform.claude.com/docs/es/managed-agents/events-and-streaming#supported-models). En un modelo principal no compatible, el evento se rechaza con `model_does_not_support_mid_conversation_system`. | Los deltas de eventos son eventos de vista previa exclusivos del stream. Se emiten en las conexiones de stream (a nivel de sesión o por hilo) que los activan con el parámetro `event_deltas` (curl: `event_deltas[]`; cli: `--event-delta`; java, php: `eventDeltas`; csharp, go: `EventDeltas`), y nunca se persisten en el historial de eventos de la sesión. Consulta [Previsualizar respuestas con deltas de eventos](https://platform.claude.com/docs/es/managed-agents/event-deltas) para activarlos, acumularlos y conciliarlos. | Tipo | Descripción | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `event_start` | Un evento previsualizado comenzó a generarse. Incluye el `type` (csharp, go: `Type`) y el `id` (csharp, go: `ID`) del próximo evento. Exclusivo del stream y nunca se persiste. | | `event_delta` | Contenido incremental de un evento previsualizado, identificado por `event_id` (java: `eventId`; php: `eventID`; csharp, go: `EventID`). Exclusivo del stream y nunca se persiste. | ## Worker autoalojado Consulta [Referencia de workers autoalojados](https://platform.claude.com/docs/es/managed-agents/self-hosted-sandboxes-reference) para conocer los flags de la CLI `ant beta:worker`, las variables de entorno, las rutas del sistema de archivos y las opciones de los helpers del SDK de los workers predefinidos que controlan un entorno `self_hosted`. ## Tipos de servidores MCP compatibles Claude Managed Agents se conecta a [servidores MCP remotos](https://platform.claude.com/docs/es/agents-and-tools/remote-mcp-servers) que exponen un endpoint HTTP, o a servidores MCP privados a través de [túneles MCP](https://platform.claude.com/docs/es/agents-and-tools/mcp-tunnels/overview). El servidor debe admitir el transporte HTTP con streaming del protocolo MCP; los servidores que solo admiten el transporte SSE obsoleto siguen funcionando mediante un fallback automático. Consulta [Conector MCP](https://platform.claude.com/docs/es/managed-agents/mcp-connector) para declarar servidores en un agente. Para más información sobre MCP y la creación de servidores MCP, consulta la [documentación de MCP](https://modelcontextprotocol.io). ## Límites de velocidad Los endpoints de Managed Agents tienen "rate limits" (límites de velocidad) por organización: | Operación | Límite | | --------------------------------------------------------------- | ---------------------------- | | Endpoints de creación (como agentes, sesiones y entornos) | 300 solicitudes por minuto | | Endpoints de lectura (como recuperar, listar y hacer streaming) | 1,200 solicitudes por minuto | También se aplican los [límites de gasto y límites de velocidad por nivel de uso](https://platform.claude.com/docs/es/api/rate-limits) a nivel de organización. ## Directrices de marca Para los socios que integran Claude Managed Agents, el uso de la marca Claude es opcional. Al hacer referencia a Claude en tu producto: **Permitido:** * "Claude Agent" (preferido para menús desplegables) * "Claude" (cuando está dentro de un menú ya etiquetado como "Agents") * "\{YourAgentName} Powered by Claude" (si ya tienes un nombre de agente existente) **No permitido:** * "Claude Code" o "Claude Code Agent" * "Claude Cowork" o "Claude Cowork Agent" * Arte ASCII con la marca Claude Code o elementos visuales que imiten a Claude Code Tu producto debe mantener su propia marca y no parecer ser Claude Code, Claude Cowork ni ningún otro producto de Anthropic. Para preguntas sobre el cumplimiento de las directrices de marca, contacta al [equipo de ventas](https://www.anthropic.com/contact-sales) de Anthropic.