罗马尼亚网站后缀,如何创建网站平台,网络系统分类,全国文明城市创建标语这是一个 完整的 Spring AI 函数调用实例#xff0c;涵盖从函数定义、注册到实际调用的全流程#xff0c;以「天气查询」功能为例#xff0c;结合代码详细说明#xff1a; 1. 环境准备
1.1 添加依赖
!-- Spring AI OpenAI --
dependencygroupIdo…这是一个 完整的 Spring AI 函数调用实例涵盖从函数定义、注册到实际调用的全流程以「天气查询」功能为例结合代码详细说明 1. 环境准备
1.1 添加依赖
!-- Spring AI OpenAI --
dependencygroupIdorg.springframework.ai/groupIdartifactIdspring-ai-openai-spring-boot-starter/artifactId
/dependency1.2 配置 OpenAI 密钥
# application.properties
spring.ai.openai.api-keyYOUR_API_KEY
spring.ai.openai.chat.options.modelgpt-3.5-turbo-01252. 定义函数逻辑
2.1 天气服务接口
Service
public class WeatherService {// 模拟天气数据存储private MapString, String weatherData Map.of(北京, 晴气温 25°C,上海, 多云气温 28°C,广州, 阵雨气温 30°C);/*** 定义函数获取当前天气* Function 注解描述函数元数据*/Function(name getCurrentWeather,description 获取指定城市的当前天气信息,inputType Function.Parameter(type object,properties Function.ParameterProperty(name location, type string, description 城市名称如 北京)))public String getWeather(RequestParam String location) {return weatherData.getOrDefault(location, 暂无该城市天气数据);}
}3. 注册函数到 Spring AI
3.1 函数回调配置
Configuration
public class FunctionConfig {Beanpublic FunctionCallback weatherFunction(WeatherService weatherService) {return new FunctionCallbackWrapper(getCurrentWeather, // 函数名称必须与 Function 注解一致获取天气信息, // 函数描述可选weatherService::getWeather, // 函数实现方法引用new WeatherRequestConverter() // 参数转换器见下一步);}// 参数转换器将模型传入的 JSON 参数转换为 Java 对象private static class WeatherRequestConverter implements ConverterString, String {Overridepublic String convert(String source) {// 解析 JSON 参数示例简化实际可使用 Jacksonreturn source.replaceAll(\, ).split(:)[1].trim();}}
}3.2 启用函数调用
Configuration
public class ChatConfig {Beanpublic ChatClient chatClient(OpenAiChatClient chatClient,ListFunctionCallback functionCallbacks) {// 将函数回调注册到 ChatClientchatClient.setFunctionCallbacks(functionCallbacks);return chatClient;}
}4. 实现对话接口
RestController
public class ChatController {Autowiredprivate ChatClient chatClient;PostMapping(/chat)public String chat(RequestBody String userMessage) {// 构造对话请求UserMessage message new UserMessage(userMessage,OpenAiChatOptions.builder().withFunctionCallbacks(List.of(getCurrentWeather)) // 允许调用的函数.build());// 发送请求并获取响应ChatResponse response chatClient.call(message);// 处理可能的函数调用结果if (response.getMetadata().containsKey(function_call)) {return handleFunctionCall(response);}return response.getResult().getOutput().getContent();}private String handleFunctionCall(ChatResponse response) {// 解析函数调用请求String functionName response.getMetadata().get(function_call.name).toString();String functionArgs response.getMetadata().get(function_call.arguments).toString();// 执行函数此处实际由 Spring AI 自动处理此处仅为演示String result 执行函数 functionName 参数: functionArgs;// 将结果回传模型生成最终回答ChatResponse finalResponse chatClient.call(new UserMessage(函数执行结果 result));return finalResponse.getResult().getOutput().getContent();}
}5. 完整流程测试
测试请求 1直接提问
curl -X POST http://localhost:8080/chat -H Content-Type: text/plain -d 北京现在的天气怎么样模型响应流程
模型识别需要调用 getCurrentWeather(location北京)。Spring AI 自动触发 WeatherService.getWeather(北京)。函数返回 晴气温 25°C。模型生成最终回答北京当前的天气是晴气温 25°C。
测试请求 2需要澄清参数
curl -X POST http://localhost:8080/chat -d 帮我查一下天气模型响应
请问您要查询哪个城市的天气6. 关键代码解析
6.1 函数元数据的重要性
Function 注解提供模型理解函数用途的关键信息影响模型是否决定调用。参数描述清晰的参数描述如 location 类型为城市名称提升模型参数提取准确性。
6.2 函数执行流程
模型决策根据用户输入模型决定是否调用函数。参数解析WeatherRequestConverter 将模型传入的 JSON 参数转为 Java 类型。自动执行Spring AI 自动调用注册的 WeatherService.getWeather() 方法。结果回传函数返回结果自动注入后续对话上下文模型生成最终回答。 7. 扩展场景
7.1 多函数协同
定义更多函数并注册
// 股票查询函数
Function(name getStockPrice, description 查询股票实时价格)
public String getStockPrice(RequestParam String symbol) { ... }// 注册
Bean
public FunctionCallback stockFunction(StockService stockService) { ... }7.2 动态函数调用列表
根据用户身份动态启用不同函数
UserMessage message new UserMessage(input,OpenAiChatOptions.builder().withFunctionCallbacks(getAllowedFunctions(userRole)) // 根据角色返回允许的函数列表.build()
);8. 调试技巧
查看元数据检查 response.getMetadata() 中的 function_call.* 字段。日志拦截添加 Advisor 记录函数调用请求和响应。模拟测试使用 Mock 替换真实函数实现验证参数传递逻辑。 将函数调用无缝集成到 Spring Boot 应用以后即可实现动态数据获取与业务逻辑触发。如需进一步优化如异步执行函数可结合 Async 或消息队列扩展。
