1. 总览

Spring AI Alibaba Admin Server 是 Spring AI Alibaba 的一站式 Agent 管理和开发平台，提供了可视化的 Agent 开发、调试、部署和监控能力。

适用场景:

• 需要可视化 Agent 开发平台
• 多团队协作开发 Agent
• 需要管理多个知识库
• 需要集成外部 MCP 服务
• 需要工作流编排能力

需要注意的是，当前 SAA Admin 还是之前基于 Spring AI Alibaba 1.0.0.3 版本开发的，直接用 1.1.2.2 中的 spring-ai-alibaba-admin 会有不少坑，比如很多包根本就没有 1.1.2.2 版本，如果不开发维护了，为啥要留在 Spring AI Alibaba 主仓库发布版本中… 如需使用，请仔细斟酌！！！

1.1 核心功能

🤖 Prompt 管理

• Prompt 模板管理: 创建、更新、删除 Prompt 模板
• 版本控制: 支持 Prompt 版本管理和历史追踪
• 实时调试: 提供 Prompt 在线调试和流式响应
• 会话管理: 支持多轮对话会话管理

📊 数据集管理

• 数据集创建: 支持多种格式的数据集导入和创建
• 版本管理: 数据集版本控制和历史管理
• 数据项管理: 细粒度的数据项增删改查
• 从链路追踪创建: 支持从 OpenTelemetry 链路数据创建数据集

⚖️ 评估器管理

• 评估器配置: 支持多种评估器的创建和配置
• 模板系统: 提供评估器模板和自定义评估逻辑
• 调试功能: 支持评估器在线调试和测试
• 版本管理: 评估器版本控制和发布管理

🧪 实验管理

• 实验执行: 自动化执行评估实验
• 结果分析: 详细的实验结果分析和统计
• 实验控制: 支持实验的启动、停止、重启和删除
• 批量处理: 支持批量实验执行和结果对比

📈 可观测性

• 链路追踪: 集成 OpenTelemetry 提供完整的链路追踪
• 服务监控: 支持服务列表和概览统计
• Trace 分析: 提供详细的 Trace 详情和 Span 分析

🔧 模型配置

• 多模型支持: 支持 OpenAI、DashScope、DeepSeek 等主流 AI 模型
• 配置管理: 模型参数的统一配置和管理
• 动态切换: 支持运行时模型配置的动态更新

1.2 侧边栏导航

菜单组	图标	子菜单
Agent Builder	AppstoreOutlined	App、MCP、Components、Knowledge、Dify To Graph
Prompt Engineering	BulbOutlined	Prompts、Playground
Evaluation	ExperimentOutlined	Evaluation Sets、Evaluators、Experiments
Observability	LineChartOutlined	Tracing
Settings	SettingOutlined	直接跳转设置页

2. 模型服务管理

【模型服务管理】负责管理 模型服务商（Provider） 和 模型（Model） ，所有 Agent、Workflow 在调用大模型时，都依赖此模块提供的模型配置。

通过设置进入模型服务管理页面：

点击【新增模型服务商】：

3. Agent Builder

3.1 应用管理

查看应用列表信息，卡片网格列表，支持搜索和分页，支持重命名、复制、删除操作：

支持创建两种类型的应用：

• 智能体应用：构建智能体应用，连接知识、数据与服务，强大的 RAG、MCP、插件、记忆及组件能力，适配多种模型，适用于智能助理型、对话型场景
• 工作流编排应用：用户通过画布自定义编排工作流，快速实现业务逻辑设计及效果验证，支持大模型、智能体、组件、API等多种节点，适用于多智能体协同型、流程型场景

3.1.1 智能体应用

支持配置：

功能	说明
模型选择	选择 LLM 提供商和模型，配置参数（temperature、maxTokens 等）
Prompt 编辑器	富文本系统提示词编辑，支持变量插入
工具配置	添加插件工具（Plugin）
MCP 服务	添加 MCP 服务器
Agent 组件	添加 Agent 组件
Workflow 组件	添加 Workflow 组件
知识库	添加知识库，支持文件搜索和引用
记忆配置	对话轮数设置
变量配置	定义 Prompt 变量
开场白	欢迎消息和预设问题
自动保存	300ms 防抖自动保存
版本管理	草稿、已发布、历史版本对比
导出项目	将应用配置转换为 Agent DSL 并下载 zip

发布渠道：

• API 发布配置
• 组件发布配置
• API 文档展示

聊天测试窗口（SparkChat）：

• SSE 流式对话
• 推理步骤可视化（Reasoning、Knowledge、Plugin）
• 工具调用过程展示
• 知识库检索引用展示
• 文件搜索结果展示

交互模式：

• textDialog：对话模式（多轮）
• textGenerate：生成模式（单次）

3.1.2 工作流编排应用

基于 ReactFlow 的可视化流程编辑器，支持 18 种节点类型：

节点类型	说明
Start	流程开始节点
End	流程结束节点
InputNode	用户输入节点
Output	输出节点
LLM	大模型调用节点
Classifier	AI 分类器节点
Judge	条件分支节点
APINode	HTTP API 调用节点
Script	脚本/代码执行节点
Retrieval	知识检索节点
Plugin	插件工具节点
MCP	MCP 服务工具节点
AppComponent	应用组件节点
ParameterExtractor	参数提取节点
VariableAssign	变量赋值节点
VariableHandle	变量处理节点
Iterator（Start/End）	迭代循环节点
Parallel（Start/End）	并行执行节点

每个节点可配置：

配置项	说明
错误捕获	节点异常处理策略
重试策略	失败重试次数和间隔
短期记忆	节点级记忆配置
模型参数	LLM 节点的模型和参数
认证配置	API 节点的认证信息

全局功能：

• 全局变量 / 会话变量配置
• 工作流调试测试（ChatTestPanel、TestPanel、TaskTestPanel）
• 节点执行结果查看（NodeResultPanel）
• 发布前检查清单验证
• 版本管理
• 导出为 SAA 项目
• 同 Agent 应用的发布配置

3.2 MCP 管理

卡片网格列表展示 MCP 服务器，支持查看详情、编辑、删除、启动/停止部署操作：

创建 MCP 服务：

字段	说明
服务名称	MCP 服务器名称
描述	服务描述
安装类型	安装方式选择
MCP 服务配置	支持 MCP 市场、Nacos、Higress 导入

MCP 服务详情四个标签页：

标签页	状态	说明
概览	可用	MCP 服务器基本信息
工具	可用（MCP 禁用时不可用）	工具列表和详情
资源	未开放	Coming Soon
提示词	未开放	Coming Soon

3.3 组件管理

三种组件总览：

标签页	Key	说明
插件	plugin	插件管理（Python 后端模式下隐藏）
Workflow	flow	工作流组件管理
Agent	agent	Agent 组件管理

3.3.1 插件

创建/编辑插件：

字段	说明
插件名称	插件标识名
描述	插件说明
插件 URL	插件服务地址
Header 列表	HTTP 请求头配置
认证设置	类型：api_key / none；配置：basic / bearer / custom

3.3.2 Workflow / Agent 组件

以组件的形式发布智能体/工作流应用，需要配置入参，发布后用户可以通过组件的方式在其他应用中黑盒的引用这个智能体/工作流的内容。

3.4 知识库管理

卡片网格列表，支持搜索、分页、删除创建知识库等操作。

【 创建知识库】填写知识库信息：

选择数据：

数据处理：

3.5 DIFY 应用转换

Dify 转换器：

• 上传 Dify DSL YAML 文件
• 将 Dify 应用转换为 Spring AI Alibaba 项目
• 下载生成的 Spring Boot 项目 zip 包
• 支持文件拖拽上传
• 分步操作指引

4. Prompt 工程

4.1 Prompts 管理

管理和组织你的 AI 提示词模板。

创建：

4.2 Playground

可直接使用提示词进行对话测试：

5. 评测

5.1 评测集管理

5.2 评估器管理

5.3 实验管理

6. 可观测

• 链路追踪: 集成 OpenTelemetry 提供完整的链路追踪
• 服务监控: 支持服务列表和概览统计
• Trace 分析: 提供详细的 Trace 详情和Span 分析

6.1 链路追踪

Trace 详情和Span 分析：

7. 其他

7.1 账号管理

7.2 API KEY 管理