Spring AI Alibaba 项目接入阿里云百炼平台大模型

原创已于 2025-08-07 21:45:34 修改 · 417 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#spring #人工智能 #spring ai #大模型 #ai alibaba

于 2025-08-07 11:12:21 首次发布

Spring AI Alibaba 专栏收录该内容

3 篇文章

订阅专栏

1 依赖

jdk 21 + springboot 3.4.5 + spring-ai-alibaba-starter-dashscope 1.0.0.2

<properties>
	<java.version>21</java.version>
	<spring-ai.version>1.0.0</spring-ai.version>
	<spring-ai-alibaba.version>1.0.0.2</spring-ai-alibaba.version>
	<spring-boot.version>3.4.5</spring-boot.version>
</properties>


<dependencyManagement>
	<dependencies>
		<dependency>
			<groupId>com.alibaba.cloud.ai</groupId>
			<artifactId>spring-ai-alibaba-bom</artifactId>
			<version>${spring-ai-alibaba.version}</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
		<dependency>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-dependencies</artifactId>
			<version>${spring-boot.version}</version>
			<type>pom</type>
			<scope>import</scope>
		</dependency>
		<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>

<dependencies>
	<dependency>
		<groupId>com.alibaba.cloud.ai</groupId>
		<artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
	</dependency>

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

<build>
	<plugins>
		<!-- Maven 编译器插件 -->
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-compiler-plugin</artifactId>
			<version>3.11.0</version>
			<configuration>
				<source>21</source>
				<target>21</target>
				<parameters>true</parameters> <!-- 支持参数名保留 -->
				<compilerArgs>
					<arg>-Xlint:unchecked</arg>
					<arg>-Xlint:deprecation</arg>
				</compilerArgs>
			</configuration>
		</plugin>

		<!-- Spring Boot Maven 插件 -->
		<plugin>
			<groupId>org.springframework.boot</groupId>
			<artifactId>spring-boot-maven-plugin</artifactId>
			<version>${spring-boot.version}</version>
		</plugin>

		<!-- 资源处理插件 -->
		<plugin>
			<groupId>org.apache.maven.plugins</groupId>
			<artifactId>maven-resources-plugin</artifactId>
			<version>3.3.1</version>
			<configuration>
				<encoding>UTF-8</encoding>
			</configuration>
		</plugin>
	</plugins>
</build>

2 配置文件

接入阿里云百炼平台大模型的配置如下所示。

# 阿里云百炼平台模型秘钥
spring.ai.dashscope.api-key=${ALI_AI_DASHSCOPE_API_KEY}
# 模型名称（如 qwen-plus）
spring.ai.dashscope.chat.options.model=${ALI_AI_DASHSCOPE_CHAT_MODEL}
# 使用SDK调用时需配置的base_url
spring.ai.dashscope.base-url=https://dashscope.aliyuncs.com/compatible-mode/v1

3 demo

spring ai alibaba框架会自动读取配置文件构建阿里云百炼平台模型的 ChatClient，只需注入使用即可。以下为使用 ChatClient进行简单调用的案例。

@Slf4j
@RestController
@RequestMapping("/test")
public class DashScopeChatClientController {

    private static final String DEFAULT_PROMPT = "你好，介绍下你自己！";

    /**
     * 阿里云百炼平台模型的 ChatClient
     */
    private final ChatClient dashScopeChatClient;

    // 使用如下的方式注入阿里云百炼平台模型的 ChatClient
    public DashScopeChatClientController(ChatClient.Builder chatClientBuilder) {
        this.dashScopeChatClient = chatClientBuilder.build();
    }

    /**
     * ChatClient 简单调用
     */
    @GetMapping("/simple/chat")
    public String simpleChat(String prompt) {
        if (StringUtils.isBlank(prompt)) {
            prompt = DEFAULT_PROMPT;
        }
        String content;
        try {
            content = dashScopeChatClient.prompt(prompt).call().content();
        } catch (Exception e) {
            log.error("simpleChat error", e);
            throw new RuntimeException(e.getMessage());
        }
        log.info("simpleChat --> \n prompt ={}, \n content = {}", prompt, content);
        return content;
    }

}