Referencia
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.
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.
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 para enviar, hacer streaming y listar eventos. Los tipos de eventos de webhook se listan por separado en Suscribirse a webhooks, 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. |
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 hacia el cual el agente debe trabajar. |
user.tool_result | Solo para sesiones con entornos 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 y, normalmente, evaluation (consulta cómo se evaluó cada llamada). |
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 y, normalmente, evaluation (consulta cómo se evaluó cada llamada). |
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, 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, 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 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 tipado con un retry_status. |
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. |
session.thread_created | Se creó un hilo multiagente. Incluye workflow_run_id: el ID de la ejecución para el hilo de una ejecución de flujo de trabajo, y None 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, 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. |
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, 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, el name y la description de la ejecución, y 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. |
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. |
workflow_run.status_ended | Una ejecución de flujo de trabajo finalizó. Incluye workflow_run_id y result, cuyo 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 y workflow_run_id, que es None 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 y workflow_run_phase_id. |
workflow_run.phase_ended | Una ejecución de flujo de trabajo salió de una fase. Incluye workflow_run_id, workflow_run_phase_id y phase_started_id. |
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 con los recuentos de tokens. |
span.outcome_evaluation_start | Se inició la evaluación de un resultado. |
span.outcome_evaluation_ongoing | Latido durante una evaluación de resultado en curso. |
span.outcome_evaluation_end | Se completó un ciclo de evaluación de resultado. 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. 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, y nunca se persisten en el historial de eventos de la sesión. Consulta Previsualizar respuestas con deltas de eventos para activarlos, acumularlos y conciliarlos.
| Tipo | Descripción |
|---|---|
event_start | Un evento previsualizado comenzó a generarse. Incluye el type y el id del próximo evento. Exclusivo del stream y nunca se persiste. |
event_delta | Contenido incremental de un evento previsualizado, identificado por event_id. Exclusivo del stream y nunca se persiste. |
Worker autoalojado
Consulta Referencia de workers autoalojados 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 que exponen un endpoint HTTP, o a servidores MCP privados a través de túneles MCP. 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 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.
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 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 de Anthropic.
Was this page helpful?