SpringAI 函数工具调用

工具调用

工具调用(也称为函数调用)是 AI 应用中的一种常见模式,允许模型与一组 API 或工具交互,增强其功能。

工具调用作用:

  • 信息检索

    此类工具可用于从外部来源检索信息,例如数据库、网络服务、文件系统或网络搜索引擎。目标是增强模型的知识,使其能够回答它原本无法回答的问题。因此,它们可以在检索增强生成(RAG)场景中使用。例如,可以使用工具检索特定位置的当前天气、检索最新的新闻文章或查询数据库中的特定记录。

  • 执行操作

    例如发送电子邮件、在数据库中创建新记录、提交表单或触发工作流。目标是自动化原本需要人工干预或明确编程的任务。例如,可以使用工具为与聊天机器人互动的客户预订航班、填写网页上的表单,或在代码生成场景中根据自动化测试(TDD)实现 Java 类。

工具调用链路

example

go 复制代码
@RestController
publicclass ToolController {
    @Autowired
    ChatClient chatClient;

    @GetMapping("/toolcall")
    public String toolCall(@RequestParam("msg") String msg){
        String response = chatClient.prompt(msg)
                //.tools(new DateTimeTools())
                .call()
                .content();
        return response;
    }

}

不加工具调用情况下:

自定义获取日期的函数:

go 复制代码
public class DateTimeTools {

    @Tool(description = "今天是几号以及时间的时区")
    String getCurrentDateTime() {
       String response=  LocalDateTime.now().atZone(LocaleContextHolder.getTimeZone().toZoneId()).toString();
        System.out.println("getCurrentDateTime:"+response);
        return response;
    }
}

自定义发送邮件函数工具

go 复制代码
@Tool(description = "发送邮件")
    String SendEmail(String mailText) {
        // 邮箱配置信息(替换为实际值)
        String host = "smtp.163.com";       // SMTP服务器
        String username = "from@163.com"; // 邮箱账号
        String password = "授权码";      // 邮箱授权码(非登录密码!)
        String toAddress = "to@163.com"; // 收件人

        // 邮件属性配置
        Properties props = new Properties();
        props.put("mail.smtp.host", host);
        props.put("mail.smtp.port", "465"); // SSL端口
        props.put("mail.smtp.auth", "true"); // 需要认证
        props.put("mail.smtp.ssl.enable", "true"); // 启用SSL
        props.put("mail.debug", "true"); // 调试模式(可选)

        // 创建会话
        Session session = Session.getInstance(props, new Authenticator() {
            @Override
            protected PasswordAuthentication getPasswordAuthentication() {
                returnnew PasswordAuthentication(username, password);
            }
        });
        try {
            // 创建邮件
            Message message = new MimeMessage(session);
            message.setFrom(new InternetAddress(username)); // 发件人
            message.setRecipient(Message.RecipientType.TO, new InternetAddress(toAddress)); // 收件人
            message.setSubject("SpringAI测试主题"); // 主题
            message.setText("SpringAI:"+mailText); // 纯文本内容
            // 发送邮件
            Transport.send(message);
            System.out.println("邮件发送成功!");

        } catch (MessagingException e) {
            e.printStackTrace();
            System.err.println("邮件发送失败: " + e.getMessage());
        }
        return"发送邮件成功";
    }

function作为tool进行调用

定义一个function

go 复制代码
public class WeatherService  implements Function<WeatherRequest,WeatherResponse> {
    public WeatherResponse apply(WeatherRequest request) {
        return new WeatherResponse(23.0, Unit.C);
    }
}
public enum Unit {C, F}
public record WeatherRequest(String location, Unit unit) {}
public record WeatherResponse(double temp, Unit unit) {}

定义toolcallback和调用

go 复制代码
@GetMapping("/functionCall")
    public String functionCall(@RequestParam("msg") String msg){
        //定义toolCallback
        ToolCallback toolCallback = FunctionToolCallback
                .builder("currentWeather", new WeatherService())
                .description("获取当地的天气")
                .inputType(WeatherRequest.class)
                .build();
        //调用
        String response = chatClient.prompt(msg)
                .tools(toolCallback) //调用函数
                .call()
                .content();
        return response;
    }
相关推荐
m0_720245019 小时前
QT(四)基本组件
数据库·qt·microsoft
王柏龙13 小时前
Entity Framework Core (EF Core) 中Database
数据库·microsoft
DM今天肝到几点?18 小时前
【7.26-7.28胜算云AI日报:首个开源3D世界生成模型腾讯混元、微软预示 8 月 GPT-5 发布、Nemotron推理、商汤悟能、DM夺金】
人工智能·vscode·microsoft·3d·ai·chatgpt
爱吃香蕉的阿豪1 天前
SignalR 全解析:核心原理、适用场景与 Vue + .NET Core 实战
vue.js·microsoft·c#·.netcore·signalr
Little-Hu2 天前
QML视图组件:ListView、GridView、TableView、PathView
数据库·microsoft·qml
Azure DevOps2 天前
在Azure DevOps的工作项中使用markdown
运维·microsoft·flask·azure·devops
中游鱼2 天前
如何序列化和反序列化动态 XmlElement ?
windows·microsoft·c#
Leinwin3 天前
微软Fabric重塑数据管理:Forrester报告揭示高ROI
运维·microsoft·fabric
正宗咸豆花3 天前
在 Azure 中配置 SMS 与 OTP
microsoft·flask·azure
tanak3 天前
2025年7月23日 AI 今日头条
人工智能·microsoft