Spring AI · 第11节 · spring-ai-alibaba 专项：接通义千问全家桶

九

spring-ai-alibaba 专项：接通义千问全家桶

Spring AI Alibaba Deep Dive

这是国内 Java 团队接大模型的主战场。spring-ai-alibaba 是阿里开源的"Agentic AI Framework for Java Developers"——它在 Spring AI 抽象之上，把百炼（DashScope）平台、通义千问、工具、RAG、Agent 编排全串了起来，核心设计是 DAG Graph（有向无环图），能轻松编排单 Agent、多 Agent 和复杂工作流。下面按"是什么 → 怎么接 → 有哪些模型 → 生态组件"讲。

论它到底补了 Spring AI 什么

① 模型接入：提供 DashScopeChatModel，把通义千问、qwen-vl、通义万相（文生图）接进 Spring AI 的 ChatClient。

② Agent 编排：Spring AI Alibaba Agent Framework + Graph，用 DAG 描述"节点 + 边"，做长时运行、有状态的 Agent。

③ 工程化：Prompt Template（存 Nacos）、事件驱动（RocketMQ）、AI Gateway、可观测（Dashboard / LLM 可观测 / DataCanvas 评测）。

④ 现成应用：官方有 JManus（Manus 的 Java 实现）、Copilot（AI 编程助手）、DataAgent（自然语言转 SQL）、DeepResearch。

快速开始：BOM + DashScope Starter

用 BOM 统一管版本，再引 DashScope starter。当前 BOM 线是 1.0.0.x（以官网最新为准）。

pom.xml：先引 BOM，再引 starter-dashscope

<parent>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-parent</artifactId>
    <version>3.3.x</version>   <!-- JDK 17+ -->
</parent>

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.alibaba.cloud.ai</groupId>
      <artifactId>spring-ai-alibaba-bom</artifactId>
      <version>1.0.0.2</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>
    <!-- 版本交给 BOM，这里不用写 -->
  </dependency>
  <dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
  </dependency>
</dependencies>

application.yml：配百炼 API Key + 模型

spring:
  ai:
    alibaba:
      api-key: ${DASHSCOPE_API_KEY}   # 百炼控制台创建，只显示一次
      chat:
        options:
          model: qwen-plus
          temperature: 0.7

百炼 API Key 申请：阿里云 → 百炼 Model Studio → API-KEY 管理 → 创建

# 设成环境变量，别写进代码提交 Git
export DASHSCOPE_API_KEY="sk-xxxxxxxx"

# 写个 Controller，注入 ChatClient 就能聊
# GET /ai/chat?q=你好 → 通义千问的回答

DashScope 支持的模型一览

模型	用途
qwen-max	最强推理，复杂写作 / 深度分析，最贵。
qwen-plus	均衡主力，日常对话 / 客服。
qwen-turbo	最快最便宜，分类 / 抽取 / 高频调用。
qwen-vl（max/plus）	多模态，看图、发票识别、图片问答。
通义万相（wanx）	文生图，另一套 ImageModel 接口。
qwen-embedding	向量化模型，RAG 入库 / 检索用。

生态组件全家福

组件	干什么
Agent Framework	构建单 / 多 Agent，内置上下文工程（Context Engineering）。
Spring AI Alibaba Graph	低级编排框架与运行时，用 DAG 管理长时运行的有状态 Agent。
Studio	可视化聊天窗口，能看到 Agent 推理和工具执行的细节。
Admin	本地可视化工具包：项目管理、运行时可视化、追踪、Agent 评估。
OT Agent / AI Gateway	边缘接入、WAF、Prompt 安全、API 管理、缓存。

starter 名字换过，别抄老教程

早期文档里有 spring-ai-alibaba-starter，新版本 DashScope 拆分后是 spring-ai-alibaba-starter-dashscope。引错artifactId 会自动装配不到 ChatModel。以 java2ai.com 当前版本（如 /docs/1.0.0.2/）的快速开始页面为准。

← 返回总览 Spring AI总览下一节：Agent 编排与 AgentScope →