v2.0.0 — AgentScope 2.0 GA 全面迁移 + 客服后台管理系统上线
概览
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)、PlanNotebook、Pipelines、SessionManager/StateModule已随框架移除,详见 docs/MIGRATION-2.0.md
框架升级:AgentScope Java 2.0.0 GA
- 会话持久化模型重构:
Session→AgentStateStore,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