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, indicadores de CLI y otras tablas de consulta
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) |
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 por 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.
Claude Managed Agents es ideal para cargas de trabajo que necesitan:
Claude Managed Agents le da a Claude acceso a un conjunto de herramientas integradas:
Consulta Herramientas para ver la lista completa y las opciones de configuración.
Para comenzar, necesitas:
managed-agents-2026-04-01 en todas las solicitudesDentro 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. Debido a esto, Managed Agents actualmente no es elegible para Zero Data Retention ni para la cobertura del Business Associate Agreement (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?