SpringBoot集成Spring AI Alibaba实现工具调用实战教程

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    <version>1.1.2.1</version>
</dependency>
<!-- dashscope-sdk 可能带旧版 jsonschema-generator，与 spring-ai-model 冲突时需对齐 -->
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.github.victools</groupId>
            <artifactId>jsonschema-generator</artifactId>
            <version>4.38.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>
<dependency>
    <groupId>com.alibaba</groupId>
    <artifactId>dashscope-sdk-java</artifactId>
    <version>2.22.18</version>
    <exclusions>
        <!-- 避免与 Boot 自带的 logback 双绑 SLF4J -->
        <exclusion>
            <groupId>org.slf4j</groupId>
            <artifactId>slf4j-simple</artifactId>
        </exclusion>
    </exclusions>
</dependency>

spring:
  application:
    name: spring-tool-demo
  ai:
    dashscope:
      api-key: ${DASHSCOPE_API_KEY}
      chat:
        options:
          # 需支持 Tool Calling 的对话模型
          model: qwen-max
          temperature: 0.7

@Component  // 交给 Spring 管理，便于注入到 ChatClient
public class DateTool {

    /**
     * description 很重要：模型靠它判断「什么时候该调这个工具」。
     * 工具名默认是方法名 getCurrentDateTime。
     */
    @Tool(description = "Get the current date and time in the user's timezone")
    public String getCurrentDateTime() {
        // 返回给模型的真实数据；模型再组织成自然语言回复用户
        return DateFormatUtil.now(); // 例如 yyyy-MM-dd HH:mm:ss
    }
}

@Component
public class WeatherTool {

    /**
     * 查询指定城市天气。
     * district 建议用拼音，如 beijing / shanghai，方便模型稳定传参。
     */
    @Tool(description = "查询指定城市的天气情况")
    public String getWeather(String district) {
        // 这里用 switch 模拟业务；真实项目可调第三方天气 API
        return switch (district) {
            case "beijing" -> "天气清凉";
            case "shanghai" -> "天气炎热";
            case "guangzhou" -> "天气闷热";
            default -> "未知地区";
        };
    }
}

@Configuration
public class ClientConfig {

    /**
     * 构建带默认工具的 ChatClient。
     * defaultTools：该 Client 每次对话都可用这些工具。
     */
    @Bean(name = "toolClient")
    public ChatClient toolClient(DashScopeChatModel chatModel,
                                 DateTool dateTool,
                                 WeatherTool weatherTool) {
        return ChatClient.builder(chatModel)
                // 传入带 @Tool 方法的对象实例即可，框架会扫注解并生成 Schema
                .defaultTools(dateTool, weatherTool)
                .build();
    }
}

Multiple tools with the same name (getCurrentDateTime) found

@RestController
public class TestController {

    @Resource(name = "toolClient")
    private ChatClient toolClient;

    /**
     * GET /get/currenttime
     * 用户说「要当前时间」→ 模型决定调用 getCurrentDateTime → 把结果组织成回答
     */
    @GetMapping("/get/currenttime")
    public String getCurrentTime() {
        return toolClient.prompt()
                .system("You are a helpful assistant.")
                .user("Get the current date and time in the user's timezone")
                // 不要再 .tools(...)，工具已在 defaultTools 里
                .call()
                .content();
    }
}

@RestController
public class WeatherController {

    @Resource(name = "toolClient")
    private ChatClient toolClient;

    /**
     * GET /get/weather?district=上海
     * system 提示把中文城市转成拼音参数，和 WeatherTool 的 case 对齐
     */
    @GetMapping("/get/weather")
    public String getWeather(@RequestParam String district) {
        return toolClient.prompt()
                .system("你可以通过工具获取天气情况,"
                        + "中文请转换成拼音作为调用工具的参数,例如上海对应'shanghai'")
                .user("查一下" + district + "的天气")
                .call()
                .content();
    }
}