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 servicio de Managed Agents conserva el historial de eventos y puedes recuperarlo completo.
Dirige o interrumpe
Envía eventos de usuario adicionales para guiar al agente mientras se ejecuta, 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
- Servicio autoalojado: Todo el servicio de Managed Agents en tu propia infraestructura, con Claude Managed Agents autoalojado
- 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 de la Claude Console.
- 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 los sueños se encuentran en una vista previa de investigación más limitada. Para habilitarlos, solicita acceso a la vista previa de investigación.
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 retención cero de datos ni para la cobertura del “Business Associate Agreement” (acuerdo de asociado comercial), o BAA, de HIPAA. La excepción para la retención cero de datos es Claude Managed Agents autoalojado, donde tú mismo almacenas esos datos, como se describe en Cuánto tiempo se conservan los datos. 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.
Disponibilidad
Claude API
- Estado
- Beta
- Encabezado beta
- Requiere
- Modelos
- Todos los modelos
Claude Platform on AWS
- Estado
- Beta
- Encabezado beta
- Requiere
- Modelos
- Todos los modelos
Claude Models on Google Cloud (Anthropic managed)
- Estado
- Beta
- Encabezado beta
- Requiere
- Modelos
- Todos los modelos
Manejo de datos
Descripción general del manejo de datosEndpoints aplicables
/v1/agents/v1/sessions/v1/environments
No es elegible para ZDR, excepto Managed Agents autoalojado. Las sesiones son recursos con estado; las transcripciones persisten hasta que las eliminas. Más información
No es elegible para HIPAA. Se aplica a todas las subfunciones de Managed Agents.
¿Te resultó útil esta página?