主题
能力全景与接线计划:从六链路到智能组织
一句话:平台使用层(六链路,D1–D4)全面支持、反馈层(D5)骨架闭合缺画像蒸馏、组织化(D6)是真实缺口区;补 8 项设计后,平台能承载"任务执行 → 团队协作 → 智能组织"的完整能力价值。
本文定位:先定能力方向(三个模型),再列能力全景(八域 44 项)与接线状态(对照开源组件源码与 00–26 篇),最后给缺口台账(G1–G12)与技术选型总览(§七,持续更新)。接线证据以 24 篇 §6.5 源码合缝复核为准;行业参照来自 2026-10 可查证的产品形态。
〇、三个能力方向(来源与本轮讨论的关系)
| 方向 | 内容 | 来源 |
|---|---|---|
| 方向一 | 六链路运行态谱系(R1–R5 分级 + 三质变点) | 用户提出的使用层六链路,本文件收敛为统一运行态控制器 |
| 方向二 | 平台完整闭环(前向六链路 + 后置反馈管线) | 用户提出的后置操作:记忆偏好蒸馏 + 数据飞轮 |
| 方向三 | 多 Agent 组织化演化(任务组织 → 团队组织 → 智能组织) | 结合 Codex、豆包工作、Anthropic Swarm 的行业实践推演 |
承载判定(先给出结论):
| 层 | 支持度 | 判定 |
|---|---|---|
| 使用层 D1–D4(六链路) | 17/18 | ✅ 全面支持 |
| 反馈层 D5(记忆与飞轮) | 7/8 | 🟡 仅剩 mem0 API 逐类验证(G8) |
| 组织层 D6(组织化) | 1/6 | 🔧 主要缺口区,需 Team/DSL/组织记忆/治理四项设计 |
| 底座 D7 | 7/8 | 🟡 运行态分级需矩阵化 |
| 补充场景 D8 | 0/4 | 🔧 架构走通 4/4,合缝缺口 4 项(G9–G12) |
一、方向一:六链路运行态谱系
1.1 六链路(用户使用层)
统一用四问审视每条链路:执行态占什么资源、状态权威在哪、隔离边界在哪、挂掉怎么恢复。
| # | 链路 | 执行态资源 | 状态权威 | 隔离边界 | 恢复方式 |
|---|---|---|---|---|---|
| 1 | 纯 Chat | 模型连接池(共享) | 会话历史(DB/内存) | 会话(SESSION scope) | 会话 ID 重放历史 |
| 2 | Chat + 工具 | 共享进程 + 工具连接(共享) | 会话历史 + 工具结果内嵌消息 | 会话 + 工具准入策略 | 历史含工具结果,直接继续 |
| 3 | 技能包/脚本 | 隔离工作区 + 进程(质变) | 工作区快照 + 状态外置 | 租户/会话级工作区 | 快照恢复(Fork/Reset) |
| 4 | 个人工作助手 | 独享运行态 | 会话 + 助手状态(快照) | 独享实例 + 本人身份 | 闲置回收 → 快照 → 冷/热恢复 |
| 5 | 多 Agent 同机写作 | 主工作区 + 子进程(文件共享) | 共享工作区 + 子任务账本 | 子任务权限收窄 | 子任务重跑 + join |
| 6 | 多 Agent 跨端 | 各自终端实例 | 协议消息(权威移出进程) | 终端隔离、网络交互 | 协议幂等重放 |
1.2 五点关键结论(对朴素理解的修正)
- 1→2→3 是连续谱系,不是离散档位:判断标准是"是否存在需要持久化的非消息类产物"。搜索返回文本 → 链路 2;返回下载文件 → 已滑向链路 3。链路 1/2"执行资源共享"成立的前提是零文件副作用,此前提必须写进运行态判定规则。
- 链路 3 的质变点是"脚本执行",不是"技能包":Skill 分纯提示词/模板(可留链路 2 共享态)与带脚本/依赖(必须进工作区)。Skill Loader 按"是否声明脚本"分级,不能一律强制沙箱。
- 链路 4 独享 ≠ 常驻:正确形态是 serverless 化——按需拉起 + 闲置快照回收 + 事件唤醒。独享的是身份/凭据/偏好,不是进程。回收是资产回收(快照落盘 + 释放容器),不是删状态。与十条原子规则第 5 条"等待释放计算"一致。
- 链路 5 的关键是"共享但权限收窄":subagent 能读主工作区是能力,写权限必须按委派范围收窄(子任务只写自己的子目录)。源码坐实
SubagentSpec.WorkspaceMode ∈ {isolated, shared},平台默认shared + scope 收窄。 - 链路 6 的本质是"状态权威从进程内移到协议上":跨端协作的交互内容 = A2A 消息,双方各自维护账本,靠消息幂等 + 版本对齐。落在 Nacos 原生
AgentCard(§6.5.3 已坐实)+ 四通信面协作面。
1.3 运行态分级(RuntimeClass,统一原语)
六条链路不是六种实现,而是同一个运行态控制器的五个等级配置:
| 等级 | 链路 | 资源语义 | 隔离 | 回收策略 |
|---|---|---|---|---|
R1 shared | 1/2 | 共享进程、无持久工作区 | 会话 | 不回收(连接池复用) |
R2 workspace | 3 | 隔离工作区 + 进程 | 租户/会话 | 会话结束即回收,快照可选 |
R3 dedicated | 4 | 独享实例 | 身份 + 实例 | 闲置检测 → 快照 → 释放 → 冷/热恢复 |
R4 shared-workspace | 5 | 主工作区 + 受限子区 | 子任务范围 | 随主任务 |
R5 remote | 6 | 远端实例 | 协议契约 | 远端自管,平台只做发现 + 幂等 |
平台只实现一个运行态控制器(创建/隔离/快照/回收/恢复),链路只是参数组合。
1.4 三个质变点
- ▲ 质变点 A(②→③):出现脚本执行 → 需要隔离工作区。Skill 是否声明脚本决定走 R1 还是 R2。
- ▲ 质变点 B(③→④):出现独享实例 → 需要闲置回收与冷/热恢复。独享 ≠ 常驻,回收是资产回收不是删状态。
- ▲ 质变点 C(⑤→⑥):状态权威移出进程 → 协议化(A2A)。双方各自账本 + 消息幂等/版本对齐。
二、方向二:平台完整闭环
2.1 前向 + 后置
- 前向(在线):六条链路 = R1–R5 运行态分级 + 22 条接缝 + 十条原子规则。
- 后置(离线/异步):统一异步反馈管线 = 记忆蒸馏 + 数据飞轮两个实例。
2.2 统一异步反馈管线(两个闭环一套骨架)
运行轨迹(22 账本 / OTel,接缝 19)
↓ 采集
蒸馏器(实例 A:记忆蒸馏 / 实例 B:数据集加工)
↓ 验证(去重 / 冲突检测 / 置信度 / rubric)
入库(实例 A:记忆库 + 画像版本 / 实例 B:Dataset 仓库)
↓ 应用(实例 A:Context Compiler 注入 / 实例 B:评测门禁 → 灰度发布)
评估(实例 A:记忆命中率 / 实例 B:评测指标回归)
↓ 回流(新轨迹 → 下一轮)差异只在"写什么"(用户画像 vs 数据集)与"应用到哪"(上下文注入 vs 模型/路由/技能发布)。共享同一套采集、验证、版本、评估机制——这是 26 篇"调优闭环"应承载的统一骨架。
2.3 记忆偏好蒸馏(记忆更新)
目标:从每次交互提取用户稳定特征(事实/偏好/习惯/关系),越用越顺手。
- 记忆分层:会话内记忆(随会话,AgentStateStore)| 长期画像(跨会话用户级,mem0 + 结构化画像)| 组织知识(团队/租户级,Nacos 资源目录)。IsolationScope 的 USER/AGENT 对应画像读写边界,画像属 USER 级,不 AGENT 级共享。
- 提取三通道:显式(用户声明 → 权威)+ 隐式蒸馏(LLM 从轨迹推断 → 派生,标置信度 + 来源证据)+ 行为统计(高频模式 → 候选)。显式 > 隐式(原子规则 1 在记忆层的延伸)。
- 冲突与删除:新记忆与旧画像冲突 → 标记待确认而非覆盖;用户可删除且可回滚(画像版本化,不裸 KV 覆盖)。记忆是"建议"不是"事实",隐式推断必须带
source_trajectory_id证据(原子规则 6/8)。 - 召回与注入:按需检索 → Context Compiler 信任分层注入(§四.4.3 已把 Memory 放低信任层)→ 控制 token 预算,只给与当前任务相关的。
蒸馏流水线:轨迹 → 候选提取(三通道)→ 去重/冲突检测 → 置信度标注 → 写入(画像版本 + 向量记忆)→ 评估(命中率/有用性反馈)→ 运行时召回。
2.4 数据飞轮(六链路 × 数据产出映射)
| 链路 | 产生的数据 | 证据质量 | 飞轮用途 |
|---|---|---|---|
| 1 纯 Chat | 对话轨迹 | 消息级(弱) | prompt 优化、路由调优 |
| 2 Chat+工具 | 轨迹 + 工具调用记录 | 消息级 + 工具证据 | 工具选择优化、Jev 校准 |
| 3 技能包 | 轨迹 + 脚本执行 + 产物 | 产物级(强) | 技能评测、Skill 版本迭代 |
| 4 个人助手 | 长期交互历史 | 高(跨会话) | 用户画像蒸馏主源 + 助手行为优化 |
| 5 多 Agent | 委派轨迹 + 协作记录 | 强 | 任务分解优化、协作评测 |
| 6 跨端 | A2A 协议交互 | 协议级 | 协议兼容性、跨端协作评测 |
关键结论:链路 3+ 才有"产物级证据",飞轮收益与链路复杂度正相关。链路 1/2 数据要防 partial 污染(接缝 19:采集缺失标 partial,不补零)。
飞轮五道门禁(26 篇):轨迹清洗(污染/去重)→ 数据集(rubric + split + 版本钉扎)→ 评测(黄金集 + 评分器版本)→ 门禁(阈值先注册,证据不足不准入)→ 灰度发布(版本钉扎)。任何改进必须证明"变好"才准上。
三、方向三:多 Agent 组织化演化
3.1 行业参照(2026-10 可查证形态)
| 产品/组织 | 组织化信号 |
|---|---|
| 豆包工作 | 多 Agents 并行(主 organizer 拆解 → 子 agent 并行 → 汇总);"伙伴与小队"(跨任务持久团队、群内协作);hiagent 全角色工作空间 |
| OpenAI Codex | Codex App 管理多 agent、并行任务、长周期项目;hosted sandbox(文件/包/技能/插件可配置);默认只改当前目录、网络访问需授权 |
| Anthropic | 编排程序化:Claude 生成编排程序管理 sub-agents;Agent Swarm:单 workflow 可 spawn 1000 agents、64 线程并发 |
| 框架层 | Supervisor 分层(CrewAI/AutoGen);Swarm 对等交接(LangGraph/OpenAI Agents SDK) |
| 个人 AI 助理(开源) | 多端接入(钉钉/企微/飞书/微信/Discord/Telegram)、多智能体协作、记忆进化、本地优先 |
| 企业 Agent 团队框架(开源) | 企业 Agent 团队:Manager-Workers 架构(Manager 集中调度多个 Workers),面向企业协作场景 |
| agentscope-service(源码) | 原生 collaboration + orchestration:teams 表 + /api/v1/teams(leader/members/role/version 乐观并发);Issue(AssigneeType=Agent/Team、CompletionPolicy、DueAt、Version);Comment 线程(路由含 team_leader/review_request);OrchestrationDefinition/Revision/Run/RunNode/RunEdge/RunTeamSnapshot;RuntimeBindingPolicy;AgentEndpoint(targetType=team、invocationMode=job) |
| 企业协作式多智能体平台(开源,2026-10-25 拉取) | 协作式多智能体运行平台:Manager-Workers 架构,K8s 原生 Team/Worker/Manager/Human CRD(TeamSpec:Admin/HumanMembers/WorkerMembers/ChannelPolicy/SubagentModel/HeartbeatEvery);Matrix 房间协议全程可审计、人类随时介入;Higress AI Gateway 凭证零暴露、MinIO 共享文件降 Token、Nacos Skills 注册、AgentLoop 观测审计;auto_sleep_controller(闲置回收)、human_controller/worker_approval(人工干预带审计)、TeamHarness(任务状态历史/进度/完成通知);个人 AI 助理为默认 Worker 运行时之一 |
| 企业数据分析智能体(开源,2026-10-25 拉取) | 企业数据分析智能体系统:事实(DataBridge 元数据图/知识图/轨迹图三图语义基底)+ 方法(Skill-Hub)+ 执行(Host DAG/子智能体/容器工作区/产物登记/反思恢复) 三拆;业务概念锚定数据实体、指标定义、血缘、历史轨迹 |
3.2 三个组织化跃迁
- 跃迁 1:任务内分工 → 跨任务团队。对象从
task(用完即散)变成team(有身份、角色、画像、记忆、生命周期)。豆包"工作小队"是雏形。 - 跃迁 2:主 agent 持续协调 → 编排程序化。主 agent 的协调职能(分发/收集/流转)外包给可执行编排程序,主 agent 只管目标与验收。Anthropic 已落地——平台差异化机会。
- 跃迁 3:组织内协作 → 组织间协作。企业 A 的 Agent 调用企业 B 的 Agent(A2A + 市场)。HiMarket 从"能力市场"放大为"组织间协作市场"。
3.3 三阶段场景谱系
| 阶段 | 场景 | 组织形态 | 平台已有 | 平台缺口 |
|---|---|---|---|---|
| A. 任务组织(现状) | 单任务多角色、流水线(规划-执行-验证)、并发工作台 | 任务内临时分工,用完即散 | 接缝 13、SubagentSpec、Budget Lease、R4/R5 | 基本闭合 |
| B. 团队组织(正在出现) | 持久小队、角色化团队(architect/coder/reviewer/tester)、跨任务复用 | 角色固定、任务流动、团队有记忆 | agentscope-service 原生 teams/collaboration(源码坐实) | 平台对接:07 篇字段对齐 + 团队预算级联 |
| C. 智能组织(演化目标) | 自组织(按任务动态组队/解散)、编排程序化(swarm)、组织间协作 | 动态组建、目标驱动、组织治理 | Nacos AgentCard(A2A)、HiMarket、Orchestration 运行时原生(orchestration.go) | 组织治理面(目标树/团队预算/绩效/审计) |
3.4 智能组织的四个基础设施
关键连接:后置操作(记忆蒸馏 + 数据飞轮)正是"智能组织"区别于"多 Agent 任务"的本质——任务组织用完即散,组织必须有记忆,越用越强。
| 基础设施 | 内容 | 与已有设计的关系 |
|---|---|---|
| 组织记忆 | 团队级知识、成员画像(擅长/风格/历史)、历史决策与复盘 | = 记忆蒸馏的团队层实例;mem0 组织层 + Nacos 知识资源 |
| 数据飞轮(组织级) | 团队产出轨迹回流 → 评测 → 发布 | 26 篇调优闭环的组织级放大:评测粒度从任务升级到团队/角色 |
| 编排运行时 | 主 agent 生成编排程序(DSL),平台执行分发/收集/流转/重试 | 接缝 13 从"运行时消息委派"升级为"可执行程序委派" |
| 组织治理 | 目标树(goal→子目标→任务)、团队预算级联、审批链、绩效评测、成本核算 | Budget Lease 从任务级升团队级;接缝 15 门禁升组织级 |
一句话:智能组织 = 团队对象 + 编排程序 + 组织记忆 + 组织治理。前两个是运行时,后两个是后置操作的团队化。
四、能力全景与接线(八域 44 项)
4.1 能力清单
| 域 | 能力项 |
|---|---|
| D1 对话与交互 | ①多渠道接入 ②会话历史保存/恢复 ③工具调用与准入 ④工具结果证据留痕 |
| D2 技能与执行 | ⑤Skill 供给/预检/版本 ⑥脚本执行与工作区 ⑦数据隔离 ⑧状态外置/快照 ⑨文件操作 |
| D3 个人助手 | ⑩独享运行态 ⑪闲置回收 ⑫冷/热恢复 ⑬渠道事件唤醒 |
| D4 多 Agent 协作 | ⑭任务分解与委派 ⑮同机共享工作区(权限收窄) ⑯跨端 A2A ⑰子预算级联 ⑱并行执行 |
| D5 记忆与飞轮 | ⑲会话记忆 ⑳长期记忆 ㉑用户画像蒸馏 ㉒轨迹采集 ㉓数据集加工 ㉔评测门禁 ㉕灰度发布 ㉖调优闭环 |
| D6 组织化 | ㉗Team 对象 ㉘角色目录 ㉙编排程序 DSL ㉚组织记忆 ㉛组织治理 ㉜组织间协作 |
| D7 平台底座 | ㉝运行态分级 R1-R5 ㉞统一任务状态机 ㉟认证与权限 ㊱可观测与审计 ㊲模型目录与路由 ㊳资源目录 ㊴配置管理 ㊵消息/任务分发 |
| D8 补充场景 | ㊶异步批处理/后台任务 ㊷Agent 请求人类(人机反向) ㊸Agent 即服务(B 端系统集成) ㊹上下文压缩与长任务记忆管理 |
4.2 接线状态(分域)
D1 对话与交互 —— ✅ 全面支持(4/4)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 多渠道接入 | Higress + wasm-go 插件 | 03/13 | 1 | ✅ 原生(身份头语义平台插件) |
| 会话保存/恢复 | AgentScope AgentStateStore(Redis/JSON) | 06/12 | 5 | ✅ 原生,ConflictPolicy 需显式 FAIL |
| 工具调用/准入 | AgentScope 工具 + 平台策略 | 15/19 | 7 | ✅ 原生 |
| 工具证据留痕 | 审计服务(平台) | 14/22 | 22 | ✅ 已设计 |
D2 技能与执行 —— ✅ 全面支持(5/5)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| Skill 供给/预检 | Nacos 原生 SkillService + SkillUploadPrecheckResult | 19 | 12 | ✅ 原生坐实(§6.5.3) |
| 脚本执行/工作区 | AgentScope SandboxContext/RemoteFilesystem | 21 | 8 | ✅ 原生 |
| 数据隔离 | IsolationScope 四值 | 06/12/15 | 5/8 | ✅ 原生(沙箱顺序复用语义需注明) |
| 状态外置/快照 | Checkpoint + 状态存储 | 12/21 | 8 | ✅ 已设计 |
| 文件操作 | RemoteFilesystem(Local/远程) | 12/21 | 8 | ✅ 原生 |
D3 个人助手 —— 🟡 3/4(1 缺口)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 独享运行态 | agentscope-paw(托管需 service) | 17 | — | ✅ 已定位(§5 执行体矩阵) |
| 渠道事件唤醒 | Scheduler + 13 渠道适配 | 17/13 | 1 | ✅ 已设计 |
| 冷/热恢复 | 会话状态 + Checkpoint | 12/21 | 5/8 | ✅ 已有机制 |
| 闲置回收 | — | 21 | 8 | 🔧 缺口(G1) |
D4 多 Agent 协作 —— ✅ 全面支持(5/5)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 任务分解/委派 | AgentScope SubagentSpec(isolated/shared) | 11/22 | 13 | ✅ 原生 + 委派契约 |
| 同机共享工作区 | WorkspaceMode=shared + scope 收窄 | 11/13 | 13 | ✅ 原生(权限收窄平台补) |
| 跨端 A2A | Nacos 原生 AgentCard/A2aService | 13 | 12/13 | ✅ 原生坐实(§6.5.3) |
| 子预算级联 | Budget Lease(平台) | 22/24 §4.4 | 3/13 | ✅ 已设计 |
| 并行执行 | Scheduler + LiteTopic | 10/22 | 4/10 | ✅ 原生 + 租约幂等 |
D5 记忆与飞轮 —— 🟡 6/8(2 缺口)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 会话记忆 | AgentStateStore | 06/12 | 5 | ✅ 原生 |
| 长期记忆 | mem0 扩展模块 | 12 | — | ✅ 存在(API 未逐类验证,G8) |
| 轨迹采集 | OTel + 任务账本 | 14/22 | 19 | ✅ 已设计 |
| 数据集加工 | Pipeline/Dataset(平台) | 26 | 20 | ✅ 26 篇 |
| 评测门禁 | 黄金集/评分器(平台) | 26/24 §4.7 | 15 | ✅ 26 篇 |
| 灰度发布 | Release/Manifest | 16/26 | 21 | ✅ 26 篇 |
| 调优闭环 | 26 篇全链路 | 26 | 19-21 | ✅ 已设计 |
| 用户画像蒸馏 | — | 26 | 19 | 🔧 缺口(G3) |
D6 组织化 —— ✅ 3/6 原生坐实(3 项待对接扩展)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 组织间协作 | Nacos A2A + HiMarket | 04/13 | 11/12/13 | ✅ 原生基础 |
| Team 对象 | 企业多智能体平台 Team CRD(TeamSpec:Admin/HumanMembers/WorkerMembers/ChannelPolicy)+ agentscope-service teams 表双源 | 07 | 13 | ✅ 原生坐实(选型纳管/桥接,G5 改写) |
| 编排程序 | agentscope-service 原生 OrchestrationDefinition/Revision/Run/RunNode/RunEdge/RunTeamSnapshot + RuntimeBindingPolicy | 07 | 13 | ✅ 源码坐实(orchestration.go) |
| 角色目录 | Nacos AgentCard + team 成员 role(reviewer 等) | 08/13 | 12 | 🟡 对接扩展 |
| 组织记忆 | Issue ContextRefs/SourceRef + mem0 组织层 | — | 19 | 🟡 对接扩展 |
| 组织治理 | Issue(CompletionPolicy/DueAt/Version/Assignee)+ Budget Lease | — | 3/15 | 🟡 对接扩展 |
D7 平台底座 —— 🟡 7/8(1 升级)
| 能力 | 开源组件 | 平台篇目 | 接缝 | 状态 |
|---|---|---|---|---|
| 运行态分级 R1-R5 | 沙箱 + 状态 + 租约 | 21/24 §5 | 8 | 🟡 需矩阵化(G2) |
| 统一任务状态机 | AgentScope + 平台账本 | 22 | 4 | ✅ 已设计 |
| 认证与权限 | Higress + Token Exchange | 03/15 | 1/2 | ✅ 已设计 |
| 可观测与审计 | OTel(BOM 坐实)+ 证据 | 14/22 | 14/22 | ✅ 已设计 |
| 模型目录/路由 | HiRoute capabilities(原生) | 05 | 7/12 | ✅ 原生 |
| 资源目录 | Nacos api/ai 全套原生 | 08/19 | 12 | ✅ 原生(§6.5.3) |
| 配置管理 | Nacos | 08 | 12 | ✅ 原生 |
| 消息/任务分发 | RocketMQ LiteTopic | 10 | 4/10 | ✅ 原生(无重试→租约幂等) |
4.3 支持度结论
| 域 | 支持度 | 判定 |
|---|---|---|
| D1 对话与交互 | 4/4 | ✅ 全面支持 |
| D2 技能与执行 | 5/5 | ✅ 全面支持 |
| D3 个人助手 | 3/4 | 🟡 1 缺口(G1 闲置回收) |
| D4 多 Agent 协作 | 5/5 | ✅ 全面支持 |
| D5 记忆与飞轮 | 7/8 | 🟡 1 缺口(G8 mem0 验证) |
| D6 组织化 | 3/6 | 🟡 Team/编排/组织间源码原生坐实,角色目录/组织记忆/治理待对接(G5/G6/G7 降级为对接项) |
| D7 平台底座 | 7/8 | 🟡 1 升级(G2 运行态分级矩阵化) |
| D8 补充场景 | 0/4 | 🔧 架构走通 4/4,合缝缺口 4 项(G9–G12) |
4.4 补充场景域 D8:四场景走通与合缝
走通结论先行:四个场景在现有架构(前向 R1–R5 + 连接层 + 后置管线)上全部可走通(路径可达),合缝缺口集中在四个对象/状态,不改变骨架。
| 场景 | 走通路径(入口→处理→状态→恢复→证据) | 走通结论 |
|---|---|---|
| 1 异步批处理 | 渠道提交(接缝1)→ Scheduler+LiteTopic 受理(接缝10)→ 内核执行 → task_run 完成 → 产物+渠道回执(接缝9/10) | ✅ 路径通,状态机缺 queued/notified 两态(G12) |
| 2 Agent 请求人类 | 内核挂起 → 快照释放沙箱(原子规则5)→ 渠道通知 → 用户响应(接缝1)→ 快照恢复续跑(接缝5/8) | ✅ 路径通,人机请求契约缺(G9) |
| 3 Agent 即服务 | 系统调用(Higress MCP/A2A)→ 系统身份认证 → 内核执行 → 结果同步返回或异步回调 | ✅ 路径通,系统身份语义缺(G10) |
| 4 上下文压缩 | 长任务近窗口上限 → 压缩点快照 → 摘要注入(Context Compiler)→ 原始保留(证据分层) | ✅ 路径通,压缩契约缺(G11) |
合缝动作表:
| 场景 | 关键接缝 | 现状 | 合缝动作 | 落点 |
|---|---|---|---|---|
| 1 异步化 | 4/10/1 | 任务状态机为同步语义 | task_run 补 queued/notified 两态;提交幂等键(同键同体幂等、同键不同体 409);回执走 13 篇产出物交付 | 22 篇(G12) |
| 2 人机反向 | 3/8/13/5 | 审批挂起机制有(22 篇) | 人机请求契约(request_id/deadline/会签/超时/resumable);挂起期间预算保留语义;多级审批接缝 13 | 22 篇(G9) |
| 3 Agent 即服务 | 1/2/12/7 | Nacos AgentEndpoint + Higress MCP 代理原生 | 系统身份(client_id+scopes)与用户身份分离;系统级计量(接缝 7) | 15 篇(G10) |
| 4 上下文压缩 | 5/4/19 | ConflictPolicy 明确 APPEND_MERGE 不适合压缩 | 压缩契约(压缩点/摘要版本/原始保留/失败回退);压缩事件进账本;摘要注入走 Context Compiler | 12/22 篇(G11) |
五、缺口台账(G1–G12,补设计后承载能力价值)
调研更新(2026-10-25):早期的个人助理形态已演进为多智能体协作+记忆进化的开源实现;真正的企业 Agent 团队采用 Manager-Workers 架构;agentscope-service 原生提供 teams/collaboration/orchestration(源码坐实),故 G5/G6/G9 由"缺口"降级为对接项,不再自建。
| # | 缺口 | 落点 | 优先级 | 验收判据 |
|---|---|---|---|---|
| G1 | 独享运行态生命周期(闲置回收/冷热恢复);开源团队平台 auto_sleep_controller 原生休眠需评估复用 | ✅ 21 篇 §十一 已落(对齐 coord_lease/coord_worker 租约心跳) | P0 | 空闲超时 → 快照落盘 → 释放容器 → 事件唤醒冷/热启动,全程可审计(21 篇验收判据) |
| G2 | 运行态分级矩阵 R1-R5(六链路统一控制器) | ✅ 21 篇 §十 已落 | P0 | 同一控制器按参数创建 R1–R5 任一等级,链路切换不换实现(21 篇判级函数) |
| G3 | 用户画像蒸馏流程(三通道/冲突/回滚/召回) | ✅ 26 篇 §十二 已落(对齐 builder_memory_store/memory_version) | P1 | 显式 > 隐式;冲突待确认;可删除可回滚;召回带 token 预算与信任分层 |
| G4 | 六链路 × 数据产出映射(飞轮分级采集) | ✅ 26 篇 §十一 已落 | P1 | 采集按链路证据质量分级;链路 1/2 弱证据不污染强数据集 |
| G5 | Team 纳管/对接:agentscope-service 原生 Team 坐实(Leader/成员 role+instructions/policy、Run 快照、coordinator 节点、任务协议带权限隔离、Issue 协作)→ 选型:以原生 Team 对齐;企业多智能体平台 CRD 远期备查 | ✅ 已落(原生 create-team.md + /api/v1/teams) | P1 | Leader/成员角色/策略对齐;平台补 Team DSL 生成入口与团队预算级联(G7) |
| G6 | 编排对接:agentscope-service 原生编排坐实(Subagent/Team/Workflow 三形态 + orchestration-runs pause/resume/cancel;Workflow 节点可调 Agent 或 Team)→ 平台补 Workflow DSL 生成入口 + 失败重放 | ✅ 已落(原生 orchestration.md/workflows.md) | P1 | 主 Agent 生成 Workflow 定义;依赖/分支/审批表达为执行图;pause/resume/cancel 原生 |
| G7 | 组织记忆与治理(Issue ContextRefs 对接 + 目标树/团队预算/绩效评测) | ✅ 已落(原 29 篇编号并入本文) | P1 | 组织级记忆版本化;目标树 goal→子目标→任务;Budget Lease 团队级;评测粒度到团队/角色;治理指标可审计 |
| G8 | mem0 API 逐类验证 | ✅ 24 篇 §6.5.8 已落(mem0 client 源码坐实,SSH 拉取) | P2 | 写读/检索/删除齐备;接入映射 user_id→sub、agent_id→Agent、app_id→Application;注意 v1/v2 与 v3 版本漂移 |
| G9 | 人机反向对接:原生 builder_coord_hitl(tool_use_id/approval_id/expires_at/decision_version/continuation_lease)坐实 → 平台补会签聚合与渠道映射 | ✅ 22 篇 §十八 已落(原生坐实,对齐) | P1 | 挂起→快照释放→通知→响应→恢复全程可审计;超时策略平台补 |
| G10 | 系统身份认证(client_id+scopes,Agent 即服务) | ✅ 15 篇 §七 已落(原生坐实 builder_user + Application scopes) | P1 | 系统调用与用户对话身份分离;计量到系统级 |
| G11 | 上下文压缩契约(压缩点/摘要版本/原始保留/失败回退) | ✅ 12 篇 §十一 已落(对齐 builder_memory/memory_version) | P1 | 原始 Records 不可改;摘要版本化;压缩失败回退上一组 Lock |
| G12 | 异步受理两态(task_run queued/notified)+ 提交幂等;开源团队平台 TeamHarness(任务状态历史/进度/完成通知)可参考 | ✅ 22 篇 §十七 已落(原生坐实 outbox/fence/turn_command,对齐) | P0 | 提交幂等键同键不同体 409;受理立即返回;完成通知带回执证据 |
判定:补 G1–G12 后,平台从"任务执行器"升级为"组织运行时";Team/编排由 agentscope-service 原生承载(对接而非自建),平台差异化转为:组织治理面(目标树/预算/绩效)+ 组织记忆 + 用户层编排入口 + 独享生命周期。
六、接线路线(后续动作)
| 步骤 | 内容 | 依赖 |
|---|---|---|
| 1 | G1/G2/G12 → 21/22 篇升级(运行态分级矩阵 + 独享生命周期 + 异步受理) | ✅ 已落(21 篇 §十/§十一、22 篇 §十七) |
| 2 | G3/G4 → 26 篇补(画像蒸馏 + 数据产出映射) | ✅ 已落(26 篇 §十一/§十二) |
| 3 | 组织化合缝(G5/G6/G7) | G5/G6 ✅ 已落(原生对齐);G7 组织记忆治理推进中 |
| 4 | G8 → 24 篇 §6.3 状态更新 | 源码验证 |
| 5 | 接线表随设计推进刷新,缺口台账逐项销号 | 全部 |
适用:开源生态企业智能体平台能力方向与承载判定 | 基线:24 篇 §6.5 源码合缝复核(2026-10-25)与 00–26 篇 | 初稿 2026-10-25
七、技术选型总览(开源生态组件 · 持续更新)
选型原则:优先"原生坐实"(源码已验证字段/能力存在)→ 其次"可对接"(官方提供 API/CRD,平台做字段对齐)→ 最后才是"平台自研"(缺口台账 G 项)。新增技术一律先 SSH 拉源码验证,再更新本表。
7.1 组件选型总表
| 组件(仓库) | 用来做啥(一句话) | 平台里承担 | 状态 | 证据 |
|---|---|---|---|---|
| agentscope-java | Agent 运行时内核:消息/会话/状态/沙箱/工具 | R1–R5 执行内核(六链路底座) | ✅ 原生 | 8eb91158(IsolationScope/HarnessAgent/ConflictPolicy) |
| agentscope-runtime-java | Java 侧运行时适配层 | 运行时集成 | ✅ 原生 | 7b9032b |
| himarket | Agent 能力市场:AgentCard 发布/订阅/交易/供给 | 组织间协作与能力交易(D4/D6) | ✅ 原生 | 3a63fc5(ProductRef 多配置族) |
| HiRoute | 模型路由:scoped_capability 按 模型/上游/协议/连接器/端点六维匹配 | 模型目录与路由(接缝 7/12) | ✅ 原生 | feae7f3(defaults.rs) |
| higress | AI 网关:认证/限流/MCP 代理/traceparent 透传 | 入口层(接缝 1/2/7) | ✅ 原生(external_user_id 语义为平台插件) | 36f2f1a(mcp/server) |
| nacos | 注册配置 + AI 资源目录:AgentService/AgentCard/Skill/Prompt/MCP/A2A 全套原生 | 资源与发现(接缝 12,24 篇 §6.5.3) | ✅ 原生 | 7f71d44(api/ai 目录) |
| rocketmq | LiteTopic 轻量消息:无重试主题 → Worker 租约+幂等 | 任务分发(接缝 4/10) | ✅ 原生 | 8ab8191(LiteUtil) |
| 企业多智能体平台 | 协作式多智能体运行平台:Manager-Workers、K8s Team/Worker/Manager/Human CRD、Matrix 房间、TeamHarness 状态机与信号、auto_sleep、审批 | 组织化(Team/编排/人机反向/异步) | ✅ 原生(2026-10-25 新增) | 134add4(team-controller) |
| 企业数据分析智能体 | 企业数据分析智能体:DataBridge 三图语义基底 + Skill-Hub 方法 + Host DAG 执行 | 语义锚定/轨迹参考(G4 飞轮侧参考) | 🟡 参考 | aaac4a1(README_ZH) |
| OpenJudge | AI 应用评估框架:50+ 生产级 grader、场景 rubric 生成、评分→reward signal 微调 | 评测中心(接缝 15/21,D5) | 🟡 待对接(2026-10-25 新增) | c2fdc38 |
| openpaw | 早期个人助理项目的旧仓库链接(404,已不存在) | — | ⚪ 不存在 | 404 |
| PawBench | Model × Harness 评测基准:150 tasks×9 models×3 harnesses | 评测基准数据 | ⚪ 待拉取 | OpenJudge README 提及 |
| mem0 | 记忆存储扩展模块 | 长期记忆(G8 验证中) | ⚪ 待验证 | — |
| AgentLoop | 托管服务:Agent 全栈观测/审计/评估/资产管理/持续优化 | 可观测与评估(托管备选) | ⚪ 托管服务 | 与企业多智能体平台集成 |
7.2 组织化对接方案(G5/G6 已启动;企业多智能体平台 CRD 保留为远期参考)
阶段定位(2026-10-25):本方案为远期参考,当前阶段不推进——先完成 §八 使用层场景合缝,技术底座稳定后再启动。下表保留源码契约证据备查。
基于企业多智能体平台源码坐实的契约,G1/G5/G9/G12 的对接方案(保留备查):
| 缺口 | 对接对象(原生契约) | 平台侧动作 | 验收判据 |
|---|---|---|---|
| G1 闲置回收 | Worker.spec.idleTimeout + DesiredState() + Status.LastActiveAt + AutoSleepController(默认 1 分钟扫描;仅 Running+超时→Sleeping;团队成员同为 Worker CR 一并覆盖) | 21 篇独享生命周期改为"纳管 Worker CR 生命周期";平台补事件唤醒 | 空闲超时→Sleeping→快照→事件唤醒冷/热启动,全程可审计 |
| G5 Team 对象 | TeamSpec:Admin/HumanMembers/WorkerMembers(≤128)/ChannelPolicy/SubagentModel/HeartbeatEvery;agentscope-service 侧 /api/v1/teams(version 乐观并发)双源 | 选型:企业内网用其 Team CRD;轻量部署用 service teams API;07 篇字段对齐 | team 生命周期五态;成员 role 挂接 AgentCard;预算团队级级联 |
| G9 人机反向 | approval_level 四档 STRICT/SMART/AUTO/OFF;L2 分层(L1/admin 可写、team leader 只读);GET→改单字段→PUT 全量安全写;OFF 切换入审计轨迹 | 平台补审批单(request_id)+ deadline/超时/渠道通知映射 | 挂起→快照释放→通知→响应→恢复可审计;超时策略明确 |
| G12 异步受理 | TeamHarness task-transitions.json 九态:planned→prepared→assigned→in_progress→submitted→completed/revision/blocked/cancelled;signal-mapping.json 14 事件(SIG-COMPLETE/SIG-DECISION,event_id=sha256 幂等 + audit_seq 持久审计,拒绝族追加判别器) | 22 篇统一任务状态机对齐九态;事件总线复用幂等 id 规则 | 提交幂等(重试落同一 event_id);受理立即返回;完成通知带回执证据 |
7.3 更新说明
- 新增组件/新技术:先 SSH 拉源码到
02-项目代码→ 验证关键契约(API/CRD/状态机/信号)→ 更新 7.1 状态列(✅ 原生 / 🟡 参考 / ⚪ 待验证)。 - 判定口径:原生坐实 > 可对接 > 平台自研;凡官方已有实现,平台只做选型纳管/桥接,缺口台账随之降级。
- 基线证据:24 篇 §6.5(2026-10-25 源码合缝复核)。
八、场景合缝确认(当前阶段主战场)
阶段口径(2026-10-25):先确保使用层场景合缝(六链路 + D8 四场景 + 后置反馈);组织化(企业多智能体平台/TeamHarness 对接)列为远期方向,本阶段不推进——技术底座底子还不够厚,先把 R1–R5 与 D8 走扎实。
8.1 场景 × 接缝合缝总表
| 场景 | 关键接缝 | 合缝状态 | 合缝动作 | 落点 |
|---|---|---|---|---|
| ① 纯 Chat(R1) | 4 会话账本 / 5 状态存储 / 7 工具准入 | ✅ 已合(源码坐实) | 走通验证:会话重放 + ConflictPolicy 显式 FAIL | — |
| ② Chat+工具(R1) | 7 工具准入 / 15 权限 / 22 证据 | ✅ 已合 | 走通验证:工具结果留痕 + 证据分层 | — |
| ③ 技能包(R2) | 8 沙箱工作区 / 19 轨迹 / 12 Skill 供给 | ✅ 已合(质变点 A 判定 1.4) | 走通验证:Skill 声明脚本分级 → R2 | — |
| ④ 个人助手(R3) | 8 独享生命周期 / 5 状态 | 🟡 1 缺口:G1 闲置回收 | 21 篇补:闲置检测→快照→释放→冷/热恢复 | G1(P0) |
| ⑤ 多Agent同机(R4) | 8 隔离 / 4 子账本 / 13 委派 | ✅ 已合(SubagentSpec.WorkspaceMode shared+scope 收窄) | 走通验证:shared + 权限收窄 | — |
| ⑥ 多Agent跨端(R5) | 12/13 协议 + 11 A2A | ✅ 已合(Nacos AgentCard 坐实) | 走通验证:A2A 幂等重放 | — |
| D8-1 异步批处理 | 4/10/1 | 🔧 1 缺口:G12 异步两态 | 22 篇补:queued/notified 两态 + 提交幂等 | G12(P0) |
| D8-2 人机反向 | 3/8/13/5 | 🟡 审批挂起已有,契约缺 | 22 篇补:request_id/deadline/超时/渠道映射 | G9(P1) |
| D8-3 Agent 即服务 | 1/2/12/7 | 🔧 系统身份缺 | 15 篇补:client_id+scopes 与用户身份分离 | G10(P1) |
| D8-4 上下文压缩 | 5/4/19 | 🔧 压缩契约缺 | 12/22 篇补:压缩点/摘要版本/原始保留/失败回退 | G11(P1) |
| 后置-记忆蒸馏 | 19 轨迹 + 26 篇 | 🟡 骨架在,流程缺 | 26 篇补:三通道/冲突/回滚/召回 | G3(P1) |
| 后置-数据飞轮 | 15/21 评测门禁 | 🟡 骨架在,映射缺 | 26 篇补:链路×数据产出分级 | G4(P1) |
8.2 合缝启动顺序(按场景,不按组件)
| 批次 | 动作 | 内容 | 依赖 |
|---|---|---|---|
| 批 1 | 走通验证(不改代码) | 链路 1/2/3/5/6 五条已合场景:按四问(资源/状态权威/隔离/恢复)逐条过 24 篇 §6.5 证据,确认无遗漏 | 24 篇 §6.5 |
| 批 2 | 运行态控制器(21 篇升级) | G2 运行态分级矩阵 R1–R5 统一控制器 → 连带 G1 闲置回收 + G12 异步两态 | ✅ 已落(21 篇 §十/§十一、22 篇 §十七) |
| 批 3 | D8 三场景设计 | G10 系统身份(15 篇 §七)→ G11 压缩契约(12 篇 §十一)→ G9 人机契约(22 篇 §十八) | ✅ 已落 |
| 批 4 | 后置反馈 | G3 画像蒸馏(26 篇 §十二)+ G4 数据产出映射(26 篇 §十一) | ✅ 已落 |
| 批 5 | 组织化(P1 启动) | G5 Team 纳管(原生对齐)→ G6 编排对接(原生对齐)→ G7 组织记忆与治理(见 §四 G7) | ✅ 已落 |
组织化(G5/G6/G7 + 企业多智能体平台/TeamHarness 对接):远期方向,待批 2 稳定后再启动;§7.2 方案保留为远期参考。
8.3 阶段边界(明确"不做什么")
- G5/G6 已启动:以 agentscope-service 原生 Team/Workflow 编排对齐(Leader/成员/策略、orchestration-runs),平台补 DSL 生成入口与失败重放
- 不引入 TeamHarness 状态机/事件对齐(选型已定 agentscope-service 原生 Team)
- 企业多智能体平台 CRD 纳管:保留为远期参考(§7.2),不纳入 G5 实现
- 组织化篇目:G7 组织记忆与治理以新篇目 29 落库(G5/G6 不对齐即不另建)
- 聚焦:链路 1/2/3/5/6 走通验证 + G1/G2/G12(P0) + G9/G10/G11/G3/G4(P1)
8.4 批 1 走通验证结果(2026-10-25)
对链路 1/2/3/5/6 按四问(资源 / 状态权威 / 隔离 / 恢复)逐条对照 24 篇 §6.5 证据,结论:五条链路全部合缝,无新增缺口。
| 链路 | 四问核对 | §6.5 证据 | 结论 |
|---|---|---|---|
| ① 纯 Chat(R1) | 资源:模型连接池共享|权威:会话历史|隔离:SESSION|恢复:会话重放 | 5:IsolationScope SESSION/USER + ConflictPolicy(FAIL 显式);7:HiRoute scoped_capability 六维(6.5.2) | ✅ 合缝 |
| ② Chat+工具(R1) | 资源:共享进程+工具连接|权威:会话+工具结果|隔离:会话+工具准入|恢复:历史含结果 | 7(同上)+ 15 双向授权(§九 ◐)+ 22 证据三态(20 篇) | ✅ 合缝 |
| ③ 技能包(R2) | 资源:隔离工作区+进程|权威:快照+状态外置|隔离:租户/会话工作区|恢复:快照 Fork/Reset | 8:IsolationScope 沙箱语义注明(6.5.4-2);12:Nacos SkillService/预检原生(6.5.3);19 轨迹 | ✅ 合缝 |
| ⑤ 多Agent同机(R4) | 资源:主工作区+子进程|权威:共享区+子账本|隔离:子任务权限收窄|恢复:子任务重跑+join | 8:SubagentSpec.WorkspaceMode{isolated,shared};4:T10 父/子预算分账+join;13 委派契约 | ✅ 合缝 |
| ⑥ 多Agent跨端(R5) | 资源:各自终端|权威:协议消息|隔离:终端隔离|恢复:协议幂等重放 | 11/12:Nacos A2aService/AgentCard/AgentEndpoint 原生(6.5.3);22:T1 幂等键 + T8 SSE seq | ✅ 合缝 |
走通验证注意项(不构成缺口,进批 2 固化):
ConflictPolicy.FAIL须显式配置(6.5.4-1)——链路 1/2 恢复重放的状态合并统一走 FAIL,防覆盖。IsolationScope沙箱是"顺序复用、非活共享"(6.5.4-2)——链路 5 并发同 scope 各自容器,共享工作区语义按此表述。- 链路 1/2"执行资源共享"成立前提是零文件副作用(1.2-1)——该判定规则在 G2 运行态分级矩阵固化。
- 链路 2 中间产物(工具结果)放会话/账本;弱证据不污染强数据集(G4 已承接)。
- 跨端身份(15 篇 ◐ 双向授权已补;系统身份 client_id+scopes 留待 G10)。
结论:批 1 无遗漏、无新增缺口;五条链路已合缝,使用层唯一缺口仍是链路 4(G1 闲置回收)。可进入批 2(G2 运行态分级矩阵 → G1 → G12)。
8.5 端到端贯穿示例:一个任务 × 同一个人的偏好蒸馏(2026-10-25)
示例:张工(架构师,链路 4 个人助手)发起任务"把近两个月我审过的设计文档整理成风险清单,按我惯用的格式输出"——一镜到底走查整个体系,身份贯穿始终,工作偏好被蒸馏回补。
十步走查(可直接口播):
| 步 | 动作 | 接缝/缺口 | 载体 |
|---|---|---|---|
| ① 身份贯穿 | OAuth 登录,网关只认认证结果 → sub=张工 贯穿全程;系统侧(定时汇总)走 client_id 另一条身份线 | 15 篇三层决策 + G10 | 网关认证 |
| ② 受理即返回 | 幂等键提交,queued 立即回 {task_id, accepted_at, events_url} | G12 | rt.agent_task |
| ③ 运行态判级 | judge 见"个人助手+常驻偏好"→ R3 独享;领热池→注入凭据→执行循环 | G2 | 运行态控制器 |
| ④ 工具与工作区 | Skill 声明脚本→隔离工作区;中间产物 scratch,最终产物 artifacts 扫描后提交 | 21/12 篇 | 沙箱 |
| ⑤ 人机反向 | 权限不足→request_id 挂起→快照释放→渠道通知→批准(幂等)→水合续租;超时→expired+通知 owner | G9 + T9 | 审批通道 |
| ⑥ 上下文压缩 | 80% 水位→checkpoint 压缩→摘要版本化注入(低信任层),原始 Records 不可改 | G11 | Context Compiler |
| ⑦ 完成通知 | completed→渠道回执→notified→验收 accepted;同一产物只交付一次 | G12 + T4 | outbox/SSE |
| ⑧ 轨迹采集 | OTel 全链路→opt.trajectory 一行一 run,脱敏+分层采样;链路 4 证据强全采 | O1–O10 + G4 | opt schema |
| ⑨ 偏好蒸馏 | "以后都用表格格式"→显式直入;高频风险分级表→隐式候选;与旧偏好冲突→待确认不覆盖;版本化写入 | G3 | 画像存储 |
| ⑩ 越用越顺手 | 下次任务 Context Compiler 按需召回注入(低信任层 + token 预算);记忆是建议不是事实 | G3 召回 | 运行时 |
这条线覆盖:Higress(网关认证)→ Nacos(Skill/Agent 注册,24 篇 6.5.3)→ agentscope(运行时/沙箱)→ RocketMQ(事件/通知)→ himarket(Skill 包)→ opt(飞轮);G1–G12 中 G2/G9/G11/G12/G3/G4 全部在此例中走实,G10 在系统侧身份线出现,G1 在"挂起快照释放/水合续租"处走实。缺的只有组织化(G5–G7,延后)与 mem0 验证(G8)。
8.6 断联恢复矩阵:异步化 / 人机反向 / Agent 即服务 / 上下文压缩
横切结论:四个场景的断联恢复共享同一骨架——幂等(提交/事件/响应)+ 版本(快照/摘要/产物)+ 权威源不丢(状态以 rt.agent_task 为准,不在客户端、SSE、轨迹层)。
| 场景 | 断联点 | 恢复机制 | 兜底 |
|---|---|---|---|
| 异步化(G12) | 提交后 SSE 断;通知发送失败;客户端关闭 | 幂等键提交(同键同体返原 task);events_url 轮询;SSE Last-Event-ID 重连续传(T8) | 通知失败停留 completed 可重发(T4);事件出 outbox 与状态同事务 |
| 人机反向(G9) | Agent 挂起请求期间用户不在线/渠道断;审批发出无响应 | request_id 全程可审计;响应走渠道+幂等键(T1);恢复后水合续租 | deadline 超时 → 任务 expired + 审批单关闭 + 通知 owner(T9);多端重复响应只算一次 |
| Agent 即服务(G10) | B 端系统调用(client_id)连接断——无人工兜底 | 系统侧程序化重试 + 提交幂等(同键同体);断在工具在途 → in_flight_uncertain + 幂等键,恢复先查结果(12 篇 §八);断在通知 → events_url 轮询 | 系统凭据不失效;计量到系统级;SLA 责任在对端,失败语义平台显式给出 |
| 上下文压缩(G11) | 压缩执行中断;压缩后恢复读取 | 压缩前强制落 checkpoint(checkpoint_seq);摘要版本化 compaction_{seq}_{version};恢复从 checkpoint 续而非摘要续 | 压缩幂等(重复压缩不覆盖旧版本);原始 Records 不可改可随时重建;压缩失败回退上一组 Lock |
三类断联者的恢复差异(关键讲法):
- 人断(异步化/人机反向):靠渠道兜底——通知可重发、审批可超时转
expired、响应幂等;人在哪都能接上,恢复点是"状态权威",不是"当时页面"。 - 系统断(Agent 即服务):靠程序化语义——重试必须幂等(同键同体),没有"人工再点一次";平台只保证"结果可拿、失败可判",不保证"对端在听"。
- 执行断(压缩/在途工具):靠检查点与不可变事实——压缩前必落 checkpoint,原始 Records 不可改,恢复永远从权威源重建,不依赖断点现场。
一句话收口:断联不可怕,可怕的是"断点现场"成为恢复依据——本平台恢复依据永远是 rt.agent_task 状态 + 幂等键 + 版本化快照,客户端、SSE、轨迹层都只是视图。
8.7 链路 1(纯 Chat)身份贯穿走查(2026-10-25 源码级,含控制面/数据面修正)
以最简单的 chat 为例:用户发一句话 → 回答。链路分两段——用户先经控制面 agentscope-service(自带登录、管理/调度),再由它调度数据面 agentscope-runtime 执行:
| 环节 | 组件 | 身份贯穿现状(源码证据) | 结论 |
|---|---|---|---|
| 认证点 | Higress | OIDC 插件 → sub → 透传/注入 | ✅ 认证统一 |
| 控制面 | agentscope-service | 自有登录:POST /api/auth/login → Bearer token + X-AgentScope-Tenant/Namespace + inspect/edit/publish 权限;管理托管 Agent/Workspace/Workflow/Vault/Team,原生 Session/Turn 异步 + required_actions(request_id) 人机待办 + Application API key(scopes) | ✅ 自带完整身份体系(对接 SSO = sub 映射平台用户 token) |
| 数据面 | agentscope-runtime | 无内置认证,ResponseApiHandler.getUserId() 读 metadata.userId,缺省 default_user(182-185 行);GraphAgentExecutor 从 A2A metadata.userId 取身份 | ⚠️ 透传可信靠控制面注入(客户端自报可伪造) |
| 会话存储 | Redis/TableStore | 按 sessionId 存历史;归属由控制面 Session 模型绑定 | ✅ 控制面绑定 tenant/namespace |
| 注册发现 | Nacos | 服务注册/路由,平台内置服务身份 | ◐ 不感知用户(也不需要) |
| 模型调用 | 上游 LLM | 平台 API Key(Vault),无用户身份 | ◐ 模型侧不贯穿 |
三条结论:
- agentscope-service 是控制面,自带完整登录/身份体系(不是无认证的透传层):
/api/auth/login、Bearer token、tenant/namespace、inspect/edit/publish、Application API key(scopes + 调用权审批权分离)、原生 Session/Turn + required_actions——G9/G10/G12 的核心语义它原生就有,平台工作是"SSO sub ↔ agentscope 平台用户 token 映射",而非从零补身份。 - 数据面 agentscope-runtime 才是透传层:userId 来自协议 metadata(缺省
default_user)——身份可信性由控制面注入保证(控制面代表用户调度时写入 userId),客户端绕过网关直连不可信。 - SSO 对接 = 两层转换:入口(Higress sub → agentscope 平台用户 token)+ 控制面到数据面(平台用户 → metadata.userId 注入)。用户无感,转换全审计。