Skip to content

[Feature] 将中立 Agent 执行事件适配为 AG-UI 协议 #59

Open

Description

@Aias00

目标与基线

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

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