Skip to content

[Feature] 完善中立执行事件及可恢复的前端运行视图 #236

Open

Description

@Aias00

目标、依据与优先级

argi-agent-api 已有消息、进度、用量及 Finished 事件;Studio 仍依赖 Graph 输出。本单补必要的类型化生命周期与视图投影,不把实时通知等同持久事实。

建议阶段:优先设计事件边界;持久视图随运行服务交付。AgentScope Java 参考基线 7976a20d7c59f535737f2df1b16a2bc24051575a,ARGI Core 76d44429fdaa6a69320e21a1cb77119d0889d792 / Extensions 495414b76a37aca4d7c1022d973a8e5b9a7e92e6。本单是能力落地建议,来源于源码与文档对照,并非已复现的 BUG 或已完成实现。

参考:https://github.com/agentscope-ai/agentscope-java/blob/7976a20d7c59f535737f2df1b16a2bc24051575a/docs/v2/en/docs/harness/session-log.md

范围与验收

  • 在已有 AgentEvent 上论证工具开始/结果/失败、交互请求/决议、委派及运行状态所需事件;不机械复制 32 个类型或全量 Graph NodeOutput。
  • 明确 run/task/attempt/message/tool/delegation ID、顺序、版本和 usage 语义,保持已有终态与异常契约;sealed API 扩展需评估消费者兼容。
  • 分别定义实时通知、持久执行事实和 UI 投影,实时事件不得充当提交确认,seq/cursor 不混用,不再建立第二份权威运行日志。
  • 快照与其游标来自一致提交前缀;重连从已应用游标继续,按稳定 ID 更新,避免消息重复或缺失。
  • 页面重载/观察事件不能重新执行 Agent;部分消息、工具进度和 pending interaction 可恢复显示。
  • 不支持持久事件的执行器明确声明能力,不能伪造可恢复游标;订阅背压与终态错误不被吞并。
  • 覆盖重复/乱序投递、快照与新增提交竞态、游标失效、断线、取消及敏感数据可见范围。

归属、依赖与约束

关联:#200、#203、#204;agentic-ai-java/argi-extensions#17。本单作为具体交付任务,相关总单继续负责总体契约,不重复实现其存储、预算、授权或版本注册体系。

独立 ReAct / Workflow 消费中立契约,不以 Graph/Loop 为执行后端。Loop 为可选图编排能力。Core 不依赖 Extensions 或 AgentScope SDK;复用现有组件,不因职责分层机械新增 Maven 模块。定义、数据或公共 API 的破坏性变更需比较兼容方案,并说明收益、消费者影响、目标版本、迁移与回滚;保留合理现有实现。不以直接复制 AgentScope 类或引入整套平台作为验收。

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