Spring AI 入门指南：用 Java 构建你的第一个 AI 应用

什么是 Spring AI？

Spring AI 是 Spring 官方推出的 AI 集成框架，让 Java 开发者能够以 Spring 风格轻松接入各种 AI 模型和服务。如果你熟悉 Spring 生态，上手 Spring AI 会非常自然。

环境准备

开始之前，确保你有以下环境：

• JDK 17+
• Maven 3.8+
• 一个 OpenAI API Key（或其他支持的模型提供商）

创建项目

使用 Spring Initializr 创建一个新项目，添加以下依赖：

<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
</dependency>

配置 API Key

在 application.yml 中配置你的 API Key：

spring:
  ai:
    openai:
      api-key: ${OPENAI_API_KEY}
      chat:
        options:
          model: gpt-4o
          temperature: 0.7

第一个 AI 服务

创建一个简单的聊天服务：

@Service
public class ChatService {

    private final ChatClient chatClient;

    public ChatService(ChatClient.Builder builder) {
        this.chatClient = builder.build();
    }

    public String chat(String message) {
        return chatClient.prompt()
                .user(message)
                .call()
                .content();
    }
}

就这样！你已经有了一个可以和 AI 对话的服务。

创建 REST 接口

@RestController
@RequestMapping("/api/chat")
public class ChatController {

    private final ChatService chatService;

    public ChatController(ChatService chatService) {
        this.chatService = chatService;
    }

    @PostMapping
    public Map<String, String> chat(@RequestBody Map<String, String> request) {
        String reply = chatService.chat(request.get("message"));
        return Map.of("reply", reply);
    }
}

测试运行

启动应用后，用 curl 测试：

curl -X POST http://localhost:8080/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "用一句话介绍 Spring AI"}'

下一步

• 尝试不同的模型参数（temperature、max_tokens）
• 集成向量数据库实现 RAG
• 使用 Prompt Template 管理提示词
• 探索 Spring AI Alibaba 接入国产模型

---

这就是 Spring AI 的快速入门。后续文章我们会深入探讨 RAG、Agent 等高级用法，敬请关注。