Alibaba Cloud Agent Sandbox Express Edition

Built inBuilt in

Default provider of the CLI and the Python SDK. abx template deploy builds and registers templates here.

Use

python

from agent_sandbox import Sandbox

# TemplateID from abx template deploy, or the --alias you passed.
sandbox = await Sandbox.create(template="<TemplateID>")

Capabilities 18 capabilities

Sandbox

Create, connect, list, killsandbox.lifecycle

Change lifetimesandbox.timeout

Pause and resumesandbox.pause

Execution

Run a commandexec.run

Stream outputexec.stream

List and signal processesprocess.manage

Interactive terminalpty

Files

Read, write, directories, renamefiles.rw

Watch a directoryfiles.watch

Upload and download URLsfiles.transfer

Code

Code interpretercode.interpret

Templates

Read templatestemplates.read

Build templatestemplates.build

Network and storage

Port URLsports.url

Custom domainsports.domain

Mount storagestorage.mount

VPC networkingnetwork.vpc

Sessions

Named commands in the sandboxsessions

Configuration

Secrets are read only from the provider's own environment variables. The Express key is never forwarded.

Name	Environment variables	Description
`sandbox_api_key` Secret	`ABX_SANDBOX_API_KEY`	API key of the Express edition.
`region`	`ALIBABA_CLOUD_REGION_ID`	Region. Default cn-hangzhou. Not ABX_SANDBOX_REGION.
`sandbox_base_url`	`ABX_SANDBOX_BASE_URL`	Override the platform API origin.
`sandbox_domain`	`ABX_SANDBOX_DOMAIN`	Domain used for port URLs.
`access_key_id` Secret	`ALICLOUD_ACCESS_KEY_ID`	AccessKey ID for template deploy. Not ALIBABA_CLOUD_ACCESS_KEY_ID or AccessKey.
`access_key_secret` Secret	`ALICLOUD_ACCESS_KEY_SECRET`	AccessKey secret. Not ALIBABA_CLOUD_ACCESS_KEY_SECRET or AccessSecret.