## 目标与基线 已有 Studio/A2A 接入,但 HTTP、WebSocket、IM/Webhook 等入口尚缺共同的消息到会话命令映射边界。本单负责渠道适配,不再管理一套运行状态。 ARGI Core `76d44429fdaa6a69320e21a1cb77119d0889d792` / Extensions `495414b76a37aca4d7c1022d973a8e5b9a7e92e6`;AgentScope Java 参考 `7976a20d7c59f535737f2df1b16a2bc24051575a`。本单来自源码/文档对照,是能力建设建议,不是已复现的生产 BUG 或已完成的功能。 参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/docs/v2/en/docs/harness/channel.md 建议阶段:后续增强。 ## 范围与验收 - [ ] 建立渠道输入/输出封装,统一外部消息身份、附件引用、回复地址、Agent 目标和会话定位;入口复用 Core agentic-ai-java/argi#235 的受理与排队。 - [ ] 渠道凭证/验签结果映射为可信身份,租户或用户 ID 不能仅从普通消息属性自报;外部渠道会话与内部 run/session 的对应可诊断。 - [ ] 外部重复消息、重试回调和回复重试具有稳定幂等语义;同会话并发策略由统一运行服务承担,不在各渠道重复调度。 - [ ] 先提供一个实际需要的参考入口与可配置路由,按需求增加 IM 供应商;渠道配置可由既有能力包装配,不要求用户修改宿主源码。 - [ ] 验证重复/乱序投递、身份冲突、跨渠道隔离、断连、回复失败、附件访问和关闭资源所有权;A2A 的既有修复单独推进。 ## 关联与实现边界 本仓 #25/#26;Core agentic-ai-java/argi#202、agentic-ai-java/argi#235、agentic-ai-java/argi#236。不新增平台级控制平面。 复用已有定义、运行身份、日志、预算、授权及存储契约,不新建竞争的数据权威来源。独立 Agent/Workflow 不依赖 Graph/Loop;第三方协议、客户端 SDK 与外部后端留可选适配侧,Core 不导入 AgentScope SDK 或 Extensions。逻辑职责不自动对应新增 Maven 模块。先以模型无关/参考后端验证,再按范围给出真实服务或跨实例证据。破坏性变更需比较兼容方案,说明收益、消费者影响、目标版本与迁移/回滚;不因参考项目采用某设计而机械照搬。
Activity