主题
组织运行时设计:Team 纳管 / 编排对接 / 组织记忆与治理
一句话:组织化不再造另一套运行时:Team、Workflow、Issue 与记忆直接用 agentscope-service 原生能力,平台只补 DSL 入口、预算聚合视图、失败重放三件薄活,拒绝双源换来的是权威唯一;约束同样由原生语义给定——Run 快照固定协作配置、checkpoint 不套用于所有成员、团队预算耗尽即拒绝后续 turn,没有“平台包一层放行”的旁路。
主线:开源生态企业智能体平台 · 批次合缝批 5(组织化 P1 启动,2026-10-25) 依据:agentscope-service 原生能力源码级复核(24 篇 §6.5.6–6.5.8)+ 47 文档 §三/§七/§8.2 批 5 选型:以 agentscope-service 原生 Team/Workflow/编排/Issue/Memory 对齐,企业多智能体平台 CRD 与 TeamHarness 保留远期参考,不引入
一、对齐基线(原生能力,源码/官方 v2 文档坐实)
| 能力 | 原生实现 | 证据 |
|---|---|---|
| Team 模型 | Leader(leaderAgentId)+ 成员(agentId + role + instructions)+ 策略(policy:并发/委派/验收);Run 固定协作快照;控制面建 coordinator node + 初始 Leader 任务 | create-team.md、/api/v1/teams、team-configuration.md |
| 协作载体 | Issue / Comment / Artifact / child Issue(拆子目标);不依赖进程内消息 | create-team.md |
| 任务协议 | /api/v1/agent-tasks/{taskId} 下 context / progress / complete / fail(expectedVersion 乐观锁 + 任务凭据,业务用户 token 不能冒充执行中任务);coordinator 权限与普通成员分离 | create-team.md |
| 编排 | Subagent / Team / Workflow 三形态;Workflow = 依赖/分支/人工审批的执行图,节点可调 Agent 或 Team;orchestration-runs pause/resume/cancel | orchestration.md、workflows.md |
| 记忆 | builder_memory/builder_memory_version/builder_memory_store(owner_id 隔离、版本链、head_version) | §6.5.6 |
| 预算 | Application maxConcurrent/tokenBudget + Session timeoutSeconds/budget.maxTokens | service-api.md |
| 授权 | 用户组(groups:members+roles)管授权,Team 编排 Agent——两个概念分离 | access.md |
二、G5 Team 纳管(原生对齐 + 平台补)
结论:不再双源,以 agentscope-service 原生 Team 为准。
- 对齐面:Leader/成员角色/指令/策略、Run 快照(追查当时配置)、coordinator node、任务协议(expectedVersion + 任务凭据)、Issue 协作、用户组授权分离——全部直用原生,不另建 Team 表;
- 平台补 1(Team DSL 生成入口):业务侧用结构化配置(
{leader, members[], policy})生成/api/v1/teams请求;主 Agent 按任务目标建议团队构成; - 平台补 2(团队预算级联):团队运行预算 = 聚合成员 Agent 的 Application tokenBudget + Session budget;预算耗尽拒绝后续 Turn(原生
maxConcurrent/tokenBudget语义,平台做团队级聚合视图); - 边界:Team 任务执行 ≠ Managed Agent 可恢复会话——checkpoint/文件会话接口不套用于所有成员(原生明示)。
三、G6 编排对接(原生对齐 + 平台补)
结论:复用原生编排运行时(Subagent/Team/Workflow + orchestration-runs)。
- 对齐面:Workflow 执行图(节点/依赖/分支/人工审批)、节点调 Agent/Team、pause/resume/cancel、run 生命周期——直用原生;
- 平台补 1(Workflow DSL 生成入口):主 Agent 按任务生成 Workflow 定义(固定步骤走 Workflow、动态协作嵌入 Team 节点);
- 平台补 2(失败重放):节点失败按 orchestration-runs 恢复语义重放(提交幂等键复用 G12 契约);
- 边界:固定顺序/条件/汇合规则用 Workflow;动态协作用 Team——选型由主 Agent 生成时决定。
四、G7 组织记忆与治理(平台设计,落新篇)
| 治理面 | 设计 | 原生支撑 |
|---|---|---|
| 组织级记忆版本化 | 复用 memory_store/memory_version 机制,组织维以 owner_id(团队/命名空间)隔离;组织记忆 = 团队运行结论、协作记录摘要 | builder_memory 版本链(§6.5.6 已对齐) |
| 目标树 | goal → 子目标 → 任务:用 child Issue 原生层级表达;Issue ContextRefs 挂接相关记忆/产物引用 | create-team.md child Issue + Issue 引用 |
| 团队预算 | 团队级 Budget Lease:聚合成员 Application tokenBudget + Session budget,耗尽拒绝后续提交;预算指标入账审计 | Application tokenBudget + Session budget(原生) |
| 绩效评测 | 评测粒度到团队/角色:复用 26 篇评估器(Evaluator)+ opt.trajectory(补 team_id/role 字段),Team Run 产出可评样本 | 26 篇 §五 评估器 + opt schema 扩展 |
| 治理指标 | 团队 Run 成功率/成员贡献/审批时效/预算消耗率入账(agent_task_event 复用),治理看板可审计 | 22 篇事件账本 + 26 篇门禁 |
验收判据:目标树经 child Issue 可分解可追查;组织记忆版本化可回滚;团队预算聚合生效且耗尽拒绝;评测到团队/角色;治理指标全程可审计。
五、与现有组件的合缝
| 接缝 | 交界 | 权威 | 失败语义 |
|---|---|---|---|
平台 → /api/v1/teams | Team DSL → 原生 Team 定义 | agentscope-service | 创建失败 → 明确报错,不静默 |
| 平台 → orchestration-runs | Workflow 定义/run 控制 | agentscope-service | pause/resume 失败 → 以 run 状态为准重查 |
| 平台 → agent-tasks 协议 | 任务凭据/expectedVersion | 控制面 | 版本不符 → 冲突提示(乐观锁) |
| 平台 → Issue 层级 | child Issue + ContextRefs | 控制面 | 引用失效 → 标待确认 |
| 平台 → 预算 | 团队聚合 = Application+Session | 计量服务 | 预算耗尽 → 拒绝提交(原生语义) |
| 平台 → opt 轨迹 | 补 team_id/role 字段 | opt schema | 缺字段 → 样本标 partial |
六、阶段边界(沿用 §8.3 更新)
- 不引入 TeamHarness 状态机/事件对齐;企业多智能体平台 CRD 保持远期参考;
- 组织化实施顺序:G5 Team 纳管 → G6 编排对接 → G7 记忆治理(本篇);
- 与链路 5/6(多 Agent 同机/跨端)合缝:链路 5 走 Subagent + Team 节点,链路 6 走 A2A + Workflow 节点,均复用本设计。