Skip to main content
agentscope-extensions-nacos uses Nacos as AgentScope’s unified control plane: register and discover A2A Agents, hot-load prompts, and host skills. It contains three sub-modules — pick the ones you need.

A2A registry & discovery

Add the dependency

Server side: register the AgentCard with Nacos

After registration, the AgentCard and the service endpoint are written into the Nacos AI Service for consumers to discover.

Client side: resolve a remote AgentCard via Nacos

Prompt config center

Add the dependency

Usage

The listener maintains a local cache; when prompts change in Nacos, updates are pushed in. The next getPrompt(...) call returns the new version with no restart.

Skill repository

agentscope-extensions-nacos-skill provides an AgentSkillRepository implementation that downloads and parses skill ZIP packages managed by the Nacos AI module.
Version/label resolution order: Properties provided to the constructor → JVM -D system properties → environment variables. When both version and label resolve, version wins and the label is not used for download.

Pairs well with

  • A2A: inject a Nacos-backed AgentRegistry into AgentScopeA2aServer.builder().agentRegistry(...) to publish AgentCards cluster-wide on startup.
  • Skill repositories: coexist with Git/MySQL AgentSkillRepository to assemble a Toolkit from multiple sources.