Agents-Flex

Appearance

Skills 完整示例 ​

SkillsDemoMain：远程生成 PPTX 并下载 ​

仓库中的 demos/skills-demo 演示同一套 pptx Skill 在 Local、OpenSandbox 和 AIO Sandbox 中执行。 默认任务会：

  1. 发现并批量准备 Skills；
  2. 在选定 Runtime 中运行 PPTX 生成器；
  3. 生成 5 页 16:9 PowerPoint；
  4. 验证页数、元数据、文本和文件大小；
  5. 让模型继续使用 Runtime 工具完成验收；
  6. 将远程 PPTX 下载到本机 target/skills-demo-output。

先构建：

bash
mvn -pl demos/skills-demo -am install -DskipTests
export GITEE_APIKEY="your-gitee-ai-key"

Local ​

bash
SKILLS_RUNTIME=local \
mvn -f demos/skills-demo/pom.xml exec:java

OpenSandbox ​

bash
export SKILLS_RUNTIME=open-sandbox
export OPEN_SANDBOX_DOMAIN="localhost:8080"
export OPEN_SANDBOX_API_KEY="your-open-sandbox-api-key"
export OPEN_SANDBOX_IMAGE="python:3.11"

mvn -f demos/skills-demo/pom.xml exec:java

AIO Sandbox ​

bash
export SKILLS_RUNTIME=aio-sandbox
export AIO_SANDBOX_BASE_URL="http://localhost:8080"

# 仅当 AIO 启用了 JWT 时设置
export AIO_SANDBOX_TOKEN="your-jwt"

mvn -f demos/skills-demo/pom.xml exec:java

Demo 环境变量 ​

环境变量默认值说明
SKILLS_RUNTIMElocallocal、open-sandbox 或 aio-sandbox
SKILLS_DIRclasspath .claude/skills本机 Skills 根目录
SKILLS_PROMPTPPTX 验收任务自定义问题，可用 ${outputFile}
SKILLS_OUTPUT_FILERuntime 对应路径Runtime 内产物路径
SKILLS_LOCAL_OUTPUT_FILEtarget/skills-demo-output/<文件名>下载后的本机路径
SKILLS_DOWNLOAD_ENABLEDtrue是否自动回收远程产物
SKILLS_GENERATION_TIMEOUT_SECONDS300PPTX 生成命令超时
SKILLS_DEMO_TIMEOUT_SECONDS900整个模型工具会话超时
OPEN_SANDBOX_REMOTE_ROOT/workspace/skillsOpenSandbox 上传根目录
OPEN_SANDBOX_TIMEOUT_SECONDS600OpenSandbox 生命周期
OPEN_SANDBOX_READY_TIMEOUT_SECONDS30OpenSandbox 启动等待时间
AIO_SANDBOX_REMOTE_ROOT/home/gem/workspace/skillsAIO 上传根目录
AIO_SANDBOX_HTTP_TIMEOUT_SECONDS660AIO HTTP 读取超时

指定本地下载位置：

bash
export SKILLS_LOCAL_OUTPUT_FILE="$PWD/output/runtime-report.pptx"

自定义任务只有显式配置 SKILLS_OUTPUT_FILE 时才会自动下载，因为 Demo 无法从任意模型回答中可靠推断 哪个文件是最终产物。