Skip to content

[Feature] 在统一运行服务上提供持久会话提交与运行中补充命令 #235

Open

Description

@Aias00

目标、依据与优先级

已有 RunStore、固定版本、租约和持久 runner 规划。本单补应用侧会话命令入口,明确提交、观察和执行的区别,复用 #124 而不是另起 Session 数据权威体系。

建议阶段:第二阶段,依赖持久 runner 的实际接入。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

范围与验收

  • 定义并实现 submit、steer、inject、respond、resume/cancel 或等价命令,各自有目标身份、幂等键、版本与接受/拒绝语义。
  • submit 持久受理后返回凭证;明确接受、排队与执行状态,并限制排队容量。正在运行、等待审批和等待子任务的队列推进规则清晰。
  • steer 绑定指定 task/run,在安全推理边界应用;目标过期时拒绝,不能误作用于更新任务。inject 只保存参考材料,不隐式启动推理或提升为指令。
  • 观察/await/SSE 不启动执行,断开观察不等同取消;直接调用与托管队列的同会话并发规则可诊断。
  • 审批与 resume 复用 [P2B][T23] 定义持久化审批与幂等 resume 的 HITL 集成契约 #130;存储准入、租约、模型日志和效果回执复用 [P1B][T10] 增加整 Run 持久化执行器与租约作用域接入 #124—[P1C][T17] 增加持久化重试、deadline 与恢复预算记账 #127,命令只在对应提交边界后标记已应用。
  • 用参考存储先验证重复提交、乱序/过期命令、取消、排队满载;真实后端验证接受后崩溃、应用后确认前崩溃和多实例接管。
  • 关闭调用对象不能误关闭共享运行服务;业务入口和 Studio 使用相同服务,缺少 durable 能力必须明确报告。

归属、依赖与约束

关联:#124、#125、#126、#127、#128、#130、#188、#200、#204。本单作为具体交付任务,相关总单继续负责总体契约,不重复实现其存储、预算、授权或版本注册体系。

独立 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