学习 Spring AI Alibaba项目（一）：SpringBoot集成SpringAI Alibaba的demo

原创已于 2025-04-07 23:13:33 修改 · 3.7k 阅读

17 ·

CC 4.0 BY-SA版权

文章标签：

#学习 #spring #人工智能 #java #后端

于 2025-03-14 17:33:48 首次发布

干就完事儿了专栏收录该内容

9 篇文章

订阅专栏

概述

为了自学Spring AI，一步步的准备记录Spring AI Alibaba的搭建和使用

这次先把流程跑起来，后续再主键增加内容，当然我也是边摸索变输出，有不对的地方也请大家给与指正。

依赖

开发工具IntelliJ IDEA

JDK17+, 可以使用idea自带

阿里云百炼：https://bailian.console.aliyun.com/

流程：

我们先使用idea自动创建spring项目
在这里插入图片描述

然后选择web项目，lambok等常用的依赖，因为这篇文章是为了记录如何先跑起来，所以先选择最简单的内容，这里要注意一点，java的版本最好是17之后，springboot的版本也要选择3.4以上（其他版本没试过，所以先这么选）
在这里插入图片描述

调整POM文件

我们创建好工程之后，调整一下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 https://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.4.3</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <groupId>com.niubi</groupId>
    <artifactId>helloai</artifactId>
    <version>ALPHA-1.0.0</version>

    <name>helloai</name>
    <description>Hello AI , first Spring AI alibaba project</description>

    <properties>
        <java.version>23</java.version>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
    </properties>

    <dependencies>
        <dependency>
            <groupId>com.alibaba.cloud.ai</groupId>
            <artifactId>spring-ai-alibaba-starter</artifactId>
            <version>1.0.0-M5.1</version>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-core</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework</groupId>
            <artifactId>spring-beans</artifactId>
        </dependency>
        <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>

    <repositories>
        <repository>
            <id>spring-milestones</id>
            <name>Spring Milestones</name>
            <url>https://repo.spring.io/milestone</url>
            <snapshots>
                <enabled>false</enabled>
            </snapshots>
        </repository>
    </repositories>

    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <configuration>
                    <annotationProcessorPaths>
                        <path>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </path>
                    </annotationProcessorPaths>
                </configuration>
            </plugin>
            <plugin>
                <groupId>org.springframework.boot</groupId>
                <artifactId>spring-boot-maven-plugin</artifactId>
                <configuration>
                    <excludes>
                        <exclude>
                            <groupId>org.projectlombok</groupId>
                            <artifactId>lombok</artifactId>
                        </exclude>
                    </excludes>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

新建ChatController.java

package com.niubi.helloai.chat.controller;


import com.alibaba.cloud.ai.dashscope.chat.DashScopeChatOptions;
import lombok.extern.slf4j.Slf4j;
import org.springframework.ai.chat.client.ChatClient;
import org.springframework.ai.chat.client.advisor.MessageChatMemoryAdvisor;
import org.springframework.ai.chat.client.advisor.SimpleLoggerAdvisor;
import org.springframework.ai.chat.memory.InMemoryChatMemory;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequestMapping("/ai/v1")
public class ChatController {
    private final ChatClient chatClient;


    public ChatController(ChatClient.Builder chatClientBuilder) {
        this.chatClient = chatClientBuilder
                // 实现 Chat Memory 的 Advisor
                // 在使用 Chat Memory 时，需要指定对话 ID，以便 Spring AI 处理上下文。
                .defaultAdvisors(
                        new MessageChatMemoryAdvisor(new InMemoryChatMemory())
                )
                // 实现 Logger 的 Advisor
                .defaultAdvisors(
                        new SimpleLoggerAdvisor()
                )
                // 设置 ChatClient 中 ChatModel 的 Options 参数
                .defaultOptions(
                        DashScopeChatOptions.builder()
                                .withTopP(0.7)
                                .build()
                )
                .build();
    }

    @GetMapping("/simple/chat")
    public String simpleChat(String query) {
        log.info("query: {}",query );
        String text =  chatClient.prompt(query).call().content();
        log.info("text: {}",text );
        return text;
    }

    @GetMapping("/hello")
    public String hello(){
        return "Hello, I am Spring AI";
    }

}

可以看到暴露了2个接口，一会就试一试

/ai/v1/simple/chat
/ai/v1/test

调整YML文件

我们调整一下application.yml文件，如果没有则创建：src/main/resources/application.yml

server:
  port: 8080
spring:
  application:
    name: Hello-AI
  ai:
    dashscope:
#      注意这个理是使用阿里云百炼平台的API-KEY
      api-key: sk-***************************19
      model: qwen-turbo

申请百炼的API-key

如果不知道怎么申请百炼平台的KEY，请看官方链接：https://help.aliyun.com/zh/model-studio/getting-started/first-api-call-to-qwen?spm=a2c4g.11186623.help-menu-2400256.d_0_1_0.72e9b0a8jRnuq0
在这里插入图片描述