Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
Loading...
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.
Las solicitudes a la API de Managed Agents requieren el encabezado beta managed-agents-2026-04-01, excepto los endpoints del almacén de memoria, que usan agent-memory-2026-07-22 en su lugar. El SDK establece el encabezado beta correcto automáticamente. Consulta Encabezados beta.
Las cadenas de tipos de eventos persistidos siguen una convención de nomenclatura {domain}.{action}; los deltas de eventos de solo streaming (consulta la pestaña Deltas de eventos) son la excepción. Consulta Flujo 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 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 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 hacen esto automáticamente. |
Estos son los flags de la CLI ant beta:worker para el worker preconstruido que impulsa 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 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 donde las herramientas leen y escriben archivos. Por defecto 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 las 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 del workdir es una barrera de 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. Por defecto es 60s. |
--log-format | Formato de salida de los logs. Usa json para la ingesta de logs estructurados. Por defecto 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 ser compatible con el transporte HTTP transmisible por streaming del protocolo MCP; los servidores que solo admiten el transporte SSE obsoleto siguen funcionando mediante un mecanismo de respaldo automático. Consulta Conector MCP para declarar servidores en un agente.
Para obtener más información sobre MCP y la construcció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 aparentar 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?