Agentes gestionadosPrimeros pasos

Descripción general de Claude Managed Agents

Estructura de agente preconfigurada y personalizable que se ejecuta en infraestructura gestionada. Ideal para tareas de larga duración y trabajo asíncrono.

Anthropic ofrece dos formas de desarrollar con Claude, cada una adecuada para diferentes casos de uso:

	Messages API	Claude Managed Agents
Qué es	Acceso directo para enviar prompts al modelo	Un "agent harness" (arnés de agente) preconfigurado y personalizable que se ejecuta en infraestructura gestionada
Ideal para	Bucles de agente personalizados y control detallado	Tareas de larga duración y trabajo asíncrono
Más información	Documentación de Messages API	Documentación de Claude Managed Agents

Claude Managed Agents proporciona la estructura 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 completamente gestionado donde Claude puede leer archivos, ejecutar comandos, navegar por la web y ejecutar código de forma segura. La estructura admite almacenamiento en caché de prompts integrado, compactación y otras optimizaciones de rendimiento para obtener resultados de agente eficientes y de alta calidad.

Claude Managed Agents también está disponible en Claude Platform en AWS, con algunas diferencias en la disponibilidad de funciones y el comportamiento de las sesiones. Consulta Claude Managed Agents en la guía de Claude Platform en AWS.

Inicio rápido

Crea tu primera sesión de agente

Iniciar una sesión

Crea una sesión y envía tu primer evento

Referencia

Tipos de eventos, límites de velocidad, flags de CLI y otras tablas de consulta

Conceptos fundamentales

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 habilidades
Entorno	Configuración de dónde se ejecutan las sesiones: un sandbox en la nube gestionado 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 indicación del sistema, las herramientas, los servidores MCP y las habilidades. Crea el agente una vez y referéncialo 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 en streaming
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y transmite los resultados mediante "server-sent events" (eventos enviados por el servidor), o SSE. El historial de eventos se conserva en el servidor y se puede recuperar en su totalidad.
Guía 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 cumplir requisitos de conformidad 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 un cronograma 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, busca con glob y grep archivos en el sandbox
Búsqueda y obtención web: Busca en la web y recupera contenido de URLs
Servidores MCP: Conéctate a proveedores de herramientas externos

Consulta Herramientas para ver la lista completa y las opciones de configuración.

Acceso beta

Claude Managed Agents se encuentra actualmente en beta. Todos los endpoints de Managed Agents requieren el encabezado beta managed-agents-2026-04-01. El SDK establece el encabezado beta automáticamente. Los comportamientos pueden refinarse entre versiones para mejorar los resultados.

Para comenzar, necesitas:

Una clave de API de Claude
El encabezado beta managed-agents-2026-04-01 en 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 están 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 pausas y almacenan el historial de conversación, el estado del sandbox y los resultados en el servidor. Debido a esto, Managed Agents actualmente no es elegible para Retención Cero de Datos ni para la cobertura del Acuerdo de Asociado Comercial (BAA) de HIPAA. 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?

Agentes gestionadosPrimeros pasos

Descripción general de Claude Managed Agents

Estructura de agente preconfigurada y personalizable que se ejecuta en infraestructura gestionada. Ideal para tareas de larga duración y trabajo asíncrono.

Anthropic ofrece dos formas de desarrollar con Claude, cada una adecuada para diferentes casos de uso:

	Messages API	Claude Managed Agents
Qué es	Acceso directo para enviar prompts al modelo	Un "agent harness" (arnés de agente) preconfigurado y personalizable que se ejecuta en infraestructura gestionada
Ideal para	Bucles de agente personalizados y control detallado	Tareas de larga duración y trabajo asíncrono
Más información	Documentación de Messages API	Documentación de Claude Managed Agents

Inicio rápido

Crea tu primera sesión de agente

Iniciar una sesión

Crea una sesión y envía tu primer evento

Referencia

Tipos de eventos, límites de velocidad, flags de CLI y otras tablas de consulta

Conceptos fundamentales

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 habilidades
Entorno	Configuración de dónde se ejecutan las sesiones: un sandbox en la nube gestionado 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 indicación del sistema, las herramientas, los servidores MCP y las habilidades. Crea el agente una vez y referéncialo 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 en streaming
Envía mensajes de usuario como eventos. Claude ejecuta herramientas de forma autónoma y transmite los resultados mediante "server-sent events" (eventos enviados por el servidor), o SSE. El historial de eventos se conserva en el servidor y se puede recuperar en su totalidad.
Guía 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 cumplir requisitos de conformidad 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 un cronograma 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, busca con glob y grep archivos en el sandbox
Búsqueda y obtención web: Busca en la web y recupera contenido de URLs
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-01 en 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 están en una vista previa de investigación más limitada. Solicita acceso para habilitarlos.

Consulta Límites de velocidad y Directrices de marca en la referencia.

Was this page helpful?

Conceptos fundamentales

Cómo funciona

Cuándo usar Claude Managed Agents

Herramientas compatibles

Acceso beta

Conceptos fundamentales

Cómo funciona

Cuándo usar Claude Managed Agents

Herramientas compatibles

Acceso beta

Conceptos fundamentales

Cómo funciona

Cuándo usar Claude Managed Agents

Herramientas compatibles

Acceso beta

Conceptos fundamentales

Cómo funciona

Cuándo usar Claude Managed Agents

Herramientas compatibles

Acceso beta