Skip to main content
The PPIO console is the web interface for Agent Sandbox. It lists the sandboxes, templates and snapshots of a team, shows usage and quotas, and creates a sandbox without the SDK or the CLI. This page describes the sections and the two flows that the console covers on its own.

AGENT SANDBOX pages

AGENT SANDBOX › Sandboxes

Search running sandboxes by ID and filter by creation time, template, vCPU and memory.

AGENT SANDBOX › Templates

Public PPIO templates and the team’s own, searched by ID, visibility, vCPU and memory.

AGENT SANDBOX › Snapshots

Lists saved snapshots that new sandboxes can start from.

AGENT SANDBOX › Playground

Creates a sandbox in the browser.

AGENT SANDBOX › Usage

Shows the daily resource usage and cost of the team.

AGENT SANDBOX › Quotas & Limits

Shows the team’s quota values and the form for a higher limit.
The sandbox list searches by sandbox ID and filters by creation time, template, vCPU, memory and other attributes. The template list holds public templates provided by PPIO and the team’s own custom templates; search by template ID, and filter by visibility (public, private or all), vCPU and memory.

Sandbox list actions

The AGENT SANDBOX › Sandboxes page reloads with Refresh, and Create sandbox opens the Playground. Each row of the list has these actions:

Connect

Offers Open web terminal and Copy CLI command for reaching the sandbox.

Save as snapshot

Saves the current state of the sandbox as a snapshot.

Extend timeout

Adds time to the remaining lifetime of the sandbox.

Pause

Suspends the sandbox and keeps its state.

Resume

Brings a paused sandbox back to Running.

Kill

Terminates the sandbox.

Open details

Opens the sandbox page, with the tabs Overview, Metrics, Logs, Terminal and Events.

Copy Sandbox ID

Copies the sandbox ID.

Create a sandbox from the Playground

1

Open the Playground

Go to AGENT SANDBOX › Playground in the console.
2

Choose a region

Select the Region. The Source list changes with the region.
3

Choose a source

Select the Source: a template or a snapshot.
4

Set the lifecycle

Under Lifecycle, choose Long running or Custom.
5

Set the timeout behavior

Under On timeout, choose Pause or Kill. To resume the sandbox when a request arrives after a pause, enable Auto-resume. The option appears only when On timeout is Pause.
6

Add metadata

Add entries under Metadata (Optional) if the sandbox needs them. Metadata is fixed after creation.
7

Create the sandbox

Select Create sandbox.

Save a sandbox as a snapshot

1

Open the sandbox list

Go to AGENT SANDBOX › Sandboxes.
2

Start the snapshot

In the row of a running sandbox, open the actions and select Save as snapshot.
3

Save the snapshot

Optionally enter a name, then save the snapshot.
The name is permanent and cannot be changed after the snapshot is created.
For what a snapshot contains, see Save and restore sandbox state with snapshots.

Usage

AGENT SANDBOX › Usage shows three daily figures for the team. All resources are billed by the second and displayed at daily granularity. A chart shows the usage trend.
Usage data does not always include the most recent usage. It can differ slightly from the final bill. Final charges come from the bill in Billing › Overview.
Last modified on November 19, 2026