Skip to content

[Feature] 增加消费中立运行服务的 Channel 接入与会话路由 #58

Open

Description

@Aias00

目标与基线

已有 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 [Feature] 在统一运行服务上提供持久会话提交与运行中补充命令 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions