阿里又开源了一个顶级Java项目!

将 脚本之家 设为“星标⭐”

前言

最近半年，AI Agent的热度居高不下，但很多Java团队却陷入了一个尴尬的境地：Python生态的AI框架（LangChain、AutoGen）确实强大。

但要接入现有的Spring Cloud体系、要保障金融级的数据安全、要处理几十个微服务的复杂集成，简直是“大象硬要钻老鼠洞”。

2025年12月，阿里巴巴通义实验室正式开源了AgentScope Java 1.0，这个专为Java开发者打造的企业级智能体开发框架，一经发布就引爆了技术社区。

今天这篇文章就专门跟大家一起聊聊AgentScope，希望对你会有所帮助。

01 为什么要有AgentScope Java？

有些小伙伴可能已经尝试过用Python的LangChain或AutoGen来构建智能体。

确实，写个Demo很简单，但要落地到生产环境，尤其是Java主导的企业级系统，往往会遇到几个“拦路虎”：

第一，技术栈割裂。 你的核心交易系统是Spring Cloud，用户权限走的是Shiro，数据库连接池是Druid。现在为了一个Agent，要单独搭一套Python服务，两边通过HTTP调用，调试起来头皮发麻。

第二，安全难以保障。 金融场景下，Agent可能要查询订单、操作数据库。Python脚本跑在业务系统旁边，怎么隔离？怎么控制权限？出了问题谁负责？

第三，运维体系不兼容。 Java生态有成熟的监控（Arthas）、链路追踪（SkyWalking）、配置中心（Nacos）。Python那一套很难融入这个体系。

第四，多智能体协作复杂。 真实业务往往需要多个Agent分工协作（一个查订单、一个算积分、一个发通知）。Python框架要么不支持分布式部署，要么需要自己造轮子。

AgentScope Java正是为了解决这些痛点而生的。

它不是简单的“LangChain的Java翻译版”，而是站在企业级视角，重新设计的生产级智能体开发框架。

02 核心范式：ReAct——让Agent真正“会思考、能动手”

AgentScope Java采用了业界领先的ReAct（Reasoning + Acting）范式。

这和工作流（Workflow）模式有什么区别？

我用一张图来说明：

Workflow模式下，开发者需要提前把每一步写死——先查数据库、再调API、最后组装返回。这就像给AI戴上“镣铐”，当业务逻辑变复杂时，维护成本激增，而且无法享受大模型持续进化带来的能力提升。

ReAct模式则把控制权交给大模型。Agent会像人一样“思考-行动-观察”，循环推进直到完成任务。这种模式能处理完全未知的复杂场景，AgentScope Java把这个范式做到了企业级可用。

2.1 实时介入：让Agent运行全程可控

传统Agent一旦启动就“放飞自我”，开发者只能干瞪眼。

AgentScope Java基于异步架构，实现了强大的实时介入机制：

// 实时打断示例AgentRuntime runtime = AgentRuntime.builder()    .agent(customerServiceAgent)    .build();// 异步启动AgentCompletableFuture<AgentResponse> future = runtime.executeAsync(request);// 如果发现Agent跑偏，随时打断if (needInterrupt()) {    runtime.interrupt();  // 立即终止    AgentState snapshot = runtime.saveState();  // 自动保存上下文// 后续可以恢复}

• 安全中断：随时暂停Agent，自动保存上下文和工具状态
• 实时打断：任务偏离预期或耗时过长时，立即终止，避免资源浪费
• 灵活定制：可自定义中断处理逻辑，实现精细化管理

03 5分钟开发第一个Java Agent

理论说再多，不如直接看代码。AgentScope Java深度集成Spring Boot，上手极其简单。

3.1 引入依赖

<dependency><groupId>io.agentscope</groupId><artifactId>agentscope-spring-boot-starter</artifactId><version>1.0.0</version></dependency>

3.2 配置application.yml

agentscope:core:model:dashscope:api-key:${DASHSCOPE_API_KEY}# 通义千问API密钥model-name:qwen-plusagent:max-steps:10# 最大思考步数sandbox:enabled:true# 开启安全沙箱

3.3 定义Agent和工具

@AgentComponent("order-assistant")publicclassOrderAssistant{@Autowiredprivate OrderService orderService;@Autowiredprivate RefundService refundService;@Tool("根据订单号查询订单状态")public String queryOrderStatus(String orderId){        Order order = orderService.findByOrderId(orderId);if (order == null) {return"未找到订单";        }return String.format("订单状态：%s，金额：%s元，下单时间：%s",            order.getStatus(), order.getAmount(), order.getCreateTime());    }@Tool("执行退款操作（需要权限验证）")public String executeRefund(String orderId, String reason){// 实际退款逻辑boolean success = refundService.processRefund(orderId, reason);return success ? "退款成功" : "退款失败";    }}

3.4 调用Agent

@RestControllerpublicclassAgentController{@Autowiredprivate AgentRuntime runtime;@PostMapping("/chat")public String chat(@RequestBody String message){// 执行Agent，它会自主思考、调用工具        AgentResponse response = runtime.execute("order-assistant", message);return response.getFinalAnswer();    }}

这段代码跑起来，一个能自主查询订单、执行退款的智能体就诞生了。整个过程不到20行核心代码。

04 安全沙箱与上下文工程

Agent要接入真实业务系统，安全和效果是两大命门。

AgentScope Java在这两方面下了大功夫。

4.1 安全沙箱：给Agent戴上“紧箍咒”

Agent在执行工具调用时，可能访问敏感资源。AgentScope提供了多层隔离机制：

@ConfigurationpublicclassSandboxConfig{@Beanpublic Sandbox sandbox(){return Sandbox.builder()            .fileSystem(FileSystemSandbox.builder()                .allowedPaths("/tmp/agentscope", "/data/temp")                .readOnly(true)                .build())            .network(NetworkSandbox.builder()                .whitelist("internal-api.example.com", "api.weather.com")                .build())            .docker(DockerSandbox.builder()                .memoryLimit("512m")                .cpuLimit(1)                .build())            .build();    }}

内置多种沙箱：

• GUI沙箱：提供完整桌面环境，支持鼠标、键盘、屏幕操作
• 文件系统沙箱：隔离文件读写，只允许操作指定目录
• 移动端沙箱：基于Android模拟器，支持点击、滑动、截屏

4.2 上下文工程：让Agent真正“懂你”

• RAG（检索增强生成）：内置基于Embedding的标准实现，支持私有化知识库；集成阿里云百炼企业级知识库，获得更强大的检索与重排序能力。
• 记忆管理：定义短期、长期记忆抽象，支持语义搜索与多租户隔离。通过ReMe项目提供记忆最佳实践，让Agent理解用户偏好、提升任务表现，实现“越用越好用”。

05 A2A协议 + RocketMQ

真实业务往往需要多个Agent分工协作。

AgentScope Java通过A2A（Agent-to-Agent）协议，让多智能体协作像调用微服务一样简单。

@ServicepublicclassMultiAgentService{@Autowiredprivate AgentClient agentClient;public String handleRefund(String orderId){// 1. 调用风险评估Agent        RiskAssessmentAgent riskAgent = agentClient.find("risk-assessment");boolean safe = riskAgent.evaluate(orderId);if (!safe) {return"退款申请被风控拦截";        }// 2. 调用财务Agent执行退款        FinanceAgent financeAgent = agentClient.find("finance-agent");        String result = financeAgent.refund(orderId);// 3. 调用通知Agent发送消息        NotificationAgent notifyAgent = agentClient.find("notification-agent");        notifyAgent.sendRefundSuccess(orderId);return result;    }}

更重磅的是，AgentScope与Apache RocketMQ深度集成，推出了基于LiteTopic的企业级A2A通信基座：

• 百万级轻量资源管理：为每个会话创建专属的“私有通道”，支撑海量并发
• 会话状态持久化：消息持久化存储，进程重启不丢会话
• 断点续传：应用重启后可从断点精确恢复会话，实现无缝续聊
• 顺序保障：严格保证消息顺序，确保上下文连贯性

06 可视化调试：AgentScope Studio

开发Agent最头疼的是什么？调试！

传统Agent运行过程不可见，出了问题只能靠猜。

AgentScope Studio提供了可视化调试平台：

# 安装Studionpm install -g @agentscope/studio# 启动as_studio

在代码中连接Studio：

agentscope.init(    modelConfigs = "config.json",    studioUrl = "http://localhost:3000"// 连接Studio);

Studio的功能：

• 实时对话：像聊天一样与Agent交互
• 过程观测：看到Agent的思考过程、工具调用、中间结果
• 请求追踪：观测与LLM的每一次请求，监控Token消耗
• 断点调试：可暂停Agent执行，查看当前状态，甚至修改后恢复

07 与其他Java AI框架对比

当前Java生态中，AI Agent框架主要有三个选择：LangChain4j、Spring AI和AgentScope Java。

它们该怎么选？我用一张表说清楚：

一句话总结：

• LangChain4j：适合做PoC，快速验证想法
• Spring AI：适合标准化集成，用Spring的方式接入AI
• AgentScope Java：适合上生产，尤其是金融、电商、政务等高要求场景

08 生态集成：与阿里云产品矩阵深度协同

作为阿里系产品，AgentScope Java与阿里云生态无缝集成：

• 百炼平台：Agent开发完成后，可通过runtime-fc-deploy一键部署到百炼，获得在线观测、调试、版本管理能力
• 函数计算：联合JVM团队适配GraalVM，实现Agent 200ms内冷启动，为Serverless弹性奠定基础
• Nacos：Agent可像微服务一样注册到Nacos，实现服务发现
• Higress AI网关：统一的流量入口，支持A/B测试、可观测集成

09 选型指南

根据上面的分析，我给出以下建议：

适合用AgentScope Java的场景

1. 金融、政务、电商等核心业务系统：对安全、可靠性要求极高
2. 需要多智能体协作：如客服+风控+财务的联合处理流程
3. Java技术栈为主：希望深度集成Spring Cloud生态
4. 工具数量庞大（几十上百个）：需要ToolGroup进行管理
5. 需要人工介入：高风险操作需审批才能执行

可以先考虑LangChain4j的场景

1. 快速验证概念（POC）：先跑通流程再决定
2. 项目非Spring技术栈：Quarkus、Micronaut等

可以先考虑Spring AI的场景

1. 只需要基础对话功能：不需要复杂智能体
2. 希望用最“Spring”的方式：追求标准化

总结

AgentScope Java是阿里巴巴送给Java开发者的一份“厚礼”。

它没有走Python框架的老路，而是从零开始，为企业级Java应用量身打造了一套完整的智能体开发解决方案。

它的核心价值可以概括为三点：

1. 让Java开发者用熟悉的方式构建智能体——Spring Boot集成、声明式编程、依赖注入，都是Java人最舒服的开发模式。
2. 让智能体能安全地接入核心业务系统——安全沙箱、权限控制、可观测调试，真正做到了“生产就绪”。
3. 让多智能体能像微服务一样协作——A2A协议+RocketMQ，构建企业级高可靠的通信基座。

有些小伙伴可能会问：“现在学AgentScope Java，会不会太早？”

我的看法恰恰相反：现在正是上车的最佳时机。

框架刚发布1.0版本，社区正在快速成长，这时候入局，你就是这个领域的先行者。

等到几年后Agent成为企业标配时，你已经积累了宝贵的实战经验。

技术浪潮一波接一波，Java开发者不能再做“旁观者”了。

AgentScope Java给了我们一把利器，接下来就看我们怎么用了。

开源地址：

• GitHub：https://github.com/agentscope/agentscope-java
• 官方文档：https://agentscope.io/docs/java

如果你在学习和使用过程中有任何心得或困惑，欢迎在评论区留言，我们一起探讨这个智能编程的新时代。

END
  推荐阅读：