spring-ai-alibaba README

The project's README from github.com/alibaba/spring-ai-alibaba. As one markdown file: README.md.

Spring AI Alibaba

License CI Status Ask DeepWiki Maven Central gitleaks badge

A production-ready framework for building Agentic, Workflow, and Multi-agent applications.

Agent Framework Docs, Graph Docs, Spring AI, Examples.

Architecture

architecture

Spring AI Alibaba Admin is a one-stop Agent platform that supports visualized Agent development, observability, evaluation, and MCP management, etc. It also integrates with open-source low-code platforms like Dify, enabling rapid migration from DSL to Spring AI Alibaba project.

Spring AI Alibaba Agent Framework is an agent development framework that can quickly develop agents with built-in Context Engineering and Human In The Loop support. For scenarios requiring more complex process control, Agent Framework offers built-in workflows like SequentialAgent, ParallelAgent, RoutingAgent, LoopAgent.

Spring AI Alibaba Graph serves as the underlying runtime of the Agent Framework, providing essential capabilities such as persistence, workflow orchestration, and streaming required for long-running stateful agents. Compared to the Agent Framework, users can build more flexible multi-agent workflows based on the Graph API.

Core Features

architecture

Getting Started

Prerequisites

Quickly Run a ChatBot

There's a ChatBot example provided by the community at examples/chatbot.

  1. Download the code.

    git clone --depth=1 https://github.com/alibaba/spring-ai-alibaba.git
cd spring-ai-alibaba

  2. Start the ChatBot.

    Before starting, set API-KEY first (visit Aliyun Bailian to get API-KEY):

    # this example uses 'spring-ai-alibaba-starter-dashscope', visit https://java2ai.com to learn how to use OpenAI/DeepSeek.
export AI_DASHSCOPE_API_KEY=your-api-key

    # Maven installation is optional when using mvnw.
./mvnw -pl examples/chatbot spring-boot:run

  3. Chat with ChatBot.

    Open the browser and visit http://localhost:8080/chatui/index.html to chat with the ChatBot.

chatbot-ui

Chatbot Code Explained

  1. Add dependencies

    <dependencies>
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-agent-framework</artifactId>
    <version>1.1.2.0</version>
  </dependency>
  <!-- Assume you are going to use DashScope Model. Refer to docs for how to choose model.-->
  <dependency>
    <groupId>com.alibaba.cloud.ai</groupId>
    <artifactId>spring-ai-alibaba-starter-dashscope</artifactId>
    <version>1.1.2.1</version>
  </dependency>
</dependencies>

  2. Define Chatbot

    For more details of how to write a Chatbot, please check the Quick Start on our official website.

📚 Documentation

Project Structure

This project consists of several core components:

Spring AI Alibaba Ecosystem

Repository Description ⭐
Spring AI Alibaba Graph A low-level orchestration framework and runtime for building, managing, and deploying long-running, stateful agents. GitHub Repo stars
Spring AI Alibaba Admin Local visualization toolkit for the development of agent applications, supporting project management, runtime visualization, tracing, and agent evaluation. GitHub Repo stars
Spring AI Extensions Extended implementations for Spring AI core concepts, including DashScopeChatModel, MCP registry, etc. GitHub Repo stars
Spring AI Alibaba Examples Spring AI Alibaba Examples. GitHub Repo stars
JManus A Java implementation of Manus built with Spring AI Alibaba, currently used in many applications within Alibaba Group. GitHub Repo stars
DataAgent A natural language to SQL project based on Spring AI Alibaba, enabling you to query databases directly with natural language without writing complex SQL. GitHub Repo stars
DeepResearch Deep Research implemented based on spring-ai-alibaba-graph. GitHub Repo stars

Contact Us

Resources

Star History

Star History Chart

Made with ❤️ by the Spring AI Alibaba Team

spring-ai-alibaba (alibaba/spring-ai-alibaba)

Searching Database…

11K ·GitHub
Spring-ai-alibaba
Что это такое?Spring AI Alibaba — это готовый к промышленной эксплуатации Java-фреймворк для создания агентных, workflow- и мультиагентных приложений, построенный на основе Spring AI.
Это фреймворк, на котором я строю своё решение, или готовое приложение-агент?Это Java-фреймворк из нескольких уровней: Agent Framework для быстрого создания агентов, более низкоуровневый Graph runtime для собственных workflow и необязательная платформа Admin с визуальным интерфейсом для разработки и наблюдаемости.
Как запустить базового агента?Скачайте пример чат-бота из examples/chatbot, укажите API-ключ вашего LLM-провайдера (например, из Aliyun Bailian), запустите приложение и общайтесь с ним через браузер.
Что нужно установить перед тем, как это попробовать?JDK 17 или новее и API-ключ от LLM-провайдера, например DashScope или OpenAI.
Нужны ли отдельные проекты Admin или Studio, чтобы начать?Нет: Agent Framework или Graph API можно использовать самостоятельно как Java-библиотеку. Платформа Admin и встроенный UI Studio — отдельные необязательные компоненты для визуальной разработки, отладки и наблюдаемости.
Для кого это создано?Для Java-разработчиков, которые хотят добавить возможности агентного ИИ (чат-боты, мультиагентные workflow, голосовые агенты) в существующие приложения на основе Spring.
Какие готовые мультиагентные паттерны здесь есть?Есть готовые паттерны оркестрации: SequentialAgent, ParallelAgent, RoutingAgent и LoopAgent для составления сложных многошаговых задач агентов.
Могут ли агенты общаться друг с другом между разными сервисами?Да, во фреймворке есть поддержка A2A (Agent-to-Agent), интегрированная с Nacos. Она позволяет координировать и совместно работать агентам, распределённым по отдельным сервисам.
Поддерживаются ли голосовые взаимодействия?Да, есть голосовой агент в реальном времени на основе WebSocket: он принимает аудио- или текстовый ввод потоком и отвечает сгенерированным аудио.
Что здесь означает Context Engineering?Это набор встроенных лучших практик для повышения надёжности агентов: участие человека (human-in-the-loop), сжатие и редактирование контекста, ограничение числа вызовов инструментов, повторные попытки вызова инструментов, планирование и динамический выбор инструментов.
Могу ли я экспортировать диаграммы своих workflow?Да, workflow на основе графов можно экспортировать в форматы PlantUML и Mermaid для визуализации и документации.
What are similar projects?PocketFlow, ai-agents-the-definitive-guide, harness-sdk, ruflo, Agentlas-OS, hyperfide, hive, turnstone
Which topics is it in?voice-agent, a2a, alibaba, spring, graph, multi-agent-systems, agentic, context-engineering, autonomous-agents, agent-framework, workflow, workflow-automation
Creator
alibaba
Size
226.6 MB
Stars
11K
Updated
CommitOct 07Releasev1.1.2.2Mar 10
Age
2y
Commits · 90 Days