Spring Boot + Spring AI 最小可运行 Demo

一. 项目依赖(pom.xml)

XML 复制代码
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         https://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
    <artifactId>spring-ai-demo</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>jar</packaging>

    <properties>
        <java.version>17</java.version>
        <spring.boot.version>3.2.5</spring.boot.version>
        <spring.ai.version>1.0.0-M2</spring.ai.version>
    </properties>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-dependencies</artifactId>
                <version>${spring.boot.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

    <dependencies>
        <!-- Spring Web -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>

        <!-- Spring AI OpenAI Starter -->
        <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
            <version>${spring.ai.version}</version>
        </dependency>

        <!-- Lombok(可选) -->
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
            <optional>true</optional>
        </dependency>

        <!-- 测试 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <build>
        <plugins>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
            </plugin>
        </plugins>
    </build>
</project>

二. 配置文件(application.yml)

XML 复制代码
server:
  port: 8080

spring:
  ai:
    openai:
      api-key: ${OPENAI_API_KEY}   # 建议放到环境变量
      base-url: https://api.openai.com/v1
      chat:
        options:
          model: gpt-3.5-turbo

👉 如果你用的是 Ollama 本地模型(例如 Llama3),改成:

XML 复制代码
spring:
  ai:
    ollama:
      base-url: http://localhost:11434
      model: llama3

三. 启动类(SpringAiDemoApplication.java)

java 复制代码
package com.example.springaidemo;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class SpringAiDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringAiDemoApplication.class, args);
    }
}

四:控制器示例

4.1:基础对话接口

java 复制代码
package com.example.springaidemo.controller;

import lombok.RequiredArgsConstructor;
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/ai")
@RequiredArgsConstructor
public class ChatController {

    private final ChatClient chatClient;

    @GetMapping("/chat")
    public String chat(@RequestParam String msg) {
        return chatClient.prompt()
                .user(msg)
                .call()
                .content();
    }
}

访问:

bash 复制代码
http://localhost:8080/ai/chat?msg=你好,请用一句话介绍一下Spring AI

4.2:Prompt 模板示例

java 复制代码
@GetMapping("/summary")
public String summarize(@RequestParam String text) {
    String template = "请用一句话总结以下文本: {input}";
    return chatClient.prompt()
            .user(template, java.util.Map.of("input", text))
            .call()
            .content();
}

4.3 :结构化输出示例

java 复制代码
import lombok.Data;

@Data
public class WeatherInfo {
    private String location;
    private String forecast;
    private int temperature;
}
java 复制代码
@GetMapping("/weather")
public WeatherInfo getWeather(@RequestParam String place) {
    return chatClient.prompt()
            .user("请提供 {place} 的天气情况", java.util.Map.of("place", place))
            .call()
            .entity(WeatherInfo.class);
}

五: 启动 & 测试

5.1:在终端设置 API Key:

bash 复制代码
export OPENAI_API_KEY=sk-xxxx

(Windows 用 setx OPENAI_API_KEY sk-xxxx)

5.2:启动项目:

bash 复制代码
mvn spring-boot:run

5.3:测试接口:

bash 复制代码
curl "http://localhost:8080/ai/chat?msg=Spring AI 是什么?"

六: 下一步扩展

接入向量数据库(Milvus、PgVector、Redis) → 实现 RAG 知识库问答

自定义 Prompt 模板 → 支持多角色对话

私有化部署模型 → 用 Ollama 跑 Llama3 本地模型

相关推荐
武昌库里写JAVA3 小时前
SpringBoot+Vue 项目介绍
java·javascript·git·sql·ai
VIP_CQCRE3 小时前
GPT Image 2.6 商品图换背景后悬浮?接触阴影、透明区域与反射验收
图像处理·人工智能·ai·电商
泯泷4 小时前
别再傻傻地喂文件了,大厂都在偷偷给AI建这种“专属图书馆”
人工智能
学长毕设4 小时前
基于SpringBoot的儿童慈善捐赠管理系统-附源码
java·spring boot·后端
慧一居士4 小时前
@RestControllerAdvice 的注解作用和使用
java
oak隔壁找我5 小时前
一款运行在 DSH(DeepSeek Harness)中的类 Postman HTTP 接口调试插件
人工智能·程序员
高洁015 小时前
数字孪生与计算机视觉:让机器看懂现场
人工智能·python·机器学习·transformer·迁移学习
Csvn5 小时前
如果明天供应商涨价 3 倍?三层解耦,换模型只改一行配置(C05)
人工智能·aigc·agent
学长毕设5 小时前
基于SpringBoot非遗文化展示与传播平台设计与实现-附源码
java·spring boot·后端
在所不辞兄6 小时前
为什么数字孪生驱动的产线标定需要在线更新机制,而不能一次标定后长期沿用?
人工智能·神经网络·其他·算法·机器学习