当前位置：首页 > news >正文

一个类，一次注册，搞定 2 个工具 + 1 个 Skill + 1 个 Sub-Agent

news 2026/7/3 2:33:33

「Regnexe 实战系列」第 4 篇（共 10 篇），对应仓库ExampleReadme04PluginAnnotationTest。上一篇：03. Sub-Agent：自己的模型，自己的工具。

痛点：能力一多，注册代码比业务代码还长

前三篇我们分别用withTool、withSkill、withSubAgent注册了工具、Skill、Sub-Agent。如果一个业务模块同时需要这三种能力，按现在的写法得分别new三个对象，再分三次with*调用——能力一多，这部分"装配代码"很容易比业务逻辑本身还长。

Regnexe 解决这个问题的思路很简单：像@Plugin注解一类工具方法一样，把 Skill 和 Sub-Agent 也变成注解，而且可以嵌套进同一个类，共享同一个pluginId。

先复习一下 @Plugin

Java 老用户应该很熟悉这个套路——类上加@Plugin，方法上加@AgentTool：

@Plugin(id="weather",name="Weather Plugin",description="天气查询")publicclassWeatherPlugin{@AgentTool("Get today's weather for a city.")publicStringgetWeather(Stringcity){return"Beijing: sunny, 22 C.";}}

这个用法没变。变化在于：现在@AgentSkill和@AgentSubAgent可以作为这个类的内部静态类，跟@AgentTool方法长在一起。

实战代码：四种能力，一个类，一次注册

仓库ExampleReadme04PluginAnnotationTest里的WeatherPlugin：

@Plugin(id="weather",name="Weather Plugin",description="Weather, air quality, travel advice, and trip cost estimation")publicclassWeatherPlugin{@AgentTool("Get today's weather for a city.")publicStringgetWeather(Stringcity){return"Beijing: sunny, 22 C.";}@AgentTool("Get today's air quality index (AQI) for a city.")publicStringgetAirQuality(Stringcity){return"Beijing: AQI 35, excellent air quality.";}@AgentSkill(id="travel_advisor",description="Gives outdoor-activity advice based on the current weather for a city. "+"TRIGGER: Use when the user asks whether the weather is suitable for an outdoor activity.",systemPrompt=""" You are an outdoor-activity advisor. 1. Call get_weather for the city the user mentions. 2. Based on the result, give a short, direct go/no-go recommendation. """,allowedTools={"weather.get_weather"}// 注意：插件内的完整能力 id)publicstaticclassTravelAdvisorSkill{// 不需要 @AgentTool 方法——Skill 不能拥有私有工具}@AgentSubAgent(id="expense_estimator",description="Estimates the total cost of a business trip. "+"TRIGGER: Use when the user asks for a trip budget or cost estimate.",model="aliyun:qwen-plus",systemPrompt=""" You are a travel expense estimator. 1. Call estimate_trip_cost with the trip length and destination. 2. Report the total and a one-line breakdown. """)publicstaticclassExpenseEstimatorSubAgent{@AgentTool("Estimates total cost for a multi-day business trip.")publicStringestimateTripCost(intdays,Stringcity){return"3-day Chengdu trip estimate: 3600 CNY total.";}}}

注册只需要一行：

RegnexeAgentagent=regnexeAgentBuilder.withDefaultModel(Vendor.ALIYUN,"deepseek-v4-flash").withPlugin(newWeatherPlugin()).withEventListener(newConsoleEventListener()).build();

一次withPlugin(new WeatherPlugin())，市场里就出现了 4 个能力：weather.get_weather、weather.get_air_quality、weather.travel_advisor、weather.expense_estimator，全部挂在同一个pluginId（weather）下面。

两个容易踩的坑

坑 1：allowedTools要写完整 id。因为travel_advisor和get_weather现在共享同一个 pluginId，工具的真实能力 id 是weather.get_weather，不是裸的get_weather。这里写错，Skill 内部就找不到这个工具，表现上会是"Skill 选中了，但回答里没有真实数据"。

坑 2：@AgentSkill类里千万别写@AgentTool方法。Skill 设计上就不持有私有工具，写了也不会被采集——记住"Skill 只能借"这条铁律（上一篇讲的）。