Esta página reúne material de referencia para Claude Managed Agents. Para guías orientadas a tareas, sigue los enlaces en cada sección. Para las operaciones sobre el recurso de sesión, consulta Operaciones de sesión.
Las cadenas de tipo de evento persistidas siguen una convención de nomenclatura {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, transmitir por streaming y listar eventos.
| 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 outcome (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 hacen esto automáticamente. |
Estos son los flags de CLI de ant beta:worker para el worker predefinido que controla un entorno self_hosted. Consulta Sandboxes autoalojados para configurar el entorno, ejecutar un worker y las opciones de los helpers del SDK.
| Flag | Descripción |
|---|---|
--environment-id | El entorno que se sondeará en busca de trabajo. También se lee desde ANTHROPIC_ENVIRONMENT_ID. |
--environment-key | Autentica el worker con este entorno. También se lee desde 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 llamará para cada elemento de trabajo reclamado en lugar de ejecutar herramientas en el 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 de 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 stop reason 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. |
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 transmisible por 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 obtener más información sobre MCP y la creación de servidores MCP, consulta la documentación de MCP.
Los endpoints de Managed Agents tienen 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 stream) | 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.
Para los partners que integran Claude Managed Agents, el uso de la marca Claude es opcional. Al hacer referencia a Claude en tu producto:
Permitido:
No permitido:
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?