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

> Crie um sandbox a partir de um Dockerfile com as linguagens e ferramentas de que sua equipe precisa e inicie sessões do Research nele.

O Research executa comandos no sandbox padrão do Enclave. Quando sua equipe precisa de outras linguagens, outras ferramentas ou outra distribuição Linux, um owner ou admin pode criar um **sandbox personalizado** a partir de um Dockerfile. Depois disso, todos na organização podem iniciar uma sessão nele.

## Antes de começar

* Criar, recriar e excluir um sandbox exige permissão para gerenciar integrações: a função **Owner** ou **Admin**. Consulte [Funções e permissões](https://docs.enclave.ai/pt-br/admin/roles.md).
* Sandboxes personalizados não estão disponíveis em deployments [bring-your-own-cloud](https://docs.enclave.ai/pt-br/deployment/byoc.md).

## Criar um sandbox

**1. Peça ao Research**

Em uma [sessão do Research](https://docs.enclave.ai/pt-br/research/sessions.md), descreva o que você precisa e dê um nome ao sandbox. Por exemplo: "Preciso de um sandbox em que o agente possa executar jq e protoc. Chame-o de tools."

**2. Aprove o Dockerfile**

O Research escreve um Dockerfile e mostra um card **Create the sandbox tools?** com a imagem base e o Dockerfile. Revise e clique em **Approve**.

**3. Acompanhe o build**

Um card de build mostra o status (**Queued**, **Building**, **Testing**, **Ready**, **Build failed** ou **Cancelled**), o tempo decorrido e o log do build. Clique em **Cancel** para interrompê-lo.

Quando o build termina, a sessão recebe o resultado e o Research diz o que fazer em seguida. Se o build falhou, o Research explica o motivo e pode propor um Dockerfile corrigido. Você também recebe uma notificação, então fica sabendo de qualquer página.

Um sandbox só é salvo quando o build dele passa. Um build com falha ou cancelado não muda nada do que os membros veem.

Para alterar um sandbox, peça ao Research para atualizá-lo pelo nome. Ele mostra um card **Update the sandbox**. A versão atual continua em uso até que o novo build passe.

### Regras do Dockerfile

* O Dockerfile começa a partir de `enclave/base`, a imagem padrão de sandbox do Enclave, a menos que você precise de outro sistema operacional. Outras imagens base precisam vir de um registro público.
* Não há contexto de build. `COPY` e `ADD` não conseguem ler arquivos locais, mas `ADD` pode baixar uma URL `http(s)` ou clonar um repositório git.
* Um Dockerfile pode ter até 64 KB e 100 instruções.
* Um build pode durar até 30 minutos.

## Iniciar uma sessão em um sandbox

Em uma nova sessão, clique no seletor de sandbox no campo de mensagem e escolha um sandbox em **Sandbox environment**. **Enclave default** é o sandbox do próprio Enclave.

Uma sessão mantém o sandbox dela. Para usar outro, inicie uma nova sessão.

Um sandbox que está sendo recriado mostra **Rebuilding** no seletor. Novas sessões usam o último build bem-sucedido até que o novo passe.

## Gerenciar sandboxes

Acesse **Settings → Sandboxes** para ver os sandboxes da sua organização, o status deles (**Ready** ou **Rebuilding**) e quando o build em uso foi feito.

Owners e admins clicam em **Manage** para ver o Dockerfile ativo e o log do build mais recente, e para:

* **Rebuild**: recriar o sandbox a partir do Dockerfile dele.
* **Cancel**: cancelar um build em andamento.
* **Delete**: excluir o sandbox. As sessões que o usam não conseguem iniciar o sandbox de novo e pedem que você inicie uma nova sessão.

Quando o Enclave atualiza o software do sandbox, um sandbox personalizado é recriado automaticamente na próxima vez que alguém iniciar uma sessão nele. Até lá, as sessões usam o último build bem-sucedido.

## Limites

* 3 sandboxes por organização. Um novo sandbox com o primeiro build em andamento conta para o limite.
* 20 builds por organização em qualquer período de 24 horas. Builds que o Enclave inicia após uma atualização não contam.


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