跳转到主要内容
使用 AI Agent 直接操作 PPIO Agent 沙箱平台 — 构建模板、管理沙箱、部署 Agent，无需离开你的对话界面。

​
安装

向任意支持 Skill 的 AI Agent 发送以下消息，Agent 会自动完成安装： 
Read https://raw.githubusercontent.com/PPIO/ppio-skills/main/skills/ppio-sandbox/SKILL.md and follow the instructions to install
支持的平台：Claude Code、Gemini CLI、OpenClaw 及其他兼容 SKILL.md 标准的 Agent。

​
功能介绍

ppio-sandbox Skill 封装了 ppio-sandbox-cli，让 Agent 能够以自然语言驱动 PPIO Sandbox 平台的全部操作。该 Skill 包含所有 Beta 版 ppio-sandbox-cli 的功能。

​
模板管理

从 Dockerfile 构建可复用的沙箱模板。模板是创建沙箱的基础。
  • 从 Dockerfile 构建模板
  • 查看、发布、删除模板
  • 版本管理与回滚

​
沙箱管理

按需启动隔离的沙箱环境，执行任务后销毁。
  • 创建、列出、连接沙箱
  • 查看实时日志与资源指标
  • 上传、下载文件
  • 执行命令或代码
  • 克隆沙箱（并行创建多个副本）
  • 提交沙箱状态为快照模板

​
Agent Runtime

将 Python/其他语言的 Agent 打包部署到 PPIO Sandbox，通过 HTTP 调用。
  • 配置 Agent 项目（自动生成 Dockerfile）
  • 一键构建并部署
  • 流式调用已部署的 Agent

​
使用示例

​
创建沙箱

用户：帮我从模板 base 创建一个沙箱
Agent 会自动执行： 
ppio-sandbox-cli sandbox create base --detach
# 输出：Sandbox xxx created from template base

​
查看沙箱日志

用户：查看沙箱 abc123 的日志
Agent 执行： 
ppio-sandbox-cli sandbox logs abc123 -f

​
在沙箱中执行命令

用户：在沙箱 abc123 中执行 python run.py
Agent 执行： 
ppio-sandbox-cli sandbox connect abc123
# 连接后在沙箱终端中执行命令

​
克隆沙箱

用户：把沙箱 abc123 克隆 3 份
Agent 执行： 
ppio-sandbox-cli sandbox clone abc123 --count 3
# 输出：3 个新沙箱 ID，状态均为 Running

​
构建模板

用户：帮我用当前目录的 ppio.Dockerfile 构建一个叫 my-app 的模板
Agent 执行： 
ppio-sandbox-cli template build -d ppio.Dockerfile -n my-app

​
部署 Agent

用户：把这个 Python agent 部署到 PPIO Sandbox
Agent 执行： 
# Agent 会依次执行：
ppio-sandbox-cli agent configure -n my-agent -e app.py
ppio-sandbox-cli agent launch

​
触发词

以下关键词会触发此 Skill：
  • 创建沙箱、启动沙箱、列出沙箱
  • 构建模板、模板构建、查看模板
  • 部署 agent、调用 agent、发布 agent
  • 沙箱日志、沙箱指标、克隆沙箱
  • ppio-sandbox-cli、ppio sandbox

​
前置要求

  • Node.js 18+
  • PPIO 账号（用于 ppio-sandbox-cli auth login）

​
相关链接