alibaba/spring-ai-alibaba View GitHub Homepage for Latest Official Releases

企業級代理式AI框架，專為Java開發者設計，基於Spring AI並深度整合阿里巴巴雲，用於構建智能代理、工作流程和多代理應用程式

Apache-2.0Javaspring-ai-alibabaalibaba 7.5k Last Updated: December 15, 2025

Spring AI Alibaba - 適用於 Java 開發者的代理式 AI 框架

概述

Spring AI Alibaba 是一個企業級 AI 應用開發框架，專為 Java 開發者設計。它基於 Spring AI 並與阿里巴巴雲百煉平台深度整合，為在生產環境中構建智慧代理、工作流程和多代理應用程式提供了全面的解決方案。

官方儲存庫： https://github.com/alibaba/spring-ai-alibaba
官方網站： https://java2ai.com
許可證： 開源
要求： JDK 17+

核心架構

該框架由三個基本組件構成：

1. 代理框架

一個基於 ReactAgent 的開發框架，以 ReAct（推理 + 行動）範式為核心。它使開發者能夠構建具有自動上下文工程和人機協作能力的智慧代理。對於複雜場景，它提供了內建的工作流程模式，包括：

  • SequentialAgent：依序執行代理
  • ParallelAgent：並行運行多個代理
  • RoutingAgent：根據條件路由請求
  • LoopAgent：實現迭代工作流程

2. 圖形運行時

一個受 LangGraph 啟發的低階工作流程和多代理編排框架。它具有以下特點：

  • 豐富的預建工作流程節點集
  • 簡化的圖形狀態定義
  • 原生串流支援
  • 人機協作整合
  • 記憶體和持久化儲存
  • 圖形狀態快照
  • 巢狀和並行圖形執行
  • PlantUML 和 Mermaid 格式匯出

3. Spring Boot Starters

將代理框架與 Nacos 等企業服務連接的整合啟動器，提供：

  • 代理到代理 (A2A) 通訊
  • 動態配置管理
  • 分佈式 MCP 發現和路由

主要功能

智慧代理開發

  • ReactAgent 模式：遵循 ReAct 範式構建具有推理和行動能力的代理
  • 多代理編排：組合多個代理以執行複雜任務
  • 上下文工程：內建提示工程和上下文管理的最佳實踐
  • 人機協作：無縫整合人工回饋和審批步驟
  • 串流支援：以令牌級粒度即時串流代理回應
  • 錯誤處理：強大的錯誤恢復和重試機制

模型與工具整合

  • 多個 LLM 提供商：支援通義千問 (Qwen)、DeepSeek、OpenAI 及其他提供商
  • 工具調用：透過 FunctionToolCallback 提供全面的函數調用能力
  • 模型上下文協議 (MCP)：全面支援 MCP 以實現標準化模型互動
  • 結構化輸出：定義輸出模式和類型以控制格式
  • 多模態支援：處理文本、圖像及其他模態

企業級功能

  • Nacos MCP 註冊中心：分佈式 MCP 服務器發現和負載平衡
  • Higress AI 網關：LLM 模型代理和路由
  • ARMS 可觀測性：與阿里巴巴雲應用實時監控服務整合
  • Langfuse 整合：全面的追蹤和評估
  • 向量儲存：支援多種向量資料庫（Hologres、AnalyticDB、OpenSearch）
  • RAG 支援：完整的檢索增強生成管道
  • 聊天記憶體：多輪對話的會話記憶體管理
  • NL2SQL：自然語言到 SQL 轉換

額外能力

  • 文件解析：支援多種格式（PDF、Word、Excel 等）
  • 圖像生成：基於通義千問的圖像模型整合
  • 音訊處理：音訊轉錄和合成
  • 提示管理：與 Nacos 整合的動態提示模板
  • 工作流程可視化：將工作流程匯出為 PlantUML 和 Mermaid 格式

入門指南

快速入門範例

將依賴項添加到您的 Spring Boot 專案：

<dependencyManagement>
  <dependencies>
    <dependency>
      <groupId>com.alibaba.cloud.ai</groupId>
      <artifactId>spring-ai-alibaba-bom</artifactId>
      <version>1.1.0.0-M5</version>
      <type>pom</type>
      <scope>import</scope>
    </dependency>
  </dependencies>
</dependencyManagement>

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

簡單的 ReactAgent 範例

// 初始化聊天模型
DashScopeApi dashScopeApi = DashScopeApi.builder()
    .apiKey(System.getenv("AI_DASHSCOPE_API_KEY"))
    .build();

DashScopeChatModel chatModel = DashScopeChatModel.builder()
    .dashScopeApi(dashScopeApi)
    .build();

// 創建 ReactAgent
ReactAgent writerAgent = ReactAgent.builder()
    .name("writer_agent")
    .model(chatModel)
    .description("A professional writer agent")
    .instruction("You are a renowned writer skilled in creative writing.")
    .outputKey("article")
    .build();

// 調用代理
AssistantMessage message = writerAgent.call("Write a 100-word essay about AI");

多代理工作流程範例

// 創建審閱代理
ReactAgent reviewerAgent = ReactAgent.builder()
    .name("reviewer_agent")
    .model(chatModel)
    .description("Reviews and edits articles")
    .instruction("You are an expert editor who reviews and improves content.")
    .outputKey("reviewed_article")
    .build();

// 依序組合代理
SequentialAgent blogAgent = SequentialAgent.builder()
    .name("blog_agent")
    .description("Writes and reviews articles")
    .subAgents(List.of(writerAgent, reviewerAgent))
    .build();

// 執行工作流程
Optional<OverAllState> result = blogAgent.invoke("Write a blog post about Spring AI");

官方產品與範例

JManus

一個使用 Spring AI Alibaba 構建的 Manus（通用 AI 代理）的 Java 實現。它支援：

  • 自主規劃和執行
  • 針對特定業務場景的微調代理
  • 客製化工具和子代理
  • 計劃調整和重用能力
  • 目前已在阿里巴巴集團內部的許多應用程式中使用

DeepResearch

一個智慧研究代理，具有以下特點：

  • 完整的前端網頁 UI 和後端實現
  • 網頁搜尋和爬取能力
  • Python 腳本引擎整合
  • MCP 服務支援
  • 使用 LLM 和工具生成全面的研究報告

DataAgent

一個自然語言到 SQL 專案，能夠：

  • 使用自然語言直接查詢資料庫
  • 無需編寫複雜的 SQL 語句
  • 與企業資料庫無縫整合

Playground

一個全面的範例應用程式，具有：

  • 完整的前端 UI 和後端實現
  • 展示所有核心框架功能
  • 功能：聊天機器人、多輪對話、圖像生成、多模態、工具調用、MCP、RAG
  • 可用於本地部署和客製化

Spring AI Alibaba Admin

本地可視化工具包，提供：

  • 專案管理
  • 運行時可視化
  • 追蹤和調試
  • 代理評估工具

生態系統整合

阿里巴巴雲服務

  • 百煉平台：LLM 模型服務（通義千問系列、DeepSeek）
  • 通義千問：全面的 AI 模型服務平台
  • 向量儲存：Hologres、AnalyticDB、OpenSearch
  • ARMS：應用監控和可觀測性
  • Nacos：配置和服務發現

第三方整合

  • Langfuse：追蹤和評估
  • OpenAI：與 OpenAI API 相容
  • Higress：用於模型路由的 AI 網關
  • Spring AI：基於 Spring AI 核心概念構建

版本資訊

當前穩定版本： 1.0.0.2 (GA)
最新版本： 1.1.0.0-M5 (里程碑)

1.1.x 版本功能

  • 增強的代理開發模式（代理式、多代理、工作流程）
  • 改進的圖形運行時
  • 增強的 A2A 通訊
  • 更好的 MCP 整合
  • 升級的文檔和官方網站

1.0.x 版本功能

  • 首個 GA 版本發布
  • 生產就緒框架
  • 完整的聊天機器人、工作流程和多代理支援
  • 深度阿里巴巴雲整合
  • 基於圖形的多代理框架

可用啟動器

  • spring-ai-alibaba-starter-dashscope - 通義千問模型整合
  • spring-ai-alibaba-agent-framework - 代理框架核心
  • spring-ai-alibaba-graph-core - 圖形運行時
  • spring-ai-alibaba-starter-nl2sql - 自然語言到 SQL
  • spring-ai-alibaba-starter-memory - 聊天記憶體管理
  • spring-ai-alibaba-starter-nacos-mcp-client - Nacos MCP 客戶端
  • spring-ai-alibaba-starter-nacos-mcp-server - Nacos MCP 服務器
  • spring-ai-alibaba-starter-nacos-prompt - 提示管理
  • spring-ai-alibaba-starter-arms-observation - ARMS 可觀測性
  • spring-ai-alibaba-starter-rag - RAG 能力

社區與支援

溝通管道

  • 釘釘群：搜尋 130240015687 並加入
  • 微信：關注官方微信公眾號
  • GitHub Discussions：社區討論和問答
  • 官方文檔：https://java2ai.com

相關儲存庫

使用案例

企業應用

  • 客戶服務聊天機器人
  • 內部業務自動化
  • 文件處理和分析
  • 知識庫問答系統
  • 代碼生成和審閱

垂直領域代理

  • 領域專用智慧助手
  • 自動化研究和報告
  • 資料分析和可視化
  • 流程自動化和編排
  • 多步驟工作流程執行

開發工具

  • AI 驅動的程式設計助手
  • 代碼審閱和優化
  • 文檔生成
  • 測試和調試支援

技術優勢

  1. Java 原生：對 Java 生態系統和 Spring Boot 的一流支援
  2. 企業級：在阿里巴巴集團內部經過生產驗證
  3. 雲原生：與阿里巴巴雲基礎設施深度整合
  4. 靈活架構：支援多種開發模式（低代碼、高代碼、零代碼）
  5. 全面工具：豐富的工具和組件集用於代理開發
  6. 活躍社區：強大的社區支援和定期更新
  7. 最佳實踐：內建來自真實企業部署的模式

與其他框架的比較

與基於 Python 的框架（LangChain、LangGraph）不同，Spring AI Alibaba 提供：

  • 原生 Java 支援與 Spring Boot 生態系統整合
  • 企業級功能（可觀測性、網關、配置管理）
  • 透過雲原生基礎設施實現生產就緒部署
  • 與阿里巴巴雲服務無縫整合
  • 強類型和編譯時安全
  • 在 JVM 環境中卓越的性能

未來路線圖

  • 持續的框架優化和性能改進
  • 增強的代理開發模式和工具
  • 擴展的模型提供商支援
  • 更全面的文檔和教程
  • 額外的企業整合能力
  • 社區驅動的功能和改進

結論

Spring AI Alibaba 代表了基於 Java 的 AI 應用開發的重大進步，將企業級代理框架引入 Java 生態系統。憑藉其全面的功能、深度雲整合和經過生產驗證的架構，它使 Java 開發者能夠以他們對 Spring 生態系統所期望的相同生產力和可靠性來構建複雜的 AI 應用程式。

無論您是構建簡單的聊天機器人、複雜的多代理系統還是企業工作流程自動化，Spring AI Alibaba 都提供了將您的 AI 應用程式從演示帶入生產所需的工具、模式和基礎設施。

Star History Chart