Nacos CLI 接入 AI 治理中心

更新时间:
复制 MD 格式

本文介绍如何使用 Nacos CLI 管理阿里云 AI 治理中心中的资源(如 Skill)。

前提条件

  • 已开通阿里云 MSE AI 治理中心实例。

  • 已准备好阿里云 AccessKey / SecretKey。

  • 已安装 Node.js 环境(用于运行 npx 命令)。

配置访问 AI 治理中心登录凭证

步骤一:选择访问方式

Nacos CLI 访问 AI 治理中心前,需要先选择网络接入方式:

步骤二:配置 Nacos CLI 登录凭证

在运行 Nacos CLI 的机器上,执行以下命令进入交互式凭证编辑界面,按提示填写各项信息:

npx @nacos-group/cli profile edit

各配置项说明如下:

配置项

说明

示例

host

AI 治理中心访问地址。公网访问填写公网接入点域名;VPC 私网访问填写私网访问域名。

私网:airegistry.cn-hangzhou.mse.aliyuncs.com

公网:xxxx.airegistry.cn-hangzhou.mse.aliyuncs.com

port

访问端口。

80

authType

认证方式,私网访问使用阿里云 AK/SK 认证。

aliyun

accessKey

阿里云 AccessKey ID。

LTAI5tXXXXXXXXXXXXXX

secretKey

阿里云 AccessKey Secret。

XXXXXXXXXXXXXXXXXXXXxx

namespace

AI 治理中心的命名空间 ID。

xxxxxx-xxxx-xxxx-xxxx-xxxxxx

说明

如何对账号或 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-list

列出当前命名空间下的 Skill。

skill-describe <name>

查看某个 Skill 的版本详情与状态。

skill-get <name>

下载 Skill 到本地(默认 ~/.skills)。

skill-upload <path>

上传本地目录为 editing 草稿。

skill-review <name>

提交草稿评审。

skill-release <name> --version <v>

发布已评审通过的版本上线。

端到端示例

以发布一个名为 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 查看。