Spring AI中Skill处理的Bean实践指南：从入门到避坑

7次阅读

没有评论

共计 1656 个字符，预计需要花费 5 分钟才能阅读完成。

在 Spring AI 框架中，Skill Bean 是 AI 技能集成的核心组件。它允许开发者将各种 AI 能力（如自然语言处理、图像识别等）封装成可复用的模块，并通过 Spring 的依赖注入机制灵活组合。典型应用场景包括：

聊天机器人中的多轮对话技能
智能客服系统中的意图识别
数据分析平台的特征提取

@Skill注解是 Spring AI 中专用的标记注解，它与 @Component 协同工作，主要实现以下功能：

标注该类是一个 AI 技能实现
自动注册到 Spring AI 的技能仓库
支持技能元数据配置（如技能名称、版本等）

Spring 容器启动时，会扫描所有带 @Skill 注解的 Bean，并将其纳入统一的技能管理体系中。

@Component
@Skill(name = "weatherQuery", version = "1.0", description = "天气查询技能")
public class WeatherQuerySkill {

    private final WeatherService weatherService;

    @Autowired
    public WeatherQuerySkill(WeatherService weatherService) {this.weatherService = weatherService;}

    @SkillMethod
    public String query(String city) {return weatherService.getWeather(city);
    }
}

@RestController
@RequestMapping("/api/skill")
public class SkillController {

    @Autowired
    private WeatherQuerySkill weatherQuerySkill;

    @GetMapping("/weather")
    public String getWeather(@RequestParam String city) {return weatherQuerySkill.query(city);
    }
}

当 Skill Bean 之间相互依赖时可能导致启动失败。解决方案：

使用 @Lazy 注解延迟初始化
重构代码消除循环引用
通过 setter 方法替代构造器注入

关键技能需要优先加载时，可以使用：

@DependsOn({"otherSkillBean"})
@Component
@Skill
public class PrioritySkill {/*...*/}

同名技能冲突时，Spring AI 默认采用最后注册的实例。建议：

通过 @Primary 指定默认实现
使用 @Qualifier 按名称精确注入
在 @Skill 注解中定义唯一技能 ID

src/main/java
├── config
├── controller
├── service
└── skill
    ├── weather
    ├── nlp
    └── vision

耗时技能实现 AsyncSkill 接口
高频调用技能添加缓存
批量处理使用 @BatchSkill 注解

@SpringBootTest
class WeatherQuerySkillTest {

    @Autowired
    private WeatherQuerySkill skill;

    @Test
    void shouldReturnWeatherInfo() {String result = skill.query("北京");
        assertThat(result).contains("天气");
    }
}