Skip to content

v2.0.0 — AgentScope 2.0 GA 全面迁移 + 客服后台管理系统上线

Choose a tag to compare

@liulangjietou liulangjietou released this 14 Jul 05:53
· 373 commits to main since this release
v2.0.0
e61ec3c

概览

main 分支完成从 AgentScope Java 1.0.12 → 2.0.0 GA 的全量迁移,同时首次上线独立的客服后台运营管理系统(customer-admin-server + customer-admin-web),并对生产可观测性、安全与数据一致性做了系统性加固。全仓测试 576 个,全部通过(starter 367 + app 13 + downstream 1 + customer-web 8 + customer-admin-server 187)。

⚠️ Breaking Changes / 升级须知

  • 内置模型实现拆分为独立扩展模块:包名 io.agentscope.core.model.*io.agentscope.extensions.model.{provider}.*(Builder API 本身不变)
  • 需要 JDK 17(原 1.0.12 为 JDK 8/11)
  • 历史版本存档:legacy-main-1.0.12 标签为 1.0.12 最后状态;rc2.0/ga2.0 分支为迁移历史存档,均不再更新
  • TTS(TTSHook/DashScopeRealtimeTTSModel)、PlanNotebookPipelinesSessionManager/StateModule 已随框架移除,详见 docs/MIGRATION-2.0.md

框架升级:AgentScope Java 2.0.0 GA

  • 会话持久化模型重构:SessionAgentStateStore,Agent 改为无状态、按 (userId, sessionId) 自动加载/持久化
  • 新增框架能力:Permission System、Plan Mode、Compaction、Workspace/Sandbox(local/docker)、Subagent、五段式 Middleware
  • 顺带修复两处历史 bug:JDBC 字符集参数错误导致连接失败、审计查询 SQL ESCAPE 转义错误吞掉分页参数
  • 对 29 个既往引用的框架 issue 全量重新核对,确认 3 个已在 GA 修复;新发现 3 条后续风险持续跟踪

新增:客服后台运营管理系统(customer-admin-server / customer-admin-web)

  • RBAC 权限体系(用户/角色/权限树/操作日志)+ Sa-Token 鉴权,LDAP/AD 单点登录
  • AI 配置域三个 CRUD:模型(连通性测试 + AES 加密存储)/ MCP(stdio/sse/http)/ Skill(支持 SKILL.md、zip 上传)
  • 智能体管理:动态运行时装配 + 动态菜单聚合 + 实例缓存
  • Chat / VibeCoding 工作区:流式对话、思考过程折叠展示、历史记录持久化(MySQL + Redis 读缓存)
  • VibeCoding Git 助手 + AgentScope 2.0 代码沙箱(local/docker 两种隔离模式)
  • AI 编码操作审计日志:VibeCoding 流式对话、文件保存、Git 助手三件套等全部 AI 编码操作纳入审计(操作人/agentCode/sessionId/变更文件/token 用量/耗时/结果),落库 ai_coding_audit_log 表,配套查询接口与前端审计列表页

新增:客服业务能力增强

  • 多 Agent 编排:智能路由 + 规则快车道 + 真并行 fanout + reduce 归纳合成
  • 多轮槽位收集(退款表单)+ 人工审批闭环(HITL),对话阶段状态机 + 动态 Prompt
  • 业务旅程补全:售前导购 / 售中 / 会员账户 / 投诉工单 / 主动服务 / 坐席辅助 / 会话质检
  • 自动化意图评测框架 + LLM-as-Judge 回复质量评测
  • 入站防注入围栏 + 用户消息级反馈闭环(点赞/点踩)

新增:五套官方前端接入(customer-web)

Admin 管理控制台、Chat Completions(OpenAI 兼容)、AG-UI 富事件协议、Studio 观测台、Channel(钉钉 / 飞书 / 企业微信)

生产可观测性与加固

  • 全链路日志关联(MDC 贯穿 + W3C traceId)、慢请求/异常请求留证、会话故障诊断聚合 API
  • 合成监控主动探活、SLA 升级引擎、业务数据分析报表
  • 限流滑动窗口算法、模型成本熔断
  • 审批工单 / 槽位收集 / 对话阶段状态支持多实例部署持久化(JDBC Store SPI,共 5 处套用)

安全

  • 审批放行端点新增操作员身份鉴权 + 决策审计留痕(此前任意持有 API Key 的调用方可冒充坐席放行退款)
  • 硬编码密钥全部改为环境变量注入

修复

  • 审批放行后下游执行失败不再静默丢失(新增补偿重试)
  • MCP 连通性测试两处 bug:不识别 mcpServers 包装格式、缺少 initialize() 握手
  • Vue Router 深链接直接刷新必现 404
  • 模型连通性测试结果在非 Servlet 线程回调中因 Sa-Token 审计填充崩溃导致落库失败

测试

全仓 576 个测试全部通过(starter 367 + app 13 + downstream 1 + customer-web 8 + customer-admin-server 187)

文档

新增《生产部署手册》《生产接口使用手册》《生产就绪评估》《AI编码助手需求文档》;README / 详细技术文档 / MIGRATION-2.0 全面同步至 2.0 版本

Full Changelog: legacy-main-1.0.12...main