本文介紹如何使用 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 查看。