5步在若依中写一个AI Agent： AI数据助手

5步在若依中写一个 AI Agent：从0到1跑通数据查询
导读：花了一周把 Spring AI 2.0 接进若依，整理出这份从新建模块到对话测试的完整指南。不绕弯子，每一步都有代码，30 分钟跑起来。
一份完整的动手教程，5 个步骤在若依单体框架（RuoYi-Vue + Spring Boot 4.0.3 + Java 17）上集成 AI Agent，让用户能用自然语言查询数据库。
技术栈：Spring AI 2.0 + DeepSeek。
步骤做什么核心文件
①新建 ruoyi-ai 模块，独立存放 AI 代码pom.xml
②配置 DeepSeek 模型连接，API Key 从环境变量读取application.yml
③写 3 个核心查询 Tool：用户统计、登录日志、操作日志DataQueryTool.java
④构建 AiChatService 对话逻辑，核心代码不到 20 行AiChatService.java
⑤暴露 /ai/chat 接口，Postman 测试AiChatController.java
关键设计：
• 每个 Tool 方法上加 @Tool(description = "...") 注解，Spring AI 2.0 自动注册为 OpenAI Function Calling
• 时间参数统一处理，把 today、last_month 等自然语言转成具体日期，给模型减负
• 系统指令 + 工具注册 + ReAct 循环全部由 Spring AI 自动完成
📌 关注公众号「SpringBoot之小韦」，回复 "AI Agent" 获取完整文章和后续 AI Agent 系列内容。