> ## 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.

# Sandbox personalizzate

> Crea una sandbox da un Dockerfile con i linguaggi e gli strumenti di cui ha bisogno il tuo team, e avvia su di essa le sessioni di Research.

Research esegue i comandi nella sandbox predefinita di Enclave. Quando il tuo team ha bisogno di altri linguaggi, strumenti o di un'altra distribuzione Linux, un Owner o un Admin può creare una **sandbox personalizzata** da un Dockerfile. Tutti i membri dell'organizzazione possono poi avviare una sessione su di essa.

## Prima di iniziare

* Per creare, ricostruire ed eliminare una sandbox serve il permesso di gestire le integrazioni: il ruolo **Owner** o **Admin**. Vedi [Ruoli e permessi](https://docs.enclave.ai/it/admin/roles.md).
* Le sandbox personalizzate non sono disponibili nei deployment [bring-your-own-cloud](https://docs.enclave.ai/it/deployment/byoc.md).

## Crea una sandbox

**1. Chiedi a Research**

In una [sessione di Research](https://docs.enclave.ai/it/research/sessions.md), descrivi ciò che ti serve e assegna un nome. Ad esempio: "Mi serve una sandbox in cui l'agente possa eseguire jq e protoc. Chiamala tools."

**2. Approva il Dockerfile**

Research scrive un Dockerfile e mostra una scheda **Create the sandbox tools?** con l'immagine di base e il Dockerfile. Controllalo e fai clic su **Approve**.

**3. Segui la build**

Una scheda di build mostra lo stato (**Queued**, **Building**, **Testing**, **Ready**, **Build failed** o **Cancelled**), il tempo trascorso e il log della build. Fai clic su **Cancel** per interromperla.

Al termine della build, la sessione riceve il risultato e Research ti dice cosa fare dopo. Se la build non è riuscita, Research spiega il motivo e può proporre un Dockerfile corretto. Ricevi anche una notifica, così lo vieni a sapere da qualsiasi pagina.

Una sandbox viene salvata solo quando la sua build va a buon fine. Una build non riuscita o annullata non cambia nulla di ciò che vedono i membri.

Per modificare una sandbox, chiedi a Research di aggiornarla indicandone il nome. Research mostra una scheda **Update the sandbox**. La versione attuale resta in uso finché la nuova build non va a buon fine.

### Regole per il Dockerfile

* Il Dockerfile parte da `enclave/base`, l'immagine della sandbox predefinita di Enclave, a meno che non ti serva un altro sistema operativo. Le altre immagini di base devono provenire da un registry pubblico.
* Non c'è un build context. `COPY` e `ADD` non possono leggere file locali, ma `ADD` può scaricare un URL `http(s)` o clonare un repository git.
* Un Dockerfile può arrivare a 64 KB e 100 istruzioni.
* Una build può durare fino a 30 minuti.

## Avvia una sessione su una sandbox

In una nuova sessione, fai clic sul selettore della sandbox nel campo di composizione e scegli una sandbox in **Sandbox environment**. **Enclave default** è la sandbox di Enclave.

Una sessione mantiene la sua sandbox. Per usarne un'altra, avvia una nuova sessione.

Una sandbox in fase di ricostruzione mostra **Rebuilding** nel selettore. Le nuove sessioni usano la sua ultima build riuscita finché quella nuova non va a buon fine.

## Gestisci le sandbox

Vai in **Settings → Sandboxes** per vedere le sandbox della tua organizzazione, il loro stato (**Ready** o **Rebuilding**) e quando è stata creata la build in uso.

Owner e Admin fanno clic su **Manage** per vedere il Dockerfile attivo e il log dell'ultima build, e per:

* **Rebuild**: ricostruire la sandbox dal suo Dockerfile.
* **Cancel**: annullare una build in corso.
* **Delete**: eliminare la sandbox. Le sessioni che la usano non possono più riavviare la loro sandbox e ti chiedono di avviare una nuova sessione.

Quando Enclave aggiorna il software delle sue sandbox, una sandbox personalizzata si ricostruisce automaticamente la volta successiva in cui qualcuno avvia una sessione su di essa. Fino ad allora le sessioni usano l'ultima build riuscita.

## Limiti

* 3 sandbox per organizzazione. Una nuova sandbox con la prima build in corso conta ai fini del limite.
* 20 build per organizzazione in un arco di 24 ore. Le ricostruzioni avviate da Enclave dopo un aggiornamento non contano.


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