初识Spring AI Alibaba

在Spring AI Alibaba主页，点击“快速开始”。

来到Spring AI Alibaba的文档页面。

A:\study\javaee\Spring AI>git clone --depth=1 https://github.com/springaialibaba/spring-ai-alibaba-examples.git
Cloning into 'spring-ai-alibaba-examples'...
remote: Enumerating objects: 1060, done.
remote: Counting objects: 100% (1060/1060), done.
remote: Compressing objects: 100% (580/580), done.
remote: Total 1060 (delta 178), reused 912 (delta 100), pack-reused 0 (from 0)
Receiving objects: 100% (1060/1060), 31.70 MiB | 6.66 MiB/s, done.
Resolving deltas: 100% (178/178), done.

使用git clone --depth=1 https://github.com/springaialibaba/spring-ai-alibaba-examples.git命令拉取示例程序到本地。

使用IDEA打开项目。

我们尝试运行其中的agent-example项目，查看它的README.md文档。该文档翻译为中文如下所示。

AI 驱动的专家系统演示

这个应用展示了如何使用 Spring AI Alibaba 构建一个 AI 驱动的系统，它可以：

• 访问条款和条件（检索增强生成，RAG）
• 访问工具（Java 方法）来执行操作（函数调用）
• 使用 LLM 与用户交互

  

  要求

  • Java 17+
  • Dashscope API 密钥，设置在 AI_DASHSCOPE_API_KEY 环境变量中

    运行

    通过在 IDE 中运行 Application.java 或在命令行中运行 mvn spring-boot:run 来运行此应用。

    将 Spring AI Alibaba boot starter 添加到 POM 文件中：

       org.springframework.ai
       spring-ai-alibaba-starter
       1.0.0-M6.1
    
    

    将 DashScope 配置添加到 application.properties 文件中：

    spring.ai.dashscope.api-key=${AI_DASHSCOPE_API_KEY}
    spring.ai.dashscope.chat.options.model=qwen-max
    

    构建 Jar 包

    ./mvnw clean package
    

    java -jar ./target/playground-flight-booking-example-0.0.1-SNAPSHOT.jar
    

    构建前端 (按需)

    运行以下命令来构建前端，仅当您修改了前端代码时才需要这样做。

    mvn clean compile -Pbuild-frontend
    

    ---

    按照说明文档，我使用了JDK21运行。接下来需要在环境变量中配置API密钥。

    

    按照文档说明，我们前往阿里云百炼平台创建API-KEY。

    

    按照说明，登录阿里云百炼大模型服务平台。

    

    开通百炼的模型服务。

    

    前往API-KEY页面，单击创建我的API-KEY。在已创建的API Key操作列，单击查看，获取API KEY。接下来将其配置到环境变量。

    A:\study\javaee\Spring AI\spring-ai-alibaba-examples>setx AI_DASHSCOPE_API_KEY "sk-0d75f71279834fad88807898587dc060"
    成功: 指定的值已得到保存。
    A:\study\javaee\Spring AI\spring-ai-alibaba-examples>
    

    在命令行通过setx AI_DASHSCOPE_API_KEY "YOUR_AI_DASHSCOPE_API_KEY"命令设置永久环境变量，用于存储模型的API密钥。

    A:\study\javaee\Spring AI\spring-ai-alibaba-examples>echo %AI_DASHSCOPE_API_KEY%
    sk-0d75f71279834fad88807898587dc060
    A:\study\javaee\Spring AI\spring-ai-alibaba-examples>
    

    在新的CMD窗口运行echo %AI_DASHSCOPE_API_KEY%命令，检查环境变量是否生效。

    

    或通过高级系统设置 AI_DASHSCOPE_API_KEY 环境变量。

    

    

    该示例项目中，spring-ai-alibaba-starter依赖已在pom文件中配置，DashScope 配置也已添加到 application.properties 文件中。因此接下来启动Application.java即可。启动之前，需要重启IDEA，使其能够加载最新的环境变量。

    

    启动Application.java，如图所示。

    

    打开http://localhost:9000/，在左侧对话界面尝试发送消息，成功和AI客服进行了对话。