Skip to content
Nappai Documentation

Nappai Sandbox

Nappai Sandbox creates the sandbox on NappAI’s own servers. It needs no credential or account with another service.

A sandbox is an isolated, temporary computer where an agent can write and run code, install programs or work with files without touching anything else. This component connects to the Sandbox connector of the Deep Agent, which appears when you turn on Enable Sandbox in its advanced options.

When to use it

  • You want an agent to run code without hiring any outside service.
  • You need the agent to process files or do calculations in an isolated environment.
  • You want to fully isolate the sandbox from the internet.

Configuration

FieldWhat it does
Docker ImageThe sandbox’s starting environment, for example ubuntu:22.04 or python:3.12-slim. It must allow installing programs with apt, like Ubuntu. Default: ubuntu:22.04.

Advanced options

FieldWhat it does
Variables De EntornoValues the agent’s code can read inside the sandbox, such as other services’ keys, written as name and value pairs, for example {"CRM_TOKEN": "..."}. Default: none.
Memory LimitThe sandbox’s maximum memory, for example 512m or 1g. Empty, the platform default.
Network ModeNetwork access: auto (default, recommended), bridge or none (no internet access, maximum isolation).

Output

The Sandbox Backend output is the sandbox. Connect it to the Sandbox connector of the Deep Agent.

Example

A finance team wants an agent to analyse spreadsheets with code.

  1. In the Deep Agent, turn on Enable Sandbox.
  2. Add Nappai Sandbox and connect Sandbox Backend to the agent’s Sandbox connector.
  3. Ask the agent in the chat to compute the totals per quarter.