Spring AI Alibaba 使用指南及 ReactAgent 入门

环境准备

1. 环境要求：

• JDK 17+
• Maven 3.8+
• 选择你的 LLM 提供商并获取 API-KEY（如阿里云百炼的 DashScope）

2. Maven 依赖：

<dependencies>
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-agent-framework</artifactId>
    <version>1.1.0.0-RC2</version>
  </dependency>
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    <version>1.1.0.0-RC2</version>
  </dependency>
</dependencies>

核心概念

1. DashScopeApi 介绍

DashScopeApi 是阿里云推出的大模型统一调用接口平台，用于接入通义千问等 AI 能力。

常用配置项：

属性	说明
apiKey	密钥
baseUrl	API 地址

示例代码：

@Configuration
public class ReactAgentModelChatConfig {

    @Bean(name = "dashScopeApiTest")
    public DashScopeApi dashScopeApiTest() {
        return DashScopeApi.builder()
                .apiKey("YOUR_API_KEY")
                .build();
    }

    @Bean(name = "dashScopeChatModelTest")
    public ChatModel dashScopeChatModelTest(DashScopeApi dashScopeApi) {
        return DashScopeChatModel.builder()
                .dashScopeApi(dashScopeApi)
                .defaultOptions(DashScopeChatOptions.builder()
                        .maxToken(1024)
                        .temperature(0.7)
                        .build())
                .build();
    }
}