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();
    }
}

2. ReactAgent

简介：ReactAgent 是 Spring AI Alibaba 中提供的一个核心 Agent 实现类，实现了经典的 ReAct 模式（Reasoning + Acting）。

• Reason（推理）：分析当前情况，规划下一步
• Act（行动）：调用工具获取外部信息

常用构建方法（Builder 模式）：

方法 / 属性	作用
.name	Agent 的名字
.model(ChatModel)	注入大模型
.tools	添加工具
.hooks	添加钩子
.systemPrompt(String)	系统提示词
.maxIterations(int)	最大迭代轮次
.savers(ChatMemory)	对话记忆
.outputSchema	输出类型安全
.outputType	类型安全推荐

具体实现可参考官方文档或示例项目。