Spring AI入门初级案例

要开发一个Spring AI的入门案例，我们可以从一个简单的Spring Boot项目开始，然后集成Spring AI的功能来实现基本的生成式AI任务。下面是一个步骤指南，帮助你快速启动并运行一个简单的Spring AI应用。

步骤 1: 准备环境

首先，确保你有以下软件安装：

• Java 开发环境 (JDK 11 或更高版本)
• Maven
• 一个 Java IDE（例如 IntelliJ IDEA 或 Eclipse）

步骤 2: 创建Spring Boot项目

1. 使用你喜欢的IDE或者通过命令行创建一个新的Spring Boot项目。
2. 添加必要的依赖项，通常需要Spring Web和Spring AI相关的依赖。

示例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.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <modelVersion>4.0.0</modelVersion>

    <groupId>com.example</groupId>
   <artifactId>spring-ai-demo</artifactId>
    <version>0.0.1-SNAPSHOT</version>
    <packaging>jar</packaging>

    <name>spring-ai-demo</name>
    <description>Demo project for Spring AI</description>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.1.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

   <properties>
        <java.version>17</java.version>
      <spring-ai.version>0.8.1</spring-ai.version>
    </properties>

    <dependencies>
       <dependency>
            <groupId>org.springframework.boot</groupId>
           <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
       <dependency>
            <groupId>org.springframework.ai</groupId>
            <artifactId>spring-ai-core</artifactId>
           <version>${spring-ai.version}</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.ai</groupId>
           <artifactId>spring-ai-openai</artifactId>
           <version>${spring-ai.version}</version>
        </dependency>
    </dependencies>

    <build>
        <plugins>
          <plugin>
              <groupId>org.springframework.boot</groupId>
               <artifactId>spring-boot-maven-plugin</artifactId>
           </plugin>
       </plugins>
   </build>

</project>

步骤 3: 创建Spring Boot应用类

创建一个Spring Boot应用类，并添加@SpringBootApplication注解。

示例Application.java

package com.example.springai;

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: 配置OpenAI API Key

你需要一个OpenAI API key来使用Spring AI提供的OpenAI模型。你可以在Spring Boot的application.properties文件中添加配置。

示例application.properties

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

步骤 5: 创建一个简单的REST Controller

创建一个简单的REST控制器，用来处理HTTP请求，并使用Spring AI提供的API来生成文本响应。

示例Controller.java

package com.example.springai.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.ai.core.AIService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class AiController {

    private final AIService aiService;

    @Autowired
    public AiController(AIService aiService) {
       this.aiService = aiService;
   }

    @GetMapping("/generate")
    public String generateText(@RequestParam("prompt") String prompt) {
       return aiService.generate(prompt);
   }

}

步骤 6: 运行应用

运行Spring Boot应用，并测试你的REST端点。

1. 运行Spring Boot应用。
2. 使用浏览器或者curl工具访问 http://localhost:8080/generate?prompt=Hello%20Spring%20AI!。