Spring AI Alibaba Admin 开源-低调大师

Spring AI Alibaba Admin 开源

2025-10-22 66

作者：孔可青

背景与挑战

1.1 行业背景：AI Agent 迈入规模化落地新阶段

随着生成式 AI 技术逐步成熟，AI Agent 已经越过技术炒作周期的峰值，进入大规模探索与产业落地的关键阶段。越来越多的企业开始将 AI Agent 应用于智能客服、自动化运营、辅助决策等核心业务场景，推动智能化升级。

在此背景下，Spring AI Alibaba 作为开源的 AI Agent 开发框架，致力于为 Java 生态开发者提供一套标准化、可扩展、生产就绪的开发体系。框架支持从基础 Agent 构建、工作流编排（Workflow）、检索增强生成（RAG）到多模型适配的全栈能力，帮助开发者快速构建高质量的生成式 AI 应用。

官网：https://java2ai.com
GitHub：https://github.com/alibaba/spring-ai-alibaba

1.2 企业级 AI 应用落地的核心挑战

尽管 Spring AI Alibaba 开发框架显著降低了入门门槛，但在真实的企业研发流程中，从原型验证到生产上线仍面临诸多工程化挑战。这些挑战贯穿 Dev（开发）与 Ops（运维） 两大阶段，直接影响研发效率、系统稳定性与业务价值实现，主要体现在以下三个方面：

1）Prompt 工程缺乏标准化与协作机制

在传统开发模式下，Prompt 多以硬编码形式存在于代码中，导致：

修改 Prompt 需重新编译和重启应用，调试周期长、成本高；
缺乏版本管理能力，无法追溯历史变更或进行 A/B 对比；
不同环境间配置不统一，团队协作效率低，易引发一致性问题。

2）AI 应用质量评估体系不健全

当前多数 AI 应用依赖人工验证或临时脚本进行测试，存在明显短板：
测试过程非系统化，难以覆盖多样化的输入场景；
缺少可量化的评估指标，模型输出的质量难以客观衡量；
评估结果不可复现，无法支撑持续迭代与效果对比。

3）线上运行状态不可观测

AI 应用在生产环境中常表现为“黑盒”运行，带来运维难题：

调用链路不透明，异常请求难以定位具体环节；
缺乏细粒度的执行追踪，性能瓶颈识别困难；
故障排查依赖日志堆叠分析，响应效率低，影响服务稳定性。

1.3 破局之道：构建以数据为中心的 AI 研发治理体系

要真正实现 AI Agent 的高效开发与可靠运行，必须突破“重模型、轻工程”的传统思维，转向以数据驱动、流程闭环、工具赋能为核心的现代化研发范式。解决上面问题，我们需要构建一个简单、易用、专业的开发框架，提升研发效率。构建一个以数据为中心的 Agent 开发平台，通过调试、观测、评估一体化解决 Dev 阶段调试效率和效果问题。

Spring AI AIibaba Admin：以数据为中心的 Agent 开发平台

核心价值

为应对企业级 AI Agent 在开发与运维过程中面临的工程化挑战，我们正式推出 Spring AI Alibaba Admin —— 一款面向生产级场景的一体化 AI Agent 应用研发治理平台。

项目地址：

https://github.com/spring-ai-alibaba/spring-ai-alibaba-admin

该平台深度集成配置管理、自动化评估体系与全链路可观测能力，覆盖 AI 应用从开发、调试、测试到上线、监控、优化的完整生命周期，全面支撑高效研发、质量保障与稳定运行。

平台提供四大核心能力：

1. Prompt 管理：实现 Prompt 的工程化与高效迭代

构建标准化的 Prompt 开发流程，助力 Prompt 工程师专业、高效地完成从设计到上线的全链路管理。

模板管理： 支持 Prompt 模板的创建、编辑与删除，内置代码高亮与语法提示，提升编写体验。
版本控制： 完整记录每次变更历史，支持版本对比与一键回滚，保障变更安全。
实时调试： 提供在线调试环境，支持流式响应预览，实现“即改即测”。
会话管理： 支持多轮对话模拟，还原真实交互场景，验证上下文连贯性。
动态配置与热更新： 与 Nacos 配置中心无缝集成，实现 Prompt 和模型参数的动态发布与实时生效，无需重启应用即可完成配置变更，显著提升迭代敏捷性。

2. 数据集管理：构建高质量、可复用的评估数据资产

为 AI 应用评估提供可靠的数据基础，支持多样化数据源与真实场景还原。

细粒度管理： 支持数据项的增删改查及批量操作，便于维护大规模测试集。
版本管理： 数据集支持版本快照，可追溯历史变更并快速回退。
链路数据复用： 支持从 OpenTelemetry 链路中提取真实请求，自动生成测试数据集，精准复现线上问题。

3. 评估器管理：建立可配置、可度量的评估体系

通过可视化方式定义评估逻辑，构建科学、一致的质量评判标准。

评估器配置： 支持准确性、相关性、合规性等多种维度的规则配置，灵活组合评估策略。
预置模板： 提供常用评估器模板，开箱即用，降低使用门槛。
在线调试： 支持单步执行与结果预览，快速验证评估逻辑正确性。
版本发布： 评估器支持版本管理与发布流程，确保生产环境一致性。
结果报告： 支持多评估器结果聚合展示，提供统一视图便于横向对比与综合分析。

4. 可观测性：让 AI 调用过程透明可控

深度集成 OpenTelemetry，全面追踪 AI 应用运行状态，提升可解释性与运维效率。

链路追踪： 完整记录每次 AI 请求的调用链路，涵盖 Prompt 渲染、模型调用、工具执行等环节。
服务概览： 提供服务级监控面板，掌握整体调用趋势与健康状态。
Trace 详情分析： 支持 Span 级别拆解，精准定位性能瓶颈与异常节点。
错误诊断： 结合上下文日志与调用链，快速定位失败根因，缩短排障时间。

典型使用场景

场景一：Prompt 工程师的高效迭代

支持 Prompt 从开发、调试到上线的全生命周期管理，提升工程化水平。

在 Admin 平台创建和管理 Prompt 模板，实现标准化配置；
利用在线调试功能实时预览模型输出，快速完成多轮优化；
发布至 Nacos 配置中心，应用侧自动加载最新版本，实现无感更新；
通过版本对比功能量化优化效果，辅助决策上线时机。

场景二：AI 应用的质量保障

构建可度量、可重复的评估流程，保障 AI 输出的稳定性与可靠性。

构建覆盖核心业务场景的评估数据集，确保测试全面性；
配置多样化评估器（如准确性、合规性、一致性等），明确定义质量标准；
批量运行实验并自动化执行评估任务，提升评测效率；
基于可视化报告分析结果，持续优化模型与 Prompt 策略。

场景三：线上问题的快速定位与修复

结合链路追踪与评估能力，实现问题闭环处理。

在链路追踪页面定位异常请求，查看完整执行上下文；
分析调用链路中的各环节耗时与输出，精准识别故障节点；
从真实链路数据生成测试数据集，复现问题场景；
完成优化后重新评估，验证修复效果，形成“发现问题-优化-验证”的闭环。

操作教程

1. 克隆项目

git clone https://github.com/spring-ai-alibaba/spring-ai-alibaba-admin.git
cd admin

2. 配置您的 API 密钥

根据您的模型供应商，修改 spring-ai-alibaba-admin-server/model-config.yaml 的模型配置。

如果您使用 DashScope，请参照 model-config-dashscope.yaml 模版进行配置。
如果您使用 DeepSeek，请参照 model-config-deepseek.yaml 模版进行配置。
如果您使用 OpenAI，请参照 model-config-openai.yaml 模版进行配置。

💡 获取您的 DashScope API 密钥：访问阿里云百炼控制台获取免费 API 密钥。

https://bailian.console.aliyun.com/?tab=model#/api-key

3. nacos配置（可选）

如果您需要修改 nacos 地址，请更新 spring-ai-alibaba-admin-server/src/main/resources/application.yml 文件中的配置。

nacos:
  server-addr: ${nacos地址}

4. 启动SAA Admin

在根目录下，执行启动脚本。

sh start.sh

spring-ai-alibaba-admin-server 目录下启动应用程序：

mvn spring-boot:run

5. 访问应用

打开浏览器访问 http://localhost:8080 即可使用 SAA Admin 平台。

至此，您已经可以在平台中对 prompt 进行管理、调试、评估、可观测。如果您期望 Spring AI Alibaba Agent 应用能够集成 Nacos 以实现 prompt 加载以及动态更新，并且观测线上的运行情况，可以参照第六步配置您的 AI Agent 应用。

6. 连接您的 AI Agent 应用

在您的 Spring AI Alibaba Agent 应用中，引入如下依赖：

<dependencies>
    <!-- 引入spring ai alibaba agent nacos代理模块 -->
    <dependency>
        <groupId>com.alibaba.cloud.ai</groupId>
        <artifactId>spring-ai-alibaba-agent-nacos</artifactId>
        <version>{spring.ai.alibaba.version}</version>
    </dependency>
    <!-- 引入可观测模块 -->
    <dependency>
        <groupId>com.alibaba.cloud.ai</groupId>
        <artifactId>spring-ai-alibaba-autoconfigure-arms-observation</artifactId>
        <version>{spring.ai.alibaba.version}</version>
    </dependency>
    <!-- 用于实现各种 OTel 相关组件，如 Tracer、Exporter 的自动装载 -->
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-actuator</artifactId>
    </dependency>
    <!-- 用于将 micrometer 产生的指标数据对接到 otlp 格式 -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-registry-otlp</artifactId>
    </dependency>
    <!-- 用于将 micrometer 底层的链路追踪 tracer 替换为 OTel tracer -->
    <dependency>
        <groupId>io.micrometer</groupId>
        <artifactId>micrometer-tracing-bridge-otel</artifactId>
    </dependency>
    <!-- 用于将 OTel tracer 产生的 span 按照 otlp 协议进行上报 -->
    <dependency>
        <groupId>io.opentelemetry</groupId>
        <artifactId>opentelemetry-exporter-otlp</artifactId>
    </dependency>
    <dependency>
        <groupId>org.springframework.ai</groupId>
        <artifactId>spring-ai-autoconfigure-model-tool</artifactId>
        <version>1.0.0</version>
    </dependency>
</dependencies>

指定 nacos 地址及 prompKey：

    spring.ai.alibaba.agent.proxy.nacos.serverAddr={ 替换 nacos address, 示例：127.0.0.1:8848}
    spring.ai.alibaba.agent.proxy.nacos.username={ 替换 nacos 用户名, 示例：nacos}
    spring.ai.alibaba.agent.proxy.nacos.password={ 替换 nacos 密码, 示例：nacos}
    spring.ai.alibaba.agent.proxy.nacos.promptKey={ 替换为promptKey，示例：mse-nacos-helper }

设置可观测参数：

    management.otlp.tracing.export.enabled=true
    management.tracing.sampling.probability=1.0
    management.otlp.tracing.endpoint=http://{admin address}:4318/v1/traces
    management.otlp.metrics.export.enabled=false
    management.otlp.logging.export.enabled=false
    management.opentelemetry.resource-attributes.service.name=agent-nacos-prompt-test
    management.opentelemetry.resource-attributes.service.version=1.0
    spring.ai.chat.client.observations.log-prompt=true
    spring.ai.chat.observations.log-prompt=true
    spring.ai.chat.observations.log-completion=true
    spring.ai.image.observations.log-prompt=true
    spring.ai.vectorstore.observations.log-query-response=true
    spring.ai.alibaba.arms.enabled=true
    spring.ai.alibaba.arms.tool.enabled=true
    spring.ai.alibaba.arms.model.capture-input=true
    spring.ai.alibaba.arms.model.capture-output=true

未来规划

将持续增强 AI Agent 应用的研发支持能力，重点推进三方面建设：

评估体系升级： 突破当前以 Prompt 为核心的评估局限，逐步支持对 Tools、Rag 和 Agent 行为的综合评估。未来将覆盖多 Agent 协作场景的端到端效果评测，提供 Agent 间交互质量、任务协同效率等量化指标。
链路追踪与分析能力增强： 深化执行过程的可观测性，支持 Agent 决策路径的可视化展示，以及工具调用链路的完整追踪与分析，帮助开发者快速定位异常与优化瓶颈。
智能化迭代能力构建： 引入自动化与智能化机制，支持 A/B 测试的自动执行，探索使用 AI 算法构建数据集，根据评估结果自动调优参数、生成评估标准、提供 Prompt 优化建议等能力，提升迭代效率。

Spring AI Alibaba 后续会把内核升级为 AgentScope，持续为 Java 开发者打造自动装配、开箱即用的 Agent 开发框架。同时，Spring AI Alibaba Admin 将深度整合至 AgentScope Studio 中，共同构建覆盖开发、调试、评估与观测一体化 AI 应用研发平台。

Spring AI Alibaba 是一个开源项目，我们欢迎所有对 AI 和 Java 感兴趣的开发者参与共建！欢迎使用钉钉搜索群号：94405033092 加入 SAA 项目群。

点击此处，关注 Spring AI Alibaba。

微信关注我们

原文链接：https://my.oschina.net/u/3874284/blog/18696731

转载内容版权归作者及来源网站所有！

低调大师中文资讯倾力打造互联网数据资讯、行业资源、电子商务、移动互联网、网络营销平台。持续更新报道IT业界、互联网、市场资讯、驱动更新,是最及时权威的产业资讯及硬件资讯报道平台。

GOTC 大模型应用技术论坛：如何落地工程实践？如何为企业带来价值？

当「大模型能力」不再只是 Demo 案例，而要真正为企业创造价值——你必须来看看这一场实战派的技术分论坛。全球开源技术峰会 GOTC 2025 大模型应用技术论坛，聚焦从架构、芯片、私有化到检索增强（RAG）与多模态落地的全链路工程实践，邀请到行业内最前沿的工程团队与实践者，带来干货满满、可复制的落地经验。直击工程化痛点：从 Demo 到生产的关键难题与解决路径。覆盖栈宽广：模型架构、Agent、多模态、芯片软件生态、向量检索与 RAG 实践。实战案例：真实客户落地、性能指标、工程折中与优化思路，一键带回团队实操清单。人脉机会：与 RWKV、商汤、Elastic、燧原、MiniMax 等核心作者与工程师面对面交流。回到公司就能落地的实战清单与可验证思路，不是概念，不是炫技——是真正能推进项目从 PoC 到生产的工程答案。位置有限，先到先得！访问 GOTC 官方报名通道报名参会：https://www.oschina.net/event/8598047 全球开源技术峰会 GOTC 2025，为期 2 天的开源技术与行业盛会，将通过行业展览、主题发言、圆桌讨论等形式来诠释此次大...

2025-10-22

46

Anthropic 宣布 Claude 桌面客户端已正式 GA（此前一直是预览版），目前支持 Windows 和 Mac 平台。其中 Mac 版提供了以下新功能：全局快捷键：双击 Option 键就能在任何界面唤醒 Claude，写代码、看文档时随叫随到；屏幕共享：可以直接截图或共享整个应用窗口给 Claude，不用反复拖文件；语音输入：按 Caps Lock 键说话，边想边聊（但注意别和输入法切换冲突）；工具连接：通过 MCP 协议连代码编辑器、本地文件等，让 Claude 直接操作你的工作环境；下载地址：https://claude.com/download

2025-10-22

108

资源下载

更多资源

Mario

马里奥是站在游戏界顶峰的超人气多面角色。马里奥靠吃蘑菇成长，特征是大鼻子、头戴帽子、身穿背带裤，还留着胡子。与他的双胞胎兄弟路易基一起，长年担任任天堂的招牌角色。

腾讯云软件源

为解决软件依赖安装时官方源访问速度慢的问题，腾讯云为一些软件搭建了缓存服务。您可以通过使用腾讯云软件源站来提升依赖包的安装速度。为了方便用户自由搭建服务架构，目前腾讯云软件源站支持公网访问和内网访问。

Rocky Linux

Rocky Linux（中文名：洛基）是由Gregory Kurtzer于2020年12月发起的企业级Linux发行版，作为CentOS稳定版停止维护后与RHEL（Red Hat Enterprise Linux）完全兼容的开源替代方案，由社区拥有并管理，支持x86_64、aarch64等架构。其通过重新编译RHEL源代码提供长期稳定性，采用模块化包装和SELinux安全架构，默认包含GNOME桌面环境及XFS文件系统，支持十年生命周期更新。

Sublime Text

Sublime Text具有漂亮的用户界面和强大的功能，例如代码缩略图，Python的插件，代码段等。还可自定义键绑定，菜单和工具栏。Sublime Text 的主要功能包括：拼写检查，书签，完整的 Python API ， Goto 功能，即时项目切换，多选择，多窗口等等。Sublime Text 是一个跨平台的编辑器，同时支持Windows、Linux、Mac OS X等操作系统。