本文介绍如何使用 Nacos CLI 管理阿里云 AI 治理中心中的资源(如 Skill)。
前提条件
已开通阿里云 MSE AI 治理中心实例。
已准备好阿里云 AccessKey / SecretKey。
已安装 Node.js 环境(用于运行 npx 命令)。
配置访问 AI 治理中心登录凭证
步骤一:选择访问方式
Nacos CLI 访问 AI 治理中心前,需要先选择网络接入方式:
公网访问:适合本地开发、IDC 或未部署在阿里云 VPC 内的机器。请先参考AI 治理中心公网访问配置指南添加公网接入点,并将当前公网出口 IP 加入白名单。
VPC 私网访问:适合部署在阿里云 VPC 内的 ECS。请先参考AI 治理中心 VPC 私网访问配置指南完成 PrivateLink 配置。
步骤二:配置 Nacos CLI 登录凭证
在运行 Nacos CLI 的机器上,执行以下命令进入交互式凭证编辑界面,按提示填写各项信息:
npx @nacos-group/cli profile edit各配置项说明如下:
配置项 | 说明 | 示例 |
| AI 治理中心访问地址。公网访问填写公网接入点域名;VPC 私网访问填写私网访问域名。 | 私网: 公网: |
| 访问端口。 |
|
| 认证方式,私网访问使用阿里云 AK/SK 认证。 |
|
| 阿里云 AccessKey ID。 |
|
| 阿里云 AccessKey Secret。 |
|
| AI 治理中心的命名空间 ID。 |
|
如何对账号或 AccessKey ID 进行授权,请参考AI 治理中心 RAM 权限配置指南。
完整配置示例:
host: airegistry.cn-hangzhou.mse.aliyuncs.com
port: 80
authType: aliyun
accessKey: LTAI5tXXXXXXXXXXXXXX
secretKey: XXXXXXXXXXXXXXXXXXXXxx
namespace: xxxxxx-xxxx-xxxx-xxxx-xxxxxx凭证信息保存后,后续使用 CLI 时无需再次设置。
验证配置
配置完成后,可通过以下命令验证连接是否正常:
npx @nacos-group/cli skill-list若返回 skill 列表(或空列表),说明凭证配置成功。若提示认证失败,请检查 AccessKey、SecretKey 和网络连通性。公网访问时请同时确认当前公网出口 IP 已加入白名单;VPC 私网访问时请确认 ECS 所在 VPC、安全组和私网域名配置正确。
Skill 操作指南
Skill 是 AI 治理中心中可被 Agent 复用的能力单元。Nacos CLI 通过「上传草稿 → 提交评审 → 发布上线」三步管理 Skill 版本。
命令一览
命令 | 作用 |
| 列出当前命名空间下的 Skill。 |
| 查看某个 Skill 的版本详情与状态。 |
| 下载 Skill 到本地(默认 |
| 上传本地目录为 |
| 提交草稿评审。 |
| 发布已评审通过的版本上线。 |
端到端示例
以发布一个名为 skill-creator 的 Skill 为例:
# 1. 上传本地目录,生成 editing 草稿
npx @nacos-group/cli skill-upload ./skill-creator
# 2. 提交评审
npx @nacos-group/cli skill-review skill-creator
# 3. 查看版本状态,等待变为 reviewed
npx @nacos-group/cli skill-describe skill-creator
# 4. 发布上线
npx @nacos-group/cli skill-release skill-creator --version 1.0.0评审是异步推进的,若 skill-review 后立即调用 skill-release 返回 HTTP 400 parameter validate error,请等待几秒后通过 skill-describe 确认版本进入 reviewed 再重试。
常用查询
# 按名称模糊匹配
npx @nacos-group/cli skill-list --name "creator*"
# 下载指定版本到自定义目录
npx @nacos-group/cli skill-get skill-creator --version v2 -o ~/my-skills
# JSON 输出,便于脚本消费
npx @nacos-group/cli skill-list --output json各命令的完整参数可通过 npx @nacos-group/cli <command> --help 查看。