Spring AI 函数调用（Tool/Function Calling）轻松入门
（2026年最新实用写法 · 零到上手完整示例）
函数调用是让大模型“知道自己不知道”并主动调用你提供的工具/函数来获取实时信息或执行操作的核心能力。
目前（2026年初）Spring AI 已经从早期的FunctionCallback升级到更强大的Tool Calling体系，主要有三种主流写法，按推荐顺序：
| 排名 | 写法风格 | 优点 | 缺点/注意点 | 推荐指数 | 难度 |
|---|---|---|---|---|---|
| 1 | @Tool注解 + 对象实例 | 最简洁、最现代、最推荐（1.0+主流） | 需要实例化类 | ★★★★★ | ★☆☆ |
| 2 | @Bean + @Description函数式 | 纯函数风格、方便测试 | 描述写在注解里，稍显分散 | ★★★★☆ | ★★☆ |
| 3 | 手动FunctionToolCallback.builder() | 最大灵活性、可动态 | 代码量多 | ★★★☆☆ | ★★★ |
推荐写法1：使用@Tool注解（最简单、最常用）
// 1. 先定义一个工具类（可以是普通的POJO）@Component// 可选，如果想自动扫描publicclassWeatherTools{@Tool(value="get_current_weather",// 工具唯一名称（模型会用这个名字调用）description="获取指定城市当前的天气信息，支持摄氏度和华氏度")publicStringgetWeather(@ToolParam(description="城市名称，如 '北京', 'Shanghai', 'Las Vegas'")Stringcity,@ToolParam(description="温度单位：celsius 或 fahrenheit，默认celsius")Stringunit){// 模拟真实查询，也可以换成调用第三方APIStringtemp=switch(city.toLowerCase()){case"beijing","北京"->"今天北京 -5℃，寒冷刺骨，多穿点！";case"shanghai","上海"->"上海今天12℃，阴天，有点湿冷";case"las vegas"->"拉斯维加斯现在是"+(unit.equalsIgnoreCase("fahrenheit")?"68°F":"20℃")+"，阳光明媚适合游泳";default->"抱歉，目前只知道北京、上海、拉斯维加斯的天气～";};returntemp;}}// 2. Controller中使用（最常用写法）@RestController@RequestMapping("/ai/tool")@RequiredArgsConstructorpublicclassToolDemoController{privatefinalChatClientchatClient;@GetMapping("/weather")publicStringaskWeather(@RequestParamStringquestion){// 直接把工具类实例传进去（支持多个）returnchatClient.prompt().user(question).tools(newWeatherTools())// ← 这里最关键// .tools(工具实例1, 工具实例2, ...) // 支持多个工具类.call().content();}}测试例子（浏览器或postman直接试）：
http://localhost:8080/ai/tool/weather?question=拉斯维加斯现在天气怎么样？用华氏度告诉我 http://localhost:8080/ai/tool/weather?question=北京今天冷不冷？模型会自动判断是否需要调用工具 → 调用 → 把结果塞回上下文 → 最终给出自然语言回答
推荐写法2：函数式（@Bean + @Description）
适合喜欢函数式风格的同学，也非常常用：
@ConfigurationpublicclassToolFunctionsConfig{@Bean@Description("获取指定城市的当前天气，支持celsius/fahrenheit两种单位")publicFunction<WeatherQuery,String>currentWeather(){returnquery->{// 模拟实现returnswitch(query.city().toLowerCase()){case"beijing"->"北京 "+(query.unit().equals("f")?"-5℃ ≈ 23°F":"-5℃")+"，冷到想回家";case"las vegas"->"Las Vegas "+(query.unit().equals("f")?"68°F":"20℃")+"，适合户外活动";default->"暂无该城市天气数据";};};}// 记录类型（作为输入参数）publicrecordWeatherQuery(Stringcity,Stringunit){}}使用方式：
chatClient.prompt().user("上海天气如何？").functions("currentWeather")// ← 使用bean名称.call().content();进阶小技巧（生产常用）
- 多个工具一起用（并行调用）
.tools(newWeatherTools(),newStockPriceTools(),newCalculatorTools())- 流式 + 工具调用（前端打字机 + 工具）
目前大多数模型流式下工具调用支持有限，建议先用普通.call()，等模型成熟再切.stream()
- 带记忆的工具对话（最实用组合）
chatClient.prompt().system("你是生活助手，会用工具帮用户解决问题").user(question).tools(newWeatherTools()).advisors(newMessageChatMemoryAdvisor(chatMemory)).call().content();- 强制/禁用工具（精细控制）
// 只允许使用某个工具.tools(newWeatherTools())// 强制调用某个工具（极少用）.toolChoice(ToolChoice.REQUIRED)// 或 ToolChoice.FORCE("get_weather")一句话总结2026年最舒服的入门函数调用方式：
ChatClient + .tools(带有@Tool注解的类实例) + DeepSeek-R1 / GPT-4o / 通义千问 / 硅基流动兼容模型快速练习建议（由易到难）：
- 实现天气查询工具（上面例子）
- 实现汇率查询工具（调用免费汇率API）
- 实现计算器工具（加减乘除）
- 实现查快递工具
- 实现生成周报/日报小工具
需要我帮你把上面任意一个练习做成更完整的可运行小项目（包含配置、假数据/真API、测试页面）吗？
直接告诉我你想先实现哪个工具～ 😄
