Descripción general de Claude Managed Agents
Arnés de agente preconstruido y configurable que se ejecuta en infraestructura administrada. Ideal para tareas de larga duración y trabajo asíncrono.
Anthropic ofrece dos formas de construir con Claude, cada una adecuada para diferentes casos de uso:
| Messages API | Claude Managed Agents | |
|---|---|---|
| Qué es | Acceso directo para enviar prompts al modelo | Arnés de agente preconstruido y configurable que se ejecuta en infraestructura administrada |
| Ideal para | Bucles de agente personalizados y control detallado | Tareas de larga duración y trabajo asíncrono |
Claude Managed Agents proporciona el arnés y la infraestructura para ejecutar Claude como un agente autónomo. En lugar de construir tu propio bucle de agente, ejecución de herramientas y entorno de ejecución, obtienes un entorno totalmente administrado donde Claude puede leer archivos, ejecutar comandos, navegar por la web y ejecutar código de forma segura. El arnés admite "prompt caching" (almacenamiento en caché de prompts) integrado, compactación y otras optimizaciones de rendimiento para obtener resultados de agente eficientes y de alta calidad. Para construir tu propio bucle de agente con acceso directo al modelo, consulta Uso de la Messages API.
Crea tu primera sesión de agente
Crea una sesión y envía tu primer evento
Tipos de eventos, límites de velocidad, flags de la CLI y otras tablas de consulta
Conceptos principales
Claude Managed Agents se basa en cuatro conceptos:
| Concepto | Descripción |
|---|---|
| Agente | El modelo, la indicación del sistema, las herramientas, los servidores MCP y las skills |
| Entorno | Configuración de dónde se ejecutan las sesiones: un sandbox en la nube administrado por Anthropic, o un sandbox autoalojado en tu propia infraestructura |
| Sesión | Una instancia de agente en ejecución dentro de un entorno, que realiza una tarea específica y genera salidas |
| Eventos | Mensajes intercambiados entre tu aplicación y el agente (turnos del usuario, resultados de herramientas, actualizaciones de estado) |
Cómo funciona
Crea un agente
Define el modelo, la "system prompt" (indicación del sistema), las herramientas, los servidores MCP y las skills. Crea el agente una vez y haz referencia a él por ID en todas las sesiones.
Crea un entorno
Configura dónde se ejecuta el agente: un sandbox en la nube o un sandbox autoalojado en tu propia infraestructura.
Inicia una sesión
Lanza una sesión que haga referencia a la configuración de tu agente y entorno.
Envía eventos y recibe respuestas por streaming
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y devuelve los resultados por streaming mediante "server-sent events" (eventos enviados por el servidor), o SSE. El historial de eventos se conserva en el servidor y puede recuperarse completo.
Dirige o interrumpe
Envía eventos de usuario adicionales para guiar al agente durante la ejecución, o interrúmpelo para cambiar de dirección.
Cuándo usar Claude Managed Agents
Claude Managed Agents es ideal para cargas de trabajo que necesitan:
- Ejecución de larga duración: Tareas que se ejecutan durante minutos u horas con múltiples llamadas a herramientas
- Infraestructura en la nube: Sandboxes seguros con paquetes preinstalados y acceso a la red
- Ejecución autoalojada: Sandboxes en infraestructura que tú controlas para requisitos de cumplimiento normativo o residencia de datos
- Infraestructura mínima: Sin necesidad de construir tu propio bucle de agente, sandbox o capa de ejecución de herramientas
- Sesiones con estado: Sistemas de archivos persistentes e historial de conversación a lo largo de múltiples interacciones
- Ejecución programada: Ejecuciones recurrentes del agente según una programación cron mediante despliegues programados
Herramientas compatibles
Claude Managed Agents le da a Claude acceso a un conjunto de herramientas integradas:
- Bash: Ejecuta comandos de shell en el sandbox
- Operaciones de archivos: Lee, escribe, edita y aplica glob y grep a archivos en el sandbox
- Búsqueda y obtención web: Busca en la web y recupera contenido de URLs, opcionalmente restringido a una lista de dominios permitidos o bloqueados
- Servidores MCP: Conéctate a proveedores de herramientas externos
Consulta Herramientas para ver la lista completa y las opciones de configuración.
Acceso beta
Para comenzar, necesitas:
- Una clave de API de Claude
- El encabezado beta
managed-agents-2026-04-01en todas las solicitudes - Acceso a Claude Managed Agents (habilitado de forma predeterminada para todas las cuentas de API)
Dentro de la beta, los túneles MCP y dreaming se encuentran en una vista previa de investigación más limitada. Solicita acceso para habilitarlos.
Claude Managed Agents tiene estado por diseño: las sesiones son de larga duración, se reanudan sin problemas después de las pausas y almacenan el historial de conversación, el estado del sandbox y los resultados en el servidor. Por este motivo, Managed Agents actualmente no es elegible para Zero Data Retention ni para la cobertura del HIPAA Business Associate Agreement (BAA). Tú conservas el control sobre estos datos: puedes eliminar sesiones y, por separado, eliminar cualquier archivo que hayas subido, en cualquier momento a través de la API. Para conocer la elegibilidad de todas las funciones, consulta API y retención de datos.
Consulta Límites de velocidad y Directrices de marca en la referencia.
Was this page helpful?