立即体验
搜索文档

开始使用

Agent Skills

把VOLCENGING装进编码 Agent，用自然语言管理弹性部署、Job 批处理、裸金属、存储与镜像预热。

源码与 skill 定义见 suanleme/gongji-skills。

说明

把下面这句话发给 Agent，让它替你安装：

请打开 VOLCENGING 文档中心 ，按页面步骤安装VOLCENGING Agent Skills。

我是人类

快速开始

一条命令即可安装全部 skill，适用于 Cursor、Claude Code 等 Agent：

bash
npx skills add suanleme/gongji-skills

安装完成后，在对应 skill 目录复制环境变量模板并填入密钥（不要提交 .env）：

bash
cp .env.example .env

必填 SUANLI_TOKEN。在控制台右上角头像进入 API 密钥，推荐使用简易模式（Token 模式），无需加签。

密钥创建步骤见 Open API 使用文档。RSA 模式见 RSA 模式。

重启 Agent 后即可开始使用。

确认已接通

可以先问：

  • 「列出我的弹性部署任务」
  • 「查一下 Job 批处理任务状态」

如果 Agent 能返回平台上的任务列表，说明凭证和 skill 已经就绪。

包含哪些 skill

安装后会得到一组按产品划分的 skill：

  • volcenging-deployment：弹性部署任务全生命周期、节点扩缩、日志与事件、计费、对象存储与 NAS 挂载 volcenging-deployment：弹性部署任务全生命周期、节点扩缩、日志与事件、计费、对象存储与 NAS 挂载

  • volcenging-job：Job 批处理创建 / 查询 / 停止、任务队列、资源与计费 volcenging-job：Job 批处理创建 / 查询 / 停止、任务队列、资源与计费

  • volcenging-metal：裸金属机器、订单与计费

  • volcenging-nas-storage：集群存储卷、SFTP、与对象存储的 S3 互传 volcenging-nas-storage：集群存储卷、SFTP、与对象存储的 S3 互传

  • volcenging-image-preheat：镜像预热创建 / 查询 / 更新 / 停止 volcenging-image-preheat：镜像预热创建 / 查询 / 更新 / 停止

也可以只装其中一个：

bash
npx skills add suanleme/gongji-skills --skill suanli-deployment

常用安装选项

bash
# 列出仓库内 skill，不安装
npx skills add suanleme/gongji-skills --list

# 只装某一个
npx skills add suanleme/gongji-skills --skill suanli-job

# 全局安装（跨项目可用）
npx skills add suanleme/gongji-skills -g

# 装全部 skill 到已检测到的 Agent
npx skills add suanleme/gongji-skills --all

更新与卸载

bash
# 更新已安装的 skill
npx skills update

# 卸载（名称以 npx skills list 为准）
npx skills remove suanli-deployment

若命令提示名称不匹配，先执行 npx skills list，再用列表里的名称卸载。

了解更多

Open API

获取 API 密钥并完成首次调用

RSA 模式

生产环境签名鉴权

我是 Agent

以下步骤专门给 AI Agent 执行。部分步骤需要用户在浏览器里操作。

前提

安装前确认环境已安装：

  • Node.js（npm / npx）

  1. 安装

    安装全部VOLCENGING skill：

    bash
    npx -y skills add suanleme/gongji-skills -y

    只装一个 skill：

    bash
    npx -y skills add suanleme/gongji-skills --skill suanli-deployment -y

    可用 --skill 值：suanli-deployment、suanli-job、suanli-metal、suanli-nas-storage、suanli-image-preheat。

  2. 配置凭证

    在已安装的 skill 目录复制环境变量模板。不要提交 .env。

    bash
    cp .env.example .env

    必填：SUANLI_TOKEN。

    请用户打开 API 密钥，创建 Token 模式 密钥（简易模式，无需加签），并把 token 贴进 .env。

    请在需要时查看：密钥创建见 Open API。RSA 模式见 RSA。

  3. 重启

    安装 skill 并写好 .env 后，重启 Agent。

  4. 验证

    请用户发起（或直接执行）一次检查，例如：

    • 列出我的弹性部署任务
    • 查一下 Job 批处理任务状态

    如果 Agent 能返回VOLCENGING上的任务，说明凭证和 skill 已就绪。

更多命令

bash
# 列出仓库内 skill，不安装
npx -y skills add suanleme/gongji-skills --list

# 全局安装（跨项目可用）
npx -y skills add suanleme/gongji-skills -g -y

# 更新已安装的 skill
npx skills update

# 卸载（名称以 npx skills list 为准）
npx skills remove suanli-deployment

若命令提示名称不匹配，先执行 npx skills list，再用列表里的名称。