Java知识体系

Appearance

AgentScope Java

知识点清单 ​

  • [ ] AgentScope Java 是什么？与 Spring AI Alibaba 的关系？
  • [ ] ReAct 范式（Reasoning + Acting）的基本原理
  • [ ] 多智能体协作模式（Pipeline / Routing / Supervisor / Handoff 等）
  • [ ] 企业级安全沙箱机制
  • [ ] MCP 协议与 A2A 协议集成
  • [ ] 基于 Project Reactor 的响应式架构
  • [ ] 实时人工介入（interrupt）

笔记 ​

一、定位 ​

AgentScope Java 是阿里巴巴通义实验室开源的 企业级多智能体（Multi-Agent）开发框架，专为 Java 生态设计，面向生产级 AI 智能体应用。

核心设计目标：让 Java 开发者无需学习 Python，即可构建高可靠、高安全、可运维的智能体系统。

与 Spring AI Alibaba 的关系：

  • AgentScope Java = 底层 Agent 运行时引擎（ReAct 推理、安全沙箱、多智能体协作）
  • Spring AI Alibaba = 上层应用框架（Spring 集成、声明式注解、阿里云生态）
  • Spring AI Alibaba v1.1.2.2 已深度集成 AgentScope Java 作为多智能体底层引擎

二、ReAct 范式 ​

AgentScope Java 采用 ReAct（Reasoning + Acting） 模式，Agent 自主执行以下循环：

思考 (Think) → 行动 (Act) → 观察 (Observe) → 反思 (Reflect) → 思考...

相比传统 Workflow（固定流程），ReAct 赋予 LLM 自主控制权，能处理未知的复杂场景：

java
ReActAgent agent = ReActAgent.builder()
    .name("Assistant")
    .sysPrompt("你是一个有帮助的 AI 助手。")
    .model(DashScopeChatModel.builder()
        .apiKey(System.getenv("DASHSCOPE_API_KEY"))
        .modelName("qwen-max")
        .build())
    .tools(new SearchTool(), new CalculatorTool())
    .build();

// 阻塞等待结果
Msg response = agent.call(Msg.builder()
    .textContent("帮我查一下今天北京天气，并计算 35 * 128")
    .build()).block();

三、多智能体协作模式（7 种） ​

框架内置 7 种开箱即用的多智能体模式：

模式说明适用场景
Pipeline顺序/并行/循环执行多个 Agent数据处理流水线
Routing分类 → 专家 → 汇总工单路由分发
Skills按需加载技能模块动态能力扩展
Subagents父 Agent 将子任务委派给子 Agent复杂任务拆解
Supervisor监督者编排多个专家 Agent协同决策
Handoffs状态驱动的智能体间交接多轮对话流转
Custom Workflow基于 StateGraph 自定义编排灵活定制场景

四、企业级安全沙箱 ​

企业场景的核心需求——安全执行不可信代码：

  • 文件系统隔离：限制 Agent 可访问的目录范围
  • 网络白名单：控制 Agent 的网络访问权限
  • Docker 容器执行：高危脚本在隔离容器中运行
  • 内置：GUI 沙箱、文件系统沙箱、移动端沙箱

五、协议化集成 ​

MCP 协议：现有 HTTP 业务系统无需修改即可被 Agent 调用。

A2A 协议：Agent 能力注册到 Nacos，像调用微服务一样发现和调用其他 Agent。

RocketMQ 集成：百万级轻量资源管理、会话持久化、断点续传。

六、高性能特性 ​

  • 基于 Project Reactor 响应式架构，全异步非阻塞
  • 联合 Dragonwell / GraalVM，冷启动 < 200ms
  • 支持 Serverless 毫秒级弹性伸缩

七、实时人工介入 ​

支持 interrupt() 方法在 Agent 执行过程中暂停并等待人工决策：

java
agent.interrupt();
// Agent 暂停，等待人工输入后继续

八、框架对比 ​

维度AgentScope JavaLangChain4jSpring AI
定位企业级生产部署快速原型/实验标准化抽象
多智能体原生 7 种模式有限支持需额外实现
安全沙箱内置无无
实时介入interrupt()无无
适用场景金融/电商/政务Demo/POC标准化集成

九、快速开始 ​

xml
<dependency>
    <groupId>io.agentscope</groupId>
    <artifactId>agentscope</artifactId>
    <version>1.0.10</version>
</dependency>
java
ReActAgent agent = ReActAgent.builder()
    .name("MyAgent")
    .sysPrompt("You are a helpful assistant.")
    .model(new DashScopeChatModel(apiKey, "qwen-max"))
    .build();

Msg response = agent.call(
    Msg.builder().textContent("Hello!").build()
).block();