agentuity-cli-cloud-sandbox-create
Create an interactive sandbox for multiple executions. Requires authentication. Use for Agentuity cloud platform operations
安装与使用
请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求,再添加到工作流。
查看来源 ↗使用指南技能说明
Cloud Sandbox Create
Create an interactive sandbox for multiple executions
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox create [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--runtime |
string | Yes | - | Runtime name (e.g., "bun:1", "python:3.14") |
--runtimeId |
string | Yes | - | Runtime ID (e.g., "srt_xxx") |
--name |
string | Yes | - | Sandbox name |
--description |
string | Yes | - | Sandbox description |
--memory |
string | Yes | - | Memory limit (e.g., "500Mi", "1Gi") |
--cpu |
string | Yes | - | CPU limit in millicores (e.g., "500m", "1000m") |
--disk |
string | Yes | - | Disk limit (e.g., "500Mi", "1Gi") |
--network |
boolean | Yes | - | Enable outbound network access |
--idleTimeout |
string | Yes | - | Idle timeout before sandbox is reaped (e.g., "10m", "1h") |
--env |
array | Yes | - | Environment variables (KEY=VALUE) |
--file |
array | Yes | - | Files to create in sandbox (sandbox-path:local-path) |
--snapshot |
string | Yes | - | Snapshot ID or tag to restore from |
--dependency |
array | Yes | - | Apt packages to install (can be specified multiple times) |
--metadata |
string | Yes | - | JSON object of user-defined metadata |
--port |
number | Yes | - | Port to expose from the sandbox to the outside Internet (1024-65535) |
--projectId |
string | Yes | - | Project ID to associate this sandbox with |
Examples
Create a sandbox with default settings:
bunx @agentuity/cli cloud sandbox create
Create a sandbox with Python runtime:
bunx @agentuity/cli cloud sandbox create --runtime python:3.14
Create a sandbox with resource limits:
bunx @agentuity/cli cloud sandbox create --memory 1Gi --cpu 1000m
Create a sandbox with network and custom timeout:
bunx @agentuity/cli cloud sandbox create --network --idle-timeout 30m
Create a sandbox with a specific environment variable:
bunx @agentuity/cli cloud sandbox create --env KEY=VAL
Create a sandbox associated with a specific project:
bunx @agentuity/cli cloud sandbox create --project-id proj_123
Output
Returns JSON object:
{
"sandboxId": "string",
"status": "string",
"stdoutStreamUrl": "string",
"stderrStreamUrl": "string"
}
| Field | Type | Description |
|---|---|---|
sandboxId |
string | Unique sandbox identifier |
status |
string | Current sandbox status |
stdoutStreamUrl |
string | URL to the stdout output stream |
stderrStreamUrl |
string | URL to the stderr output stream |
使用示例
查看来源仓库中的使用示例与配置说明。
查看来源 ↗来源历史
- 收录时间
- 2026-01-20
- 索引更新时间
- 2026-01-26
- Branch
- main
收录与同步日期属于本站记录。源码修改历史请查看来源仓库。
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!