【Spring AI 学习（二）】快速入门

环境搭建和demo展示

接下来，我将直接展示如何快速搭建环境并运行一个demo。首先准备好IDEA开发工具、jdk17版本和Maven3.9

首先在IDEA中创建一个Maven工程，注意选择JDK17版本，构建工具选择Maven。先创建一个spring_ai工程，然后再在这个工程下创建一个spring_ai_demo模块。整体代码结构层次如下图。

（一）增加Maven依赖

spring_ai工程下有一个POM文件，其主要内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<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>

    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.3.8</version>
        <relativePath/>
    </parent>

    <groupId>com.company</groupId>
    <artifactId>spring_ai</artifactId>
    <version>1.0-SNAPSHOT</version>
    <packaging>pom</packaging>
    <modules>
        <module>spring_ai_demo</module>
    </modules>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

</project>

spring_ai_demo模块下，也有一个POM文件，其主要内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<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>
    <parent>
        <groupId>com.company</groupId>
        <artifactId>spring_ai</artifactId>
        <version>1.0-SNAPSHOT</version>
    </parent>

    <artifactId>spring_ai_demo</artifactId>

    <properties>
        <maven.compiler.source>17</maven.compiler.source>
        <maven.compiler.target>17</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <spring-ai.version>1.0.0-M5</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-openai-spring-boot-starter</artifactId>
        </dependency>

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>
    </dependencies>

    <dependencyManagement>
        <dependencies>
            <dependency>
                <groupId>org.springframework.ai</groupId>
                <artifactId>spring-ai-bom</artifactId>
                <version>${spring-ai.version}</version>
                <type>pom</type>
                <scope>import</scope>
            </dependency>
        </dependencies>
    </dependencyManagement>

</project>

（二）增加application.properties项目配置文件

spring_ai_demo模块下还有一个配置文件application.properties。其内容如下：

server.port=8080
spring.application.name=spring-ai-demo

spring.ai.openai.api-key=sk-e5be6cdaaaaaaaaa02d7cb557f4aaaaaaaaaaaaaa
spring.ai.openai.base-url=https://api.deepseek.com
spring.ai.openai.chat.options.model=deepseek-chat
spring.ai.openai.chat.options.temperature=0.7

需要说明的是，这里的配置项spring.ai.openai.api-key的值，因为我这里调用的是deepseek模型，所以这里的apiKey需要到deepseek官网进行申请即可。

点击这个链接即可访问deepseek官网的api创建页面 https://platform.deepseek.com/api_keys

如下图：

如果需要调用，还需要充值，正常来说，充个1块钱就能足够调试用了。

（三）创建controller，代码如下

package com.company.controller;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.ai.openai.OpenAiChatModel;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class DemoController {

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

    @Autowired
    private OpenAiChatModel openAiChatModel;

    @GetMapping("/ai/generate")
    public String generate(String message) {
        String call = openAiChatModel.call(message);
        logger.info("call信息：{}", call);
        return call;
    }
}

（四）创建启动类

package com.company;


import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

//TIP To <b>Run</b> code, press <shortcut actionId="Run"/> or
// click the <icon src="AllIcons.Actions.Execute"/> icon in the gutter.
@SpringBootApplication
public class DemoApplication {
    public static void main(String[] args) {
        //TIP Press <shortcut actionId="ShowIntentionActions"/> with your caret at the highlighted text
        // to see how IntelliJ IDEA suggests fixing it.
        SpringApplication.run(DemoApplication.class, args);
    }
}

（五）启动项目，并访问接口   localhost:8080/ai/generate?message=你是谁

控制台打印信息如下：