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

자바 개발자를 위한 엔터프라이즈급 에이전트 AI 프레임워크로, Spring AI를 기반으로 구축되었으며 지능형 에이전트, 워크플로 및 다중 에이전트 애플리케이션 구축을 위해 Alibaba Cloud와 깊이 통합되어 있습니다.

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

Spring AI Alibaba - Java 개발자를 위한 에이전트 기반 AI 프레임워크

개요

Spring AI Alibaba는 Java 개발자를 위해 특별히 설계된 엔터프라이즈급 AI 애플리케이션 개발 프레임워크입니다. Spring AI를 기반으로 구축되었으며 Alibaba Cloud의 Bailian 플랫폼과 깊이 통합되어 프로덕션 환경에서 지능형 에이전트, 워크플로우 및 다중 에이전트 애플리케이션을 구축하기 위한 포괄적인 솔루션을 제공합니다.

공식 저장소: https://github.com/alibaba/spring-ai-alibaba
공식 웹사이트: https://java2ai.com
라이선스: 오픈 소스
요구 사항: JDK 17+

핵심 아키텍처

이 프레임워크는 세 가지 기본 구성 요소로 이루어져 있습니다.

1. 에이전트 프레임워크

ReAct (Reasoning + Acting) 패러다임을 중심으로 하는 ReactAgent 기반 개발 프레임워크입니다. 개발자가 자동 컨텍스트 엔지니어링 및 Human-in-the-loop 기능을 갖춘 지능형 에이전트를 구축할 수 있도록 합니다. 복잡한 시나리오를 위해 다음과 같은 내장 워크플로우 패턴을 제공합니다.

SequentialAgent: 에이전트를 순차적으로 실행
ParallelAgent: 여러 에이전트를 동시에 실행
RoutingAgent: 조건에 따라 요청 라우팅
LoopAgent: 반복 워크플로우 구현

2. 그래프 런타임

LangGraph에서 영감을 받은 저수준 워크플로우 및 다중 에이전트 오케스트레이션 프레임워크입니다. 다음 기능을 제공합니다.

풍부한 사전 구축 워크플로우 노드 세트
간소화된 그래프 상태 정의
네이티브 스트리밍 지원
Human-in-the-loop 통합
메모리 및 영구 저장소
그래프 상태 스냅샷
중첩 및 병렬 그래프 실행
PlantUML 및 Mermaid 형식 내보내기

3. Spring Boot 스타터

Nacos와 같은 엔터프라이즈 서비스와 에이전트 프레임워크를 연결하는 통합 스타터로, 다음을 제공합니다.

에이전트 간(A2A) 통신
동적 구성 관리
분산 MCP 검색 및 라우팅

주요 기능

지능형 에이전트 개발

ReactAgent 패턴: ReAct 패러다라임을 따라 추론 및 행동 기능을 갖춘 에이전트 구축
다중 에이전트 오케스트레이션: 복잡한 작업 실행을 위해 여러 에이전트 구성
컨텍스트 엔지니어링: 프롬프트 엔지니어링 및 컨텍스트 관리를 위한 내장된 모범 사례
Human In The Loop: 인간의 피드백 및 승인 단계를 원활하게 통합
스트리밍 지원: 토큰 수준의 세분화된 에이전트 응답 실시간 스트리밍
오류 처리: 강력한 오류 복구 및 재시도 메커니즘

모델 및 도구 통합

다중 LLM 제공업체: DashScope (Qwen, DeepSeek), OpenAI 및 기타 제공업체 지원
도구 호출: FunctionToolCallback을 통한 포괄적인 함수 호출 기능
모델 컨텍스트 프로토콜 (MCP): 표준화된 모델 상호 작용을 위한 전체 MCP 지원
구조화된 출력: 형식 제어를 위한 출력 스키마 및 유형 정의
멀티모달 지원: 텍스트, 이미지 및 기타 모달리티 처리

엔터프라이즈 준비 기능

Nacos MCP 레지스트리: 분산 MCP 서버 검색 및 로드 밸런싱
Higress AI 게이트웨이: LLM 모델 프록시 및 라우팅
ARMS 관측 가능성: Alibaba Cloud Application Real-Time Monitoring Service와의 통합
Langfuse 통합: 포괄적인 추적 및 평가
벡터 스토어: 여러 벡터 데이터베이스 (Hologres, AnalyticDB, OpenSearch) 지원
RAG 지원: 완전한 검색 증강 생성 파이프라인
채팅 메모리: 다중 턴 대화를 위한 세션 메모리 관리
NL2SQL: 자연어-SQL 변환

추가 기능

문서 파싱: 여러 형식 (PDF, Word, Excel 등) 지원
이미지 생성: DashScope 기반 이미지 모델 통합
오디오 처리: 오디오 전사 및 합성
프롬프트 관리: 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 예제

// ChatModel 초기화
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("전문 작가 에이전트")
    .instruction("당신은 창의적인 글쓰기에 능숙한 유명 작가입니다.")
    .outputKey("article")
    .build();

// 에이전트 호출
AssistantMessage message = writerAgent.call("AI에 대한 100단어 에세이를 작성하세요");

다중 에이전트 워크플로우 예제

// 리뷰어 에이전트 생성
ReactAgent reviewerAgent = ReactAgent.builder()
    .name("reviewer_agent")
    .model(chatModel)
    .description("기사를 검토하고 편집합니다")
    .instruction("당신은 콘텐츠를 검토하고 개선하는 전문 편집자입니다.")
    .outputKey("reviewed_article")
    .build();

// 에이전트를 순차적으로 구성
SequentialAgent blogAgent = SequentialAgent.builder()
    .name("blog_agent")
    .description("기사를 작성하고 검토합니다")
    .subAgents(List.of(writerAgent, reviewerAgent))
    .build();

// 워크플로우 실행
Optional<OverAllState> result = blogAgent.invoke("Spring AI에 대한 블로그 게시물을 작성하세요");

공식 제품 및 예제

JManus

Spring AI Alibaba로 구축된 Manus (일반 AI 에이전트)의 Java 구현입니다. 다음을 지원합니다.

자율 계획 및 실행
특정 비즈니스 시나리오에 맞게 미세 조정된 에이전트
맞춤형 도구 및 하위 에이전트
계획 조정 및 재사용 기능
현재 Alibaba 그룹 내의 많은 애플리케이션에서 사용 중

DeepResearch

지능형 연구 에이전트로 다음 기능을 제공합니다.

완전한 프론트엔드 웹 UI 및 백엔드 구현
웹 검색 및 크롤링 기능
Python 스크립트 엔진 통합
MCP 서비스 지원
LLM 및 도구를 사용하여 포괄적인 연구 보고서 생성

DataAgent

다음 기능을 제공하는 자연어-SQL 프로젝트입니다.

자연어를 사용하여 데이터베이스에 직접 쿼리
복잡한 SQL 문을 작성할 필요 없음
엔터프라이즈 데이터베이스와의 원활한 통합

Playground

다음 기능을 갖춘 포괄적인 예제 애플리케이션입니다.

완전한 프론트엔드 UI 및 백엔드 구현
모든 핵심 프레임워크 기능 시연
기능: 챗봇, 다중 라운드 대화, 이미지 생성, 멀티모달리티, 도구 호출, MCP, RAG
로컬 배포 및 사용자 정의 가능

Spring AI Alibaba Admin

다음 기능을 제공하는 로컬 시각화 툴킷입니다.

프로젝트 관리
런타임 시각화
추적 및 디버깅
에이전트 평가 도구

에코시스템 통합

Alibaba Cloud 서비스

Bailian 플랫폼: LLM 모델 서비스 (Qwen 시리즈, DeepSeek)
DashScope: 포괄적인 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 기능

향상된 에이전트 개발 모드 (Agentic, Multi-agent, Workflow)
개선된 그래프 런타임
향상된 A2A 통신
더 나은 MCP 통합
업그레이드된 문서 및 공식 웹사이트

버전 1.0.x 기능

첫 GA 릴리스
프로덕션 준비 프레임워크
완전한 ChatBot, Workflow, Multi-agent 지원
심층적인 Alibaba Cloud 통합
그래프 기반 다중 에이전트 프레임워크

사용 가능한 스타터

spring-ai-alibaba-starter-dashscope - 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 기능

커뮤니티 및 지원

커뮤니케이션 채널

DingTalk 그룹: 130240015687 검색 후 가입
WeChat: 공식 WeChat 공개 계정 팔로우
GitHub Discussions: 커뮤니티 토론 및 Q&A
공식 문서: https://java2ai.com

사용 사례

엔터프라이즈 애플리케이션

고객 서비스 챗봇
내부 비즈니스 자동화
문서 처리 및 분석
지식 기반 Q&A 시스템
코드 생성 및 검토

수직 도메인 에이전트

도메인별 지능형 비서
자동화된 연구 및 보고
데이터 분석 및 시각화
프로세스 자동화 및 오케스트레이션
다단계 워크플로우 실행

개발 도구

AI 기반 프로그래밍 비서
코드 검토 및 최적화
문서 생성
테스트 및 디버깅 지원

기술적 장점

Java-Native: Java 에코시스템 및 Spring Boot에 대한 일급 지원
엔터프라이즈 준비: Alibaba 그룹에서 프로덕션 검증
클라우드 네이티브: Alibaba Cloud 인프라와의 심층 통합
유연한 아키텍처: 다양한 개발 패턴 (로우 코드, 하이 코드, 제로 코드) 지원
포괄적인 툴링: 에이전트 개발을 위한 풍부한 도구 및 구성 요소 세트
활발한 커뮤니티: 강력한 커뮤니티 지원 및 정기 업데이트
모범 사례: 실제 엔터프라이즈 배포에서 얻은 내장 패턴

다른 프레임워크와의 비교

Python 기반 프레임워크 (LangChain, LangGraph)와 달리 Spring AI Alibaba는 다음을 제공합니다.

Spring Boot 에코시스템 통합을 통한 네이티브 Java 지원
엔터프라이즈급 기능 (관측 가능성, 게이트웨이, 구성 관리)
클라우드 네이티브 인프라를 통한 프로덕션 준비 배포
Alibaba Cloud 서비스와의 원활한 통합
강력한 타이핑 및 컴파일 타임 안전성
JVM 환경에서 우수한 성능

향후 로드맵

지속적인 프레임워크 최적화 및 성능 개선
향상된 에이전트 개발 패턴 및 도구
확장된 모델 제공업체 지원
더 포괄적인 문서 및 튜토리얼
추가 엔터프라이즈 통합 기능
커뮤니티 주도 기능 및 개선

결론

Spring AI Alibaba는 Java 기반 AI 애플리케이션 개발에 있어 중요한 진전을 나타내며, 엔터프라이즈급 에이전트 프레임워크를 Java 에코시스템에 제공합니다. 포괄적인 기능, 심층적인 클라우드 통합 및 프로덕션 검증된 아키텍처를 통해 Java 개발자는 Spring 에코시스템에서 기대하는 것과 동일한 생산성과 안정성으로 정교한 AI 애플리케이션을 구축할 수 있습니다.

간단한 챗봇, 복잡한 다중 에이전트 시스템 또는 엔터프라이즈 워크플로우 자동화를 구축하든 Spring AI Alibaba는 AI 애플리케이션을 데모에서 프로덕션으로 전환하는 데 필요한 도구, 패턴 및 인프라를 제공합니다.