Spring AI 玩转工具调用：模型帮你精确设闹钟

前言

想象一下，你对 AI 说：“帮我设个 10 分钟后的闹钟。” 它一脸自信地答应，结果转头就陷入沉思：时区是哪个？现在几点？该敲什么命令？最后结果往往是，什么都没发生。

这不是 AI 偷懒，而是它天生缺乏“动手”能力。它擅长生成计划、推理、聊天，甚至能写诗作曲，却无法直接执行需要访问系统资源的操作。就像一个能精准描述菜谱的大厨，却站在厨房里两手空空。

解决办法就是让它拥有一双“可调用的手”。工具调用（Tool Calling）让 AI 能够通过预先定义的接口执行实际任务，比如获取当前时间、设置闹钟、操作文件、调用 API 等。在 Java + Spring AI 中结合 @Tool 注解，任何方法都可以变成 AI 的“外挂技能”。

本篇使用一个贴近日常的小案例：让 AI 先查当前时间，再为你设定 10 分钟后的闹钟。看似简单，却涵盖从工具注册、模型交互、时间计算到结果验证的完整流程，让你的 AI 从“纸上谈兵”升级为“实干派”，不再只是会说，而是真的会做。

简介

本文通过一个“设置闹钟”的小案例，展示如何使用 Spring AI 的 @Tool 注解将自定义方法暴露给模型调用。这个过程听起来像魔法，但其实很有逻辑：模型先调用一个工具获取当前时间，再用另一个工具设置目标时间的闹钟。整个操作就像给 AI 装上“手”和“眼”，让它不再只是会说会算，而是真正动手执行任务。

整个流程分为四步：工具定义、工具注册、模型交互和结果验证。首先，你需要定义一个工具类，用自然语言明确告诉 AI 哪些方法可以调用以及调用规则。然后将这个工具注册到 ChatClient，让模型可以访问这些方法。接下来，模型根据你的指令自动调用工具，完成时间计算和闹钟设置。最后，通过控制