Spring实战spring-ai运行

目录

[1. 配置](#1. 配置)

[2 .搭建项目](#2 .搭建项目)

[3. 查看对应依赖](#3. 查看对应依赖)

[3.1 OpenAI 依赖](#3.1 OpenAI 依赖)

[3.2 配置 OpenAI API 密钥](#3.2 配置 OpenAI API 密钥)

application.properties

application.yml

[4. openai实战](#4. openai实战)

[5. 运行和测试](#5. 运行和测试)

[6. 高级配置](#6. 高级配置)

示例:配置模型和参数

解释:

[7. 处理异常和错误](#7. 处理异常和错误)

示例:全局异常处理

8.监控和日志

示例:添加日志

9.性能优化

示例:异步调用

总结


1. 配置

  • Project:Maven

  • Language:Java

  • SpringBoot:3.4.3

  • Dependencies:

    • Spring Web

    • Spring Boot DevTools(可选,用于开发热部署)

2 .搭建项目

idea里面选择File->New-Project

选择SpringBoot 项目,Language选择java,type选择Maven

Jdk选择对应的版本最低使用17,packaging类型根据自身部署习惯选择jar或者war都可以

选择完成后会跳转如下界面,选择AI,OpenAI勾选即可。

至此项目搭建完成

3. 查看对应依赖

3.1 OpenAI 依赖

java 复制代码
<dependency>
    <groupId>org.springframework.ai</groupId>
    <artifactId>spring-ai-openai-spring-boot-starter</artifactId>
    <version>1.0.0-M6</version>
</dependency>

3.2 配置 OpenAI API 密钥

application.propertiesapplication.yml 中配置 OpenAI 的 API 密钥。

application.properties

spring.ai.openai.api-key=your-openai-api-key

application.yml

spring:
ai:
openai:
api-key: your-openai-api-key

4. openai实战

创建一个服务类来封装与 OpenAI 的交互逻辑

java 复制代码
public class ChatAiController {

    private static final Logger log = LogManager.getLogger(ChatAiController.class);
    private final ChatClient chatClient;

    public ChatAiController(ChatClient.Builder build) {
       
       this.chatClient = build.defaultSystem("测试")
                .build();
    }

    @GetMapping("/chat")
    public String chatAI(@RequestParam(value = "message") String message){
        System.out.println(this.chatClient.prompt()
                .user(message)
                .call()
                .content());
        return this.chatClient.prompt()
                .user(message)
                .call()
                .content();
    }
}

5. 运行和测试

启动 Spring Boot 应用程序,并通过 API 端点测试 OpenAI 功能

请求示例:

GET /chat?message=Hello, how are you?

响应示例:

"I'm just a computer program, so I don't have feelings, but thanks for asking! How can I assist you today?"

6. 高级配置

Spring AI 提供了多种配置选项,可以根据需求调整 OpenAI 的行为。

示例:配置模型和参数
解释:
  • model:指定使用的模型,如 gpt-3.5-turbogpt-4

  • temperature:控制生成文本的随机性(0 到 1 之间,值越高越随机)。

  • max-tokens:限制生成文本的最大长度。

7. 处理异常和错误

在实际应用中,处理 API 调用中的异常和错误是非常重要的。你可以使用 Spring 的异常处理机制来捕获和处理这些异常

示例:全局异常处理
java 复制代码
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.http.ResponseEntity;
import org.springframework.http.HttpStatus;

@ControllerAdvice
public class GlobalExceptionHandler {

    @ExceptionHandler(Exception.class)
    public ResponseEntity<String> handleException(Exception ex) {
        return new ResponseEntity<>("An error occurred: " + ex.getMessage(), HttpStatus.INTERNAL_SERVER_ERROR);
    }
}

8.监控和日志

为了确保 API 调用的稳定性和可维护性,建议添加监控和日志记录。

示例:添加日志
java 复制代码
import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

@Service
public class OpenAiService {

    private static final Logger logger = LoggerFactory.getLogger(OpenAiService.class);

    private final ChatClient chatClient;

    @Autowired
    public OpenAiService(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    public String generateChatResponse(String message) {
        logger.info("Generating chat response for message: {}", message);
        return chatClient.call(message);
    }
}

9.性能优化

对于高并发的场景,可能需要考虑性能优化,如缓存、异步调用等。

示例:异步调用
java 复制代码
import org.springframework.scheduling.annotation.Async;
import org.springframework.stereotype.Service;
import java.util.concurrent.CompletableFuture;

@Service
public class OpenAiService {

    private final ChatClient chatClient;

    @Autowired
    public OpenAiService(ChatClient chatClient) {
        this.chatClient = chatClient;
    }

    @Async
    public CompletableFuture<String> generateChatResponseAsync(String message) {
        return CompletableFuture.completedFuture(chatClient.call(message));
    }
}

总结

通过以上步骤,你可以快速创建一个 Spring Boot 项目并集成 OpenAI 的功能。根据实际需求,你可以进一步扩展和优化这些功能,例如添加日志、异常处理、性能优化等

相关推荐
龙猫里的小梅啊1 分钟前
CSS(八)CSS显示模式display属性
前端·css·css3
逻辑驱动的ken2 分钟前
Java高频面试考点场景题22
java·开发语言·jvm·面试·职场和发展·求职招聘·春招
雨季mo浅忆5 分钟前
第二项目重新梳理
前端·面试
苍煜7 分钟前
SpringBoot Spring事务完整版详解:@Transactional注解实操 + 七大事务传播机制用法
spring boot·spring·oracle
小则又沐风a8 分钟前
list模拟实现
java·服务器·list
上弦月-编程11 分钟前
C语言链表详解,新手也能看懂! ——从入门到精通的完整教程
java·c语言·c++
李白的天不白13 分钟前
webpack 与 vue-loader 版本冲突问题
前端·vue.js·webpack
sunneo18 分钟前
专栏D-团队与组织-05-冲突与决策
前端·人工智能·产品运营·aigc·产品经理·ai-native
舟遥遥娓飘飘23 分钟前
量化投资体系之二:为 Web 看板集成公众号/财经原始数据
前端·数据分析·自动化·ai编程
ffqws_24 分钟前
Spring Boot 配置读取全解析:从 application.yml 到 Java 对象的完整链路
java·数据库·spring boot