// 创建运行时实例
AgentRuntime runtime = AgentRuntime.builder
        .agent
        .build;
// 异步执行
CompletableFuture future = runtime.executeAsync;
// 判断是否需要强制终止
if ) {
    runtime.interrupt;                 // 马上停止
    AgentState snapshot = runtime.saveState; // 保存现场，可恢复
}

安全中断：任何异常或偏离预期时douNeng立即切断执行并保留上下文。

灵活定制：开发者Ke以注入自定义拦截器，实现细粒度治理。

@Configuration
public class SandboxConfig {
    @Bean
    public Sandbox sandbox {
        return Sandbox.builder
                .fileSystem
                        .allowedPaths
                        .readOnly
                        .build)
                .network
                        .whitelist
                        .build)
                .docker
                        .memoryLimit
                        .cpuLimit
                        .build)
                .build;
    }
}

通过上述配置，即便 Agent 调用了外部资源，也只Neng在白名单范围内活动，大幅降低泄漏风险。

@Service
public class MultiAgentService {
    @Autowired private AgentClient agentClient;
    public String handleRefund {
        // 风险评估
        RiskAssessmentAgent risk = agentClient.find;
        if ) {
            return "退款申请Yi被风控拦截";
        }
        // 财务退款
        FinanceAgent finance = agentClient.find;
        String result = finance.refund;
        // 通知用户
        NotificationAgent notify = agentClient.find;
        notify.sendRefundSuccess;
        return result;
    }
}

A2A 把每个智Neng体当成微服务，让它们之间像 RPC 那样自然交互，同时借助 RocketMQ 的高可靠传输保证消息不丢失。

# 安装 Studio 客户端
npm install -g @agentscope/studio
# 启动调试平台
as_studio --port 8088

在代码里注入 Studio 地址后就Neng在浏览器kan到每一次「思考—行动」的链路图，配合日志自动跳转，让 Debug 从“盲盒”变成“一键定位”。

    io.agentscope
    agentscope-spring-boot-starter
    1.0.0

agentscope:
  core:
    model:
      dashscope:
        api-key: ${DASHSCOPE_API_KEY}
        model-name: qwen-plus
  agent:
    max-steps: 10               # Zui大思考次数，可根据业务调优
  sandbox:
    enabled: true               # 开启安全沙箱防护

@AgentComponent
public class OrderAssistant {
    @Autowired private OrderService orderService;
    @Autowired private RefundService refundService;
    /** 根据订单号返回当前状态 */
    @Tool
    public String queryOrderStatus {
        Order o = orderService.findByOrderId;
        return o == null ?
                "未找到对应订单" :
                String.format("状态：%s，金额：%s 元，下单时间：%s",
                              o.getStatus, o.getAmount, o.getCreateTime);
   }
   /** 执行退款，需要进行权限校验 */
   @Tool
   public String executeRefund {
       boolean ok = refundService.processRefund;
       return ok ? "退款成功" : "退款失败";
   }
}

@RestController
public class ChatController {
   @Autowired private AgentRuntime runtime;
   @PostMapping
   public String chat {
       AgentResponse resp = runtime.execute;
       return resp.getFinalAnswer;
   }
}