Elegir un entorno para el agente
Decide si las herramientas y el código de Claude Managed Agents se ejecutan en un entorno en la nube administrado por Anthropic o en un sandbox autoalojado, y descubre qué cambia si cambias de opción.
Un entorno establece dónde se ejecutan las herramientas y el código de tu agente. Se ejecutan en un sandbox. Un sandbox es un espacio de trabajo aislado, como un contenedor, donde el agente ejecuta comandos y trabaja con archivos. Tienes dos opciones:
- Entorno en la nube: Anthropic ejecuta el sandbox por ti. Cada sesión obtiene su propio contenedor Linux nuevo en infraestructura administrada por Anthropic, con lenguajes, bases de datos y utilidades comunes ya instalados. Tú eliges sus reglas de red y cualquier paquete adicional que quieras instalar.
- Sandbox autoalojado: Ejecutas el sandbox en tu propia infraestructura. Claude sigue ejecutándose del lado de Anthropic y decide qué herramienta llamar a continuación. Un programa que tú ejecutas, llamado "worker" (trabajador), lleva a cabo las llamadas a las herramientas de bash y de archivos del agente en tus máquinas y envía cada resultado de vuelta. También puede servir herramientas personalizadas.
La definición del agente es la misma sin importar cuál elijas. Configuras el modelo, el prompt y las herramientas en el agente, no en el entorno.
Comienza con un entorno en la nube
Si no estás seguro de cuál elegir, o eres nuevo en Claude Managed Agents, comienza con un entorno en la nube, como lo hace el inicio rápido. Anthropic ejecuta un contenedor aislado para cada sesión, con lenguajes y herramientas comunes ya instalados, así que no tienes nada que alojar. Elige un sandbox autoalojado solo si las herramientas deben ejecutarse en infraestructura que tú controlas.
Compara las opciones
La tabla compara las dos opciones.
| Entorno en la nube (predeterminado) | Sandbox autoalojado | |
|---|---|---|
| Dónde se ejecutan las herramientas y el código | Un sandbox administrado por Anthropic | Tu worker, en tu infraestructura |
| Qué llega a Anthropic | El historial de la conversación, los resultados de las herramientas, los archivos y el estado del sandbox, las skills y los almacenes de memoria | El historial de la conversación, los resultados de las herramientas, las skills y los almacenes de memoria. Los archivos y procesos del sandbox permanecen en tu worker. |
| Qué operas tú | Nada | Los hosts del worker, su endurecimiento, sus límites de red y la clave de entorno con la que se autentica tu worker |
| Alcance de red | Reglas de red que configuras en el entorno | Tu propia política de red |
| Montaje de archivos y repositorios de GitHub | Administrado por Anthropic | Administrado por ti |
| Almacenes de memoria | Montados por Anthropic en /mnt/memory/ | Descargados en /mnt/memory/ y sincronizados por el worker |
| Ciclo de vida del sandbox | Administrado por Anthropic | Administrado por ti |
| Elígelo cuando | Es la opción predeterminada. No necesitas que las herramientas se ejecuten en tu propia infraestructura. | Las herramientas deben ejecutarse en infraestructura que tú controlas. |
Cuándo elegir un sandbox autoalojado
Un sandbox autoalojado es adecuado cuando el agente necesita hacer una de las siguientes cosas:
- Trabajar con datos que no pueden salir de tu red: Los archivos y procesos del agente permanecen en tu worker. Lo que una herramienta devuelve al modelo sigue llegando al servicio de Managed Agents.
- Acceder a servicios internos que no son enrutables públicamente: Las herramientas de bash y de archivos del agente, y cualquier herramienta personalizada que sirva tu worker, se ejecutan dentro de tu red. Es Anthropic, no tu worker, quien se conecta a los servidores MCP del agente. Uno privado podría estar delante de tu sistema interno de tickets o de la wiki de tu empresa. Para acceder a él, puedes usar un túnel MCP con cualquiera de las dos opciones. Los túneles MCP están en vista previa de investigación y requieren una solicitud de acceso. Consulta Sandboxes autoalojados y túneles MCP.
- Ejecutarse bajo los propios controles de cumplimiento y auditoría de tu organización: Las herramientas se ejecutan en hosts que tú configuras, registras y auditas.
Lo que un sandbox autoalojado no cambia
Con cualquiera de las dos opciones, el historial de la conversación y los resultados de las herramientas van al servicio de Managed Agents, que opera Anthropic. Así es como el modelo recibe el resultado de cada llamada a una herramienta. Las herramientas de búsqueda web y de obtención web también se ejecutan del lado de Anthropic, no en el sandbox. Consulta Restringir los dominios de búsqueda web y obtención web. Ninguna de las dos opciones cambia la cobertura de cumplimiento de Managed Agents ni el tiempo durante el cual conserva el historial de la conversación. Consulta API y retención de datos.
Lo que asumes y a lo que renuncias con un sandbox autoalojado
Un sandbox autoalojado te convierte en el operador de los hosts del worker. Tú endureces la imagen del sandbox, controlas el tráfico de salida de la red, almacenas y rotas la clave de entorno, y aíslas las sesiones entre sí. La página Modelo de seguridad tiene los detalles.
También renuncias a estas funciones del entorno en la nube:
- Recursos de sesión
fileygithub_repository. Tú preparas los archivos de entrada por tu cuenta, y también eres responsable de montar tu propio repositorio de GitHub. - Descubrimiento de skills en repositorios.
- Credenciales de variables de entorno en vaults.
- Los entornos de ejecución y paquetes preinstalados de un sandbox en la nube. Un sandbox autoalojado tiene lo que tu worker proporcione.
Diferencias en Claude Platform on AWS
Si usas Claude Managed Agents a través de Claude Platform on AWS, Anthropic sigue operando el servicio. Allí, un sandbox autoalojado no puede usar almacenes de memoria, los workers no usan una clave de entorno y los túneles MCP no están disponibles. Consulta Claude Managed Agents en Claude Platform on AWS y Funciones no compatibles.
Cambia de un entorno en la nube a un sandbox autoalojado
Para cambiar a un sandbox autoalojado, conservas el agente, creas un entorno self_hosted y haces referencia a su ID en las nuevas sesiones e implementaciones.
- Lo que se conserva: La definición del agente, la clave de API o las credenciales de AWS que usa tu aplicación, tus skills, tus servidores MCP y tus almacenes de memoria.
- Lo que es nuevo: Un entorno
self_hosted, una clave de entorno que generas en la Claude Console y un worker que tú ejecutas. El inicio rápido de sandboxes autoalojados cubre los tres. - Lo que deja de funcionar: Las funciones enumeradas en Lo que asumes y a lo que renuncias con un sandbox autoalojado.
En Claude Platform on AWS, los almacenes de memoria no se conservan al pasar a un sandbox autoalojado, y el worker no usa una clave de entorno. Consulta Diferencias en Claude Platform on AWS.
Was this page helpful?