一. 項目依賴（pom.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.0https://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）

server:port: 8080spring:ai:openai:api-key: ${OPENAI_API_KEY}   # 建議放到環境變量base-url: https://api.openai.com/v1chat:options:model: gpt-3.5-turbo

👉 如果你用的是 Ollama 本地模型（例如 Llama3），改成：

spring:ai:ollama:base-url: http://localhost:11434model: llama3

三. 啟動類（SpringAiDemoApplication.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：基礎對話接口

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();}
}

訪問：

http://localhost:8080/ai/chat?msg=你好，請用一句話介紹一下Spring AI

4.2：Prompt 模板示例

@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 ：結構化輸出示例

import lombok.Data;@Data
public class WeatherInfo {private String location;private String forecast;private int temperature;
}

@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：

export OPENAI_API_KEY=sk-xxxx

（Windows 用 setx OPENAI_API_KEY sk-xxxx）

5.2：啟動項目：

mvn spring-boot:run

5.3：測試接口：

curl "http://localhost:8080/ai/chat?msg=Spring AI 是什么？"

六：?下一步擴展

接入向量數據庫（Milvus、PgVector、Redis） → 實現 RAG 知識庫問答

自定義 Prompt 模板 → 支持多角色對話

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