Claude Platform Docs
Managed AgentsManaged Agents autoalojado

Claude Managed Agents autoalojado

Aloja el servicio Claude Managed Agents y sus sandboxes en tu propia infraestructura. Descubre quién aloja cada parte, cuándo elegir esta opción y por dónde empezar.

Claude Managed Agents autoalojado es Managed Agents en tu propia infraestructura, que puede ser una cuenta en la nube o un centro de datos on-premise. Tú alojas el servicio y los sandboxes. El modelo se ejecuta en Anthropic o en un proveedor que tú elijas.

Managed Agents tiene dos partes que puedes alojar:

  • Sandboxes: Los contenedores, las VM u otros espacios de trabajo aislados donde las herramientas de un agente ejecutan comandos y trabajan con archivos. Consulta Sandboxes autoalojados.
  • El servicio: La API, el bucle del agente y el almacenamiento de los agentes, las sesiones y el historial de las sesiones.

Los sandboxes autoalojados trasladan la primera parte a ti. Managed Agents autoalojado amplía eso: tú también alojas el servicio. El nombre de cada opción indica qué alojas:

OpciónSandboxesServicioModelo
Sandboxes en la nube (predeterminado)AnthropicAnthropicAnthropic
Sandboxes autoalojadosTúAnthropicAnthropic
Managed Agents autoalojadoTúTúAnthropic, o un proveedor que tú elijas

En estas páginas, el servicio alojado es el servicio tal como lo ejecuta Anthropic, y tu servidor es el servicio tal como lo ejecutas tú, con su propia base de datos. Ambos tienen la misma API, así que el SDK y la CLI ant funcionan con tu servidor, y el resto de la documentación de Managed Agents se aplica. Diferencias con el servicio alojado enumera las excepciones.

¿Eres nuevo en Claude Managed Agents?

Claude Managed Agents ejecuta Claude como un agente autónomo: defines un agente, inicias una sesión e intercambias eventos con el agente mientras trabaja. Conceptos principales explica los agentes, los entornos, las sesiones y los eventos. No necesitas usar primero el servicio alojado.

Cuándo elegir Managed Agents autoalojado

Elige Managed Agents autoalojado cuando necesites una de las siguientes opciones:

  • Almacenamiento en tu infraestructura: Debes almacenar tú mismo los agentes, las sesiones y el historial de las sesiones.
  • Tu elección de proveedor de inferencia: Las llamadas al modelo deben ir a Amazon Bedrock, Claude Models on Google Cloud (Google managed), Microsoft Foundry o tu propio gateway de modelos. Consulta Proveedor de inferencia.

Si solo necesitas que las herramientas se ejecuten en tu infraestructura, usa sandboxes autoalojados, donde Anthropic ejecuta el servicio. Consulta Elegir un entorno para el agente.

Con Managed Agents autoalojado, tú ejecutas y proteges un servidor, su base de datos y tus sandboxes, y tú mismo instalas cada versión. Algunas funciones solo existen en el servicio alojado, así que consulta Diferencias con el servicio alojado antes de decidir.

Qué se ejecuta dónde

Uno o más servidores, su base de datos y tus sandboxes forman una implementación.

  • Servidor (cma-server): Sirve la API, ejecuta el bucle del agente y almacena los agentes, las sesiones y el historial de cada sesión. Llama a tu proveedor de inferencia cada vez que el agente necesita el modelo. El servidor nunca ejecuta las herramientas de shell ni de archivos de un agente.
  • Base de datos: PostgreSQL 16 o posterior. Sin una base de datos, el servidor guarda sus datos en memoria, y un reinicio los borra.
  • Workers: Programas que toman trabajo del servidor y ejecutan las herramientas de shell y de archivos del agente en tus sandboxes. Un worker es un comando ant beta:worker o un worker del SDK.
  • Tus aplicaciones: Tu propio código y tus scripts, que acceden al servidor con el SDK o la CLI ant.
  • Consola de tu servidor: Una página web en la dirección del servidor, donde las personas inician sesión a través de tu proveedor de identidad para crear agentes y ejecutar sesiones. Consulta Usar la consola de tu servidor.
  • CLI de administración (cma-server-admin): Crea los entornos y sus claves de entorno. Se ejecuta en Linux (x86-64 y Arm) y en macOS con Apple silicon.

Tus responsabilidades de seguridad

El Modelo de seguridad de los sandboxes autoalojados se aplica aquí, con dos diferencias. Lo que esa página asigna a Anthropic es tu responsabilidad, incluido proteger el servidor, alojar los almacenes de memoria y detectar usos inusuales. Esa página también sugiere un espacio de trabajo y un entorno separados para cada límite de confianza. Aquí, cada nivel de confianza necesita su propia implementación, como explica Multiinquilinato.

Las tres credenciales

CredencialQuién la tieneQué autentica
Clave de API del servidorTus aplicaciones, la CLI ant y la CLI de administraciónLas solicitudes a tu servidor. La configuración genera esta clave. Cumple el papel que cumple una clave de API de Claude con el servicio alojado.
Credencial de inferenciaEl servidorLas llamadas al modelo que hace el servidor a tu proveedor de inferencia. Por ejemplo, puede ser una clave de API de Claude, la credencial de tu proveedor de nube o el token que acepta tu gateway de modelos. Las aplicaciones y los workers no la necesitan.
Clave de entornoTus workers que consultan periódicamente al servidorLa cola de trabajo de un entorno y las sesiones de ese entorno.

Qué sale de tu red

Para cada llamada al modelo, el servidor envía la conversación hasta ese momento, incluidas las entradas y los resultados de las herramientas, a tu proveedor de inferencia. De forma predeterminada, es la API de Claude. Una llamada a la API de Claude también lleva los ID de su sesión y del agente y el entorno de esa sesión. Datos y acceso en Claude Managed Agents autoalojado enumera cada conexión que realiza el servidor. También indica adónde van los registros y quién puede acceder al servidor.

Por dónde empezar

Para solicitar acceso a la descarga, ponte en contacto con el equipo de tu cuenta de Anthropic. Luego sigue Comenzar con Claude Managed Agents autoalojado para iniciar un servidor y ejecutar una primera sesión.

El archivo de cada versión incluye una guía del operador para esa versión, operator-guide.md. Pídele a Claude que lea ese archivo, para que Claude pueda ayudarte a configurar y ejecutar tu servidor y a escribir código que se conecte a él.

¿Te resultó útil esta página?