springai的入门demo
时间: 2025-03-27 15:31:49 浏览: 66
<think>好的,我现在需要帮助用户了解如何创建一个Spring AI的入门Demo。首先,我得确认用户对Spring AI的了解程度。可能他们听说过Spring框架,但不知道Spring AI的具体用途。Spring AI应该是Spring生态系统中的一个新项目,用于集成人工智能功能,比如调用大模型API。
接下来,我需要确定用户的需求。用户想要一个入门Demo,所以应该提供一个简单的示例,展示如何快速开始使用Spring AI。可能需要包括环境搭建、依赖配置、基本代码示例和运行步骤。
首先,考虑项目搭建。用户可能使用Maven或Gradle,所以需要提供两种构建工具的依赖配置。Spring AI可能需要在Spring Boot项目中集成,所以需要Spring Boot的起步依赖。
然后,考虑需要哪些依赖项。核心的Spring AI Starter肯定是必须的,还可能涉及到具体的大模型提供商,比如OpenAI或Ollama。假设用户使用OpenAI的API,需要添加对应的Spring AI OpenAI依赖。
接下来,配置API密钥。用户需要在application.properties或application.yml中设置API密钥,这部分需要详细说明,包括如何获取OpenAI的密钥。
然后,编写一个简单的Controller,提供一个REST接口,调用AI服务。例如,创建一个ChatController,注入ChatClient,然后通过GET接口接收提示词,返回AI的响应。
测试部分也需要说明,比如使用curl或Postman发送请求,查看返回结果。可能还需要处理可能出现的错误,比如API密钥不正确,或者依赖未正确添加。
另外,可能需要提到其他可选的模型提供商,比如Ollama本地运行的情况,这样用户如果没有OpenAI账号也能在本地尝试。这时候需要说明如何修改依赖和配置,以及启动Ollama服务。
还要注意Spring AI的版本兼容性,确保用户使用的Spring Boot版本与Spring AI兼容。例如,当前最新的Spring AI版本可能需要Spring Boot 3.x以上。
最后,总结步骤,确保用户能够一步步跟随操作,成功运行Demo。可能还需要提醒常见问题,比如网络问题导致API调用失败,或者依赖下载不了的情况,建议检查Maven仓库配置或Gradle设置。
现在整理这些思路,分步骤详细说明,确保用户能够顺利入门Spring AI。</think>以下是一个简单的 Spring AI 入门 Demo 实现步骤:
---
### 一、环境准备
1. **JDK 17+**
Spring AI 需要 Java 17 或更高版本
2. **创建 Spring Boot 项目**
使用 [start.spring.io](https://start.spring.io/) 创建项目,选择:
- Spring Boot 3.2+
- 依赖项:Spring Web
---
### 二、添加 Spring AI 依赖
在 `pom.xml` 中添加 OpenAI 依赖(以 OpenAI 为例):
```xml
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-openai-spring-boot-starter</artifactId>
<version>0.8.1</version>
</dependency>
```
---
### 三、配置 API 密钥
1. **获取 OpenAI API Key**
访问 [OpenAI Platform](https://platform.openai.com/api-keys) 创建密钥
2. **配置 `application.properties`**
```properties
spring.ai.openai.api-key=你的API密钥
spring.ai.openai.chat.options.model=gpt-3.5-turbo
```
---
### 四、编写示例代码
创建 Controller 类:
```java
import org.springframework.ai.client.AiClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class ChatController {
private final AiClient aiClient;
public ChatController(AiClient aiClient) {
this.aiClient = aiClient;
}
@GetMapping("/ask")
public String ask(@RequestParam String question) {
return aiClient.generate(question);
}
}
```
---
### 五、运行与测试
1. **启动应用**
`mvn spring-boot:run`
2. **发送请求**
使用 curl 测试:
```bash
curl http://localhost:8080/ask?question=用中文介绍Spring+AI
```
---
### 六、输出示例
```json
Spring AI 是 Spring 生态系统中的一个新项目,旨在简化人工智能功能的集成...
```
---
### 七、其他选择(本地运行)
若不想使用 OpenAI,可改用本地模型(如 Ollama):
1. 添加依赖:
```xml
<dependency>
<groupId>org.springframework.ai</groupId>
<artifactId>spring-ai-ollama-spring-boot-starter</artifactId>
<version>0.8.1</version>
</dependency>
```
2. 配置 `application.properties`:
```properties
spring.ai.ollama.base-url=http://localhost:11434
spring.ai.ollama.chat.model=llama2
```
---
### 常见问题
1. **API 密钥问题**
确保密钥正确且有效
2. **依赖下载失败**
检查 Maven 中央仓库是否可用
3. **本地模型支持**
Ollama 需要提前安装并启动服务
通过这个 Demo 可以快速体验 Spring AI 的基础能力,后续可扩展实现更复杂的 AI 集成场景。
阅读全文
相关推荐
















