Esta página recopila 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.
Todas las solicitudes a la Managed Agents API requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente.
Las cadenas de tipo de evento siguen una convención de nomenclatura {domain}.{action}. Consulta Flujo de eventos de sesión para enviar, transmitir por streaming y listar eventos.
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 consultará 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 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 llamadas de herramientas accedan a rutas fuera de --workdir. |
--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. 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 transmitir por streaming) | 600 solicitudes por minuto |
También se aplican los límites de gasto y límites de velocidad basados en niveles a nivel de organización.
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:
No permitido:
Tu producto debe mantener su propia marca y no parecer ser Claude Code, Claude Cowork ni ningún otro producto de Anthropic. Si tienes preguntas sobre el cumplimiento de las directrices de marca, contacta al equipo de ventas de Anthropic.
Was this page helpful?