AI的“信息孤岛”

先看一个让人血压升高的对话：

任何后端老鸟看到这个回答都会想：我明明有一个天气接口，AI为什么不能自己调？怎么说呢，

User Pain Point:

• 业务人员手动调用接口费时费力。
• 前端需要等后端返回才能展示结果。
• 缺乏统一入口导致信息不对称。

从主要概念来看，用类比理解 Function Calling

• 声明工具：@Tool 标记方法为 AI 可调用。
• 描述 Schema：@ToolParam 说明每个参数的含义。
• AI 决策：AIGPT。

至于第一只手，查天气

模拟天气服务

public class WearTools {
@Tool
public String getWear String city) {
// 模拟数据
Map wearMap = Map.of(
"北京"。"晴，°C，微风","上海","多云转阴，°C，东南风3级","深圳","雷阵雨，°C，湿度85%","成都","阴天°C，空气质量优"
);String wear = wearMap.getOrDefault;return city + " 天气：" + wear;}
}

This annotation trio is not for humans but for AI.

• @Tool – 声明这是可被 AI 调用的方法；description 描述用途。
• @ToolParam – 指明参数含义。

注册工具到 ChatClient

package com.yunxi.ai.service;import com.yunxi.ai.tools.WearTools;按理说，import lombok.extern.slf4j.Slf4j;import org.springframework.ai.chat.client.ChatClient;import org.springframework.ai.chat.client.advisor.SimpleLoggerAdvisor;import org.springframework.stereotype.Service;import reactor.core.publisher.Flux;@Slf4j
@Service
public class ChatService {
private final ChatClient chatClient;老实说，private final WearTools wearTools;public ChatService {
this.chatClient = builder
.defaultAdvisors)
.build;this.wearTools = wearTools;}
/**
* 流式调用
*/
public Flux chatFlux {
return chatClient.prompt
.system
.user
.tools
.stream
.content
.doOnCancel -> log.info);不过，}
}

测试效果演示

• AIGPT 分析问题并决定调用 getWear.
• AIGPT 自动提取参数：city=北京。date=今天日期，其实，
• AIGPT 调用本地方法得到结果：“北京 -- 天气：晴”。
• AIGPT 将结果包装成自然语言回复给使用者。

查看 AI 实际调了哪些工具

多个 @Tool 方法：同一类暴露多种功能工具集

@Component
public class CommonTools {
@Tool
public String getWear(
@ToolParam String city。@ToolParam LocalDate date) {
// ...
}
@Tool
public String getTrafficRule(
@ToolParam String city) {
return city + "
至于今日限行尾号，3和8";}
@Tool
public String getCurrentTime {
return LocalDateTime.now.toString;}
}
根据使用者提问自动选择：


"今天天气怎么样" → 调 `getWear`;

"今天限行吗" → 调 `getTrafficRule`;

"现在几点" → 调 `getCurrentTime`;

"今天天气和限行都说一下" → 可能依次调用多个工具。

从注意事项来看。如果你希望一次性返回所有信息，请在程序提示中明确要求；否则模型可能只选择其中一种最相关的方法。

避坑教程

Pitfall 1 – AI不调用任何工具直接编造答案！**怎么办，**​​​​​​​**方法**：

• 在 `<@Tool>` 写得足够具体，例如 “必须通过 API 获取实时数据”。• 在 System Message 强调 “必须使用已公开工具获取最新信息，不得凭空造句”。

Pitfall 2 – AI 编造无效参数**怎么办？**​​​​​​**方法**：

• 工具方法内部检查支持范围；若不支持则返回友好错误提示，如 “当前城市未纳入监控范围”。• 如需更严格限制，可在 `@ToolParam` 中加入枚举或正则验证。按理说，• 对异常情况可使用 try-catch 并返回标准错误结构。让模型能识别并告知使用者。