Skip to main content
The Compute Sandbox is an isolated execution environment that lets Airia Agent perform complex, code-driven tasks — running custom scripts, using Python libraries, processing files, or executing multi-step logic that goes beyond what a standard tool call can do. When a user with sandbox access submits a request that requires this kind of work, Airia Agent runs the task in a dedicated container. Skills Repositories (collections of scripts and data files you upload) are mounted into that container at execution time, making your custom code and data available to the agent.

​
When to use the sandbox

​
Configure sandbox access

1

Open the Compute Sandbox tab

Navigate to Settings → Airia Agent → Compute Sandbox.
2

Enable the sandbox

Toggle Enable Compute Sandbox on.
3

Select users or groups

Choose which users get sandboxed execution. Options:
  • All users — every user with Airia Agent access runs in the sandbox
  • Specific users and groups — only selected users run in the sandbox; everyone else uses standard (non-sandboxed) execution
4

Save

Click Save. The sandbox is active for the selected users immediately.
Users not assigned to the sandbox continue to use Airia Agent normally — they simply cannot trigger sandboxed execution or benefit from mounted Skills Repositories.

​
Performance considerations

Sandboxed execution starts a dedicated container for each conversation session. There is a small amount of startup latency the first time a session uses the sandbox (typically a few seconds). Subsequent tasks within the same session reuse the same container and are not significantly slower. Set expectations with users who are assigned sandbox access — particularly for workflows where they kick off complex tasks immediately after opening Chat.
The compute sandbox becomes significantly more powerful when paired with Skills Repositories — collections of code and data files mounted into the sandbox at execution time. Manage Skills Repositories →
To get started quickly, use the Download Airia’s recommended skills package link on the Compute Sandbox tab (or download it here), then import the ZIP file into a repository. See Upload a zip archive.