全部產品
Search
文件中心

Microservices Engine:Nacos CLI 接入 AI 治理中心

更新時間:Jul 11, 2026

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