Referencia
Tipos de eventos, flags de 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 en mitad de la ejecución. |
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. |
Worker autoalojado
Estos son los flags de CLI de ant beta:worker para el worker predefinido que impulsa un entorno self_hosted. Consulta Sandboxes autoalojados para configurar el entorno, ejecutar un worker y conocer las opciones del helper del SDK.
| Flag | Descripción |
|---|---|
--environment-id | El entorno que se consulta en busca de trabajo. También se lee de ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Autentica al worker con este entorno. También se lee de ANTHROPIC_ENVIRONMENT_KEY. |
--workdir | Directorio donde se descargan las skills y donde las herramientas leen y escriben archivos. El valor predeterminado es . (el directorio actual); el directorio de trabajo predeterminado del sistema es /workspace. |
--on-work | Script que se invoca para cada elemento de trabajo reclamado en lugar de ejecutar las herramientas en el mismo proceso. Recibe los detalles de la sesión como variables de entorno. |
--unrestricted-paths | Permite que las herramientas de archivos lean y escriban rutas fuera de --workdir. La verificación del workdir es una protección solo para las herramientas de archivos, no un sandbox; no restringe bash. |
--max-idle | Cuánto tiempo esperar después de que la sesión quede inactiva con un motivo de detención end_turn antes de apagarse. El valor predeterminado es 60s. |
--log-format | Formato de salida de los logs. Usa json para la ingesta de logs estructurados. El valor predeterminado es text. |
El worker de CLI no monta almacenes de memoria: una sesión que adjunta uno se ejecuta de todos modos, pero el agente no encuentra nada en el mount_path del almacén y ningún cambio se sincroniza de vuelta al almacén. Para usar almacenes de memoria en sesiones de un entorno autoalojado, ejecuta en su lugar el worker del SDK; consulta Usar almacenes de memoria.
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?