Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
agentscope-extensions-nacos 把 Nacos 用作 AgentScope 的统一控制面：注册发现 A2A Agent、动态加载 Prompt、托管 Skill。包含三个子模块，按需组合使用。
| 子模块 | 解决的问题 |
|---|---|
agentscope-extensions-nacos-a2a | A2A AgentCard 与服务实例的注册/发现 |
agentscope-extensions-nacos-prompt | 把 Prompt 模板放到 Nacos，热更新到运行中的 Agent |
agentscope-extensions-nacos-skill | 从 Nacos AI 模块加载 Skill 包（ZIP） |
<dependency>
<groupId>io.agentscope</groupId>
<artifactId>agentscope-extensions-nacos-a2a</artifactId>
<version>${agentscope.version}</version>
</dependency>
import io.agentscope.core.nacos.a2a.registry.NacosA2aRegistry;
import io.agentscope.core.nacos.a2a.registry.NacosA2aRegistryProperties;
Properties props = new Properties();
props.setProperty("serverAddr", "127.0.0.1:8848");
NacosA2aRegistry registry = new NacosA2aRegistry(props);
NacosA2aRegistryProperties props2 = new NacosA2aRegistryProperties();
// props2.setNamespace(...) / setGroup(...) 等
registry.registerAgent(agentCard, props2);
import io.agentscope.core.nacos.a2a.discovery.NacosAgentCardResolver;
NacosAgentCardResolver resolver = new NacosAgentCardResolver(props, "translator-agent");
A2aAgent remote = A2aAgent.builder()
.name("translator")
.agentCardResolver(resolver)
.build();
<dependency>
<groupId>io.agentscope</groupId>
<artifactId>agentscope-extensions-nacos-prompt</artifactId>
<version>${agentscope.version}</version>
</dependency>
import com.alibaba.nacos.api.ai.AiService;
import io.agentscope.core.nacos.prompt.NacosPromptListener;
NacosPromptListener prompts = new NacosPromptListener(aiService);
String tpl = prompts.getPrompt("system-prompt", Map.of(
"userName", "Alice"
));
getPrompt(...) 立即拿到新版本，无需重启。
agentscope-extensions-nacos-skill 提供一个 AgentSkillRepository 实现，把 Nacos AI 模块管理的技能 ZIP 包下载下来解析。
<dependency>
<groupId>io.agentscope</groupId>
<artifactId>agentscope-extensions-nacos-skill</artifactId>
<version>${agentscope.version}</version>
</dependency>
import io.agentscope.core.nacos.skill.NacosSkillRepository;
Properties props = new Properties();
props.setProperty(NacosSkillRepository.SKILL_VERSION_PATH, "1.2.0");
// 或 SKILL_LABEL_PATH = "stable"
NacosSkillRepository repo = new NacosSkillRepository(aiService, "default-namespace", props);
AgentSkill skill = repo.getSkill("calculator");
Properties → JVM -D 系统属性 → 环境变量。同时设置版本和标签时，版本优先，标签不会用于下载。