## 目标与基线 Core agentic-ai-java/argi#236 负责内部事件与可恢复运行视图;本单增加标准前端协议适配,允许业务前端消费中立 Agent,而非绑定 Studio 的 Graph DTO。 ARGI Core `76d44429fdaa6a69320e21a1cb77119d0889d792` / Extensions `495414b76a37aca4d7c1022d973a8e5b9a7e92e6`;AgentScope Java 参考 `7976a20d7c59f535737f2df1b16a2bc24051575a`。本单来自源码/文档对照,是能力建设建议,不是已复现的生产 BUG 或已完成的功能。 参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/docs/v2/en/integration/protocol/agui.md 建议阶段:后续增强。 ## 范围与验收 - [ ] 定义中立请求、消息、工具事件、usage、交互请求和终态到 AG-UI 的映射,保留稳定运行/消息/工具身份。 - [ ] 明确内部 live event、持久游标和 AG-UI 状态事件的区别;不把协议支持声明为所有执行器都支持恢复。 - [ ] 运行成功与失败终态一致,错误后不再无条件成功结束;订阅取消是否取消执行按直接调用/后台观察模式区分。 - [ ] 输入和输出多模态支持逐项声明;不支持内容需明确拒绝或显式降级,不能在另一事件中泄露已经拒绝的敏感原文。 - [ ] 以 stub Agent 验证顺序、工具配对、多工具结果、异常/取消、HITL、重连和背压;SDK/Boot 装配保持可选,不复制第二套 Agent runner。 ## 关联与实现边界 Core agentic-ai-java/argi#204、agentic-ai-java/argi#209、agentic-ai-java/argi#235、agentic-ai-java/argi#236。协议适配与 Channel 路由分别交付。 复用已有定义、运行身份、日志、预算、授权及存储契约,不新建竞争的数据权威来源。独立 Agent/Workflow 不依赖 Graph/Loop;第三方协议、客户端 SDK 与外部后端留可选适配侧,Core 不导入 AgentScope SDK 或 Extensions。逻辑职责不自动对应新增 Maven 模块。先以模型无关/参考后端验证,再按范围给出真实服务或跨实例证据。破坏性变更需比较兼容方案,说明收益、消费者影响、目标版本与迁移/回滚;不因参考项目采用某设计而机械照搬。
Activity