> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enclave.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Enclave in these docs is the code and cloud security platform at enclave.ai. It is not Open Enclave, Intel SGX or other hardware enclaves, or enclave.gg.
> People use Enclave in the web app at https://app.enclave.ai or the desktop app. These docs describe no public Enclave API or CLI, so don't invent endpoints, commands, or config files.
> Connecting an integration needs a person to sign in and approve access in a browser. Tell the user the exact step to take instead of saying you completed it.

# Sandboxes personalizados

> Crea un sandbox a partir de un Dockerfile con los lenguajes y las herramientas que necesita tu equipo, e inicia sesiones de Research en él.

Research ejecuta comandos en el sandbox predeterminado de Enclave. Cuando tu equipo necesita otros lenguajes, otras herramientas u otra distribución de Linux, alguien con el rol Owner o Admin puede crear un **sandbox personalizado** a partir de un Dockerfile. Después, cualquier persona de la organización puede iniciar una sesión en él.

## Antes de empezar

* Crear, reconstruir y eliminar un sandbox requiere permiso para gestionar integraciones: el rol **Owner** o **Admin**. Consulta [Roles y permisos](https://docs.enclave.ai/es/admin/roles.md).
* Los sandboxes personalizados no están disponibles en los despliegues [bring-your-own-cloud](https://docs.enclave.ai/es/deployment/byoc.md).

## Crear un sandbox

**1. Pídeselo a Research**

En una [sesión de Research](https://docs.enclave.ai/es/research/sessions.md), describe lo que necesitas y ponle un nombre. Por ejemplo: "Necesito un sandbox donde el agente pueda ejecutar jq y protoc. Llámalo tools."

**2. Aprueba el Dockerfile**

Research escribe un Dockerfile y muestra una tarjeta **Create the sandbox tools?** con la imagen base y el Dockerfile. Revísalo y haz clic en **Approve**.

**3. Sigue la compilación**

Una tarjeta de compilación muestra el estado (**Queued**, **Building**, **Testing**, **Ready**, **Build failed** o **Cancelled**), el tiempo transcurrido y el log de compilación. Haz clic en **Cancel** para detenerla.

Cuando termina la compilación, la sesión recibe el resultado y Research te dice qué hacer a continuación. Si la compilación falló, Research explica por qué y puede proponer un Dockerfile corregido. También recibes una notificación, así que te enteras desde cualquier página.

Un sandbox solo se guarda cuando su compilación se completa correctamente. Una compilación fallida o cancelada no cambia nada de lo que ven los miembros.

Para cambiar un sandbox, pide a Research que lo actualice por su nombre. Research muestra una tarjeta **Update the sandbox**. La versión actual sigue en uso hasta que la nueva compilación se completa correctamente.

### Reglas del Dockerfile

* El Dockerfile parte de `enclave/base`, la imagen de sandbox predeterminada de Enclave, salvo que necesites otro sistema operativo. Las demás imágenes base deben venir de un registro público.
* No hay contexto de compilación. `COPY` y `ADD` no pueden leer archivos locales, pero `ADD` puede descargar una URL `http(s)` o clonar un repositorio git.
* Un Dockerfile puede tener hasta 64 KB y 100 instrucciones.
* Una compilación puede durar hasta 30 minutos.

## Iniciar una sesión en un sandbox

En una sesión nueva, haz clic en el selector de sandbox del editor de mensajes y elige un sandbox en **Sandbox environment**. **Enclave default** es el sandbox propio de Enclave.

Una sesión conserva su sandbox. Para usar otro, inicia una sesión nueva.

Un sandbox que se está reconstruyendo muestra **Rebuilding** en el selector. Las sesiones nuevas usan su última compilación correcta hasta que la nueva se completa.

## Gestionar sandboxes

Ve a **Settings → Sandboxes** para ver los sandboxes de tu organización, su estado (**Ready** o **Rebuilding**) y cuándo se hizo la compilación en uso.

Quienes tienen el rol Owner o Admin hacen clic en **Manage** para ver el Dockerfile activo y el log de la última compilación, y para:

* **Rebuild**: reconstruir el sandbox a partir de su Dockerfile.
* **Cancel**: cancelar una compilación en curso.
* **Delete**: eliminar el sandbox. Las sesiones que lo usan no pueden volver a iniciar su sandbox y te piden que inicies una sesión nueva.

Cuando Enclave actualiza el software de su sandbox, un sandbox personalizado se reconstruye automáticamente la próxima vez que alguien inicia una sesión en él. Hasta entonces, las sesiones usan la última compilación correcta.

## Límites

* 3 sandboxes por organización. Un sandbox nuevo cuya primera compilación está en curso cuenta para el límite.
* 20 compilaciones por organización en cualquier periodo de 24 horas. Las reconstrucciones que inicia Enclave después de una actualización no cuentan.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.