Connect Nacos CLI to AI Registry - Microservices Engine - Alibaba Cloud Documentation Center

Use the Nacos CLI to manage resources such as Skills in Alibaba Cloud AI Registry.

Prerequisites

You have activated an Alibaba Cloud MSE AI Registry instance.
You have an Alibaba Cloud AccessKey ID and AccessKey Secret.
You have installed a Node.js environment to run npx commands.

Login credentials

Step 1: Choose an access method

Before using the Nacos CLI to access AI Registry, choose a network access method:

Public access: Suitable for local development, IDC, or machines not deployed in an Alibaba Cloud VPC. First configure a public endpoint and add your public IP address to the allowlist. For instructions, see Configure Public Network Access for AI Registry.
VPC private access: Suitable for ECS instances deployed in an Alibaba Cloud VPC. First configure PrivateLink to connect your VPC to AI Registry. For instructions, see AI Registry VPC Private Network Access Configuration Guide.

Step 2: Configure login credentials

On the machine running Nacos CLI, run the following command to open the interactive credential editor and enter the required information:

npx @nacos-group/cli profile edit

The following table describes the configuration items:

Parameter	Description	Example
`host`	The access address of AI Registry. For public access, enter the public endpoint domain. For VPC private access, enter the private access domain.	Private: `airegistry.cn-hangzhou.mse.aliyuncs.com` Public: `xxxx.airegistry.cn-hangzhou.mse.aliyuncs.com`
`port`	The access port.	`80`
`authType`	The authentication method. Private network access requires Alibaba Cloud AK/SK authentication.	`aliyun`
`accessKey`	The Alibaba Cloud AccessKey ID.	`LTAI5tXXXXXXXXXXXXXX`
`secretKey`	The Alibaba Cloud AccessKey Secret.	`XXXXXXXXXXXXXXXXXXXXxx`
`namespace`	The namespace ID of the AI Registry.	`xxxxxx-xxxx-xxxx-xxxx-xxxxxx`

Note

To grant permissions to an account or AccessKey ID, see AI Registry RAM Permission Configuration Guide.

Complete configuration example:

host: airegistry.cn-hangzhou.mse.aliyuncs.com
port: 80
authType: aliyun
accessKey: LTAI5tXXXXXXXXXXXXXX
secretKey: XXXXXXXXXXXXXXXXXXXXxx
namespace: xxxxxx-xxxx-xxxx-xxxx-xxxxxx

Saved credentials are used for all subsequent CLI operations.

Verification

Run the following command to verify the configuration:

npx @nacos-group/cli skill-list

A successful response returns a list of Skills, even if the list is empty. If an authentication error occurs, check your AccessKey ID, AccessKey Secret, and network connectivity. For public access, also confirm that your current public IP address has been added to the allowlist. For VPC private access, confirm that the ECS security group, VPC association, and private domain configuration are correct.

Skill management

A Skill is a reusable capability unit in AI Registry that an Agent can use. Skill version management with the Nacos CLI follows a three-step process: Upload draft → Submit for review → Release online.

Commands

Command	Description
`skill-list`	Lists the Skills in the current namespace.
`skill-describe <name>`	Displays the version details and status of a specific Skill.
`skill-get <name>`	Downloads a Skill to your local machine (defaults to `~/.skills`).
`skill-upload <path>`	Uploads a local directory as an `editing` draft.
`skill-review <name>`	Submits a draft for review.
`skill-release <name> --version <v>`	Releases an approved version online.

End-to-end example

The following example releases a Skill named skill-creator:

# 1. Upload a local directory to create an editing draft.
npx @nacos-group/cli skill-upload ./skill-creator

# 2. Submit the draft for review.
npx @nacos-group/cli skill-review skill-creator

# 3. Check the version status and wait until it becomes reviewed.
npx @nacos-group/cli skill-describe skill-creator

# 4. Release the Skill online.
npx @nacos-group/cli skill-release skill-creator --version 1.0.0

Note

The review process is asynchronous. If you run skill-release immediately after skill-review and receive an HTTP 400 parameter validate error, wait a few seconds. Then, use skill-describe to confirm that the version status has changed to reviewed before retrying.

Common queries

# Fuzzy match by name
npx @nacos-group/cli skill-list --name "creator*"

# Download a specific version to a custom directory
npx @nacos-group/cli skill-get skill-creator --version v2 -o ~/my-skills

# Output in JSON format for scripting
npx @nacos-group/cli skill-list --output json

Note

To view all available parameters for a command, run npx @nacos-group/cli <command> --help.