Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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.
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 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 y listar eventos.
| Tipo | Descripción |
|---|---|
user.message | Un mensaje de usuario con contenido de texto. |
user.interrupt | Detiene al agente en medio 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 a 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 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 helpers del SDK.
| Flag | Descripción |
|---|---|
--environment-id | El entorno a 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 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 a 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 a herramientas accedan a rutas fuera de --workdir. |
--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 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 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 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 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. Para preguntas sobre el cumplimiento de la marca, contacta al equipo de ventas de Anthropic.
Was this page helpful?