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

# カスタムサンドボックス

> チームに必要な言語とツールを含むサンドボックスを Dockerfile から構築し、そのサンドボックスで Research セッションを開始します。

Research は、Enclave のデフォルトのサンドボックスでコマンドを実行します。チームが別の言語やツール、別の Linux ディストリビューションを必要とする場合、オーナーまたは管理者は Dockerfile から **カスタムサンドボックス** を構築できます。その後、組織の全員がそのサンドボックスでセッションを開始できます。

## 始める前に

* サンドボックスの作成、再構築、削除には、インテグレーションを管理する権限（ **Owner** または **Admin** ロール）が必要です。 [ロールと権限](https://docs.enclave.ai/ja/admin/roles.md) を参照してください。
* カスタムサンドボックスは、 [Bring Your Own Cloud](https://docs.enclave.ai/ja/deployment/byoc.md) デプロイでは利用できません。

## サンドボックスを作成する

**1. Research に依頼する**

[Research セッション](https://docs.enclave.ai/ja/research/sessions.md) で、必要なものを説明して名前を付けます。例：「エージェントが jq と protoc を実行できるサンドボックスが必要です。名前は tools にしてください。」

**2. Dockerfile を承認する**

Research は Dockerfile を作成し、ベースイメージと Dockerfile を含む **Create the sandbox tools?** カードを表示します。内容を確認し、 **Approve** をクリックします。

**3. ビルドを確認する**

ビルドカードには、ステータス（ **Queued** 、 **Building** 、 **Testing** 、 **Ready** 、 **Build failed** 、 **Cancelled** ）、経過時間、ビルドログが表示されます。停止するには **Cancel** をクリックします。

ビルドが終わると、セッションに結果が届き、Research が次に行うことを伝えます。ビルドが失敗した場合、Research は原因を説明し、修正した Dockerfile を提案できます。通知も届くため、どのページにいても結果を知ることができます。

サンドボックスは、ビルドが成功した場合にのみ保存されます。ビルドが失敗またはキャンセルされても、メンバーに見えるものは何も変わりません。

サンドボックスを変更するには、名前を指定して更新するよう Research に依頼します。 **Update the sandbox** カードが表示されます。新しいビルドが成功するまで、現在のバージョンが引き続き使用されます。

### Dockerfile のルール

* 別のオペレーティングシステムが必要な場合を除き、Dockerfile は Enclave のデフォルトのサンドボックスイメージである `enclave/base` から始めます。その他のベースイメージは、公開レジストリから取得する必要があります。
* ビルドコンテキストはありません。 `COPY` と `ADD` はローカルファイルを読み取れませんが、 `ADD` は `http(s)` URL のダウンロードや git リポジトリのクローンができます。
* Dockerfile は最大 64 KB、100 命令までです。
* ビルドは最大 30 分まで実行できます。

## サンドボックスでセッションを開始する

新しいセッションで、入力欄のサンドボックスピッカーをクリックし、 **Sandbox environment** からサンドボックスを選びます。 **Enclave default** は Enclave 独自のサンドボックスです。

セッションのサンドボックスは変わりません。別のサンドボックスを使うには、新しいセッションを開始します。

再構築中のサンドボックスは、ピッカーに **Rebuilding** と表示されます。新しいビルドが成功するまで、新しいセッションでは最後に成功したビルドが使われます。

## サンドボックスを管理する

**Settings → Sandboxes** に移動すると、組織のサンドボックス、そのステータス（ **Ready** または **Rebuilding** ）、使用中のビルドが作成された日時を確認できます。

オーナーと管理者は **Manage** をクリックして、現在の Dockerfile と最新のビルドのログを確認できます。また、次の操作ができます。

* Dockerfile からサンドボックスを **Rebuild** する。
* 実行中のビルドを **Cancel** する。
* サンドボックスを **Delete** する。そのサンドボックスを使っていたセッションはサンドボックスを再起動できなくなり、新しいセッションを開始するよう求めます。

Enclave がサンドボックスのソフトウェアを更新すると、カスタムサンドボックスは、次に誰かがそのサンドボックスでセッションを開始したときに自動的に再構築されます。それまでは、セッションでは最後に成功したビルドが使われます。

## 制限

* 1 組織あたり 3 サンドボックスまで。最初のビルドが実行中の新しいサンドボックスも、この上限に含まれます。
* 1 組織あたり、24 時間で 20 ビルドまで。更新後に Enclave が開始する再構築は含まれません。


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