SuperAPI AI 工具集

session-inherit

智能体与模型

查看项目

更新于 10-16 00:30

技能介绍

用途:让 worker 智能体加入 leader 已打开的活跃上下文会话,实现多智能体工作流中的会话继承与 token 用量统计。

主要能力:调用 sessionQuery({ activeOnly: true, limit: 50 }) 查询活跃会话,可选按 storyId 缩小范围;在客户端按 sessionId 过滤匹配会话;输出 SESSION INHERITED 或 SESSION NOT FOUND;通过 sessionUpdate 以 mode: 'incremental' 上报增量 token 用量。

使用方式:命令为 /session-inherit,可选参数 storyId=WINT-1234。注意 sessionId 不是 SessionQueryInputSchema 的有效过滤字段,传入会触发 Zod 校验错误,必须先在客户端过滤。sessionUpdate 必须使用 incremental 模式(并发安全),禁止使用 absolute。worker 禁止调用 sessionComplete,该操作仅限打开会话的 leader。

适用场景:由 leader 派生多个 worker 的多智能体协作流程,需要统一追踪会话与 token 消耗时。

限制:会话继承纯属遥测,不得阻塞或门控工作流。若查询为空、工具不可用、无匹配会话、数据库不可用或 sessionUpdate 失败,应记录警告并继续正常工作。会话清理 sessionCleanup({ retentionDays: 90 }) 标注为未来功能(WINT-2100)。