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 本地模型

相关推荐
文火冰糖的硅基工坊12 小时前
[人工智能-大模型-72]:模型层技术 - 模型训练六大步:①数据预处理 - 基本功能与对应的基本组成函数
开发语言·人工智能·python
凭君语未可12 小时前
深度解析Java的多态特性
java·开发语言
晚霞apple12 小时前
三维重建技术的未来创新方向
论文阅读·人工智能·深度学习·神经网络·机器学习
华仔啊13 小时前
JVM参数到底配在哪?7大场景全解,新手不再迷茫!
java·jvm
NocoBase13 小时前
GitHub 上最值得关注的 14 个开源 AI 低代码工具
人工智能·低代码·github
无风听海13 小时前
神经网络之语义空间
人工智能·深度学习·神经网络
cxr82813 小时前
AI提示工程第一性原理:精通原子提示,激发语言模型的基本单位
人工智能·语言模型·自然语言处理
X.AI66613 小时前
YouTube评论情感分析项目84%正确率:基于BERT的实战复现与原理解析
人工智能·深度学习·bert
艾莉丝努力练剑13 小时前
【C++:继承】面向对象编程精要:C++继承机制深度解析与最佳实践
开发语言·c++·人工智能·继承·c++进阶
penguin_bark13 小时前
C++ 异步编程(future、promise、packaged_task、async)
java·开发语言·c++