OpenHex Space 架构解析:Agent 协作中的对象、身份与任务级授权

一句话结论:Agent 拿不到项目上下文,通常不是模型能力问题,而是它没有业务对象可挂、没有可被授权的身份。OpenHex Space 用"对象层 + 身份层 + 执行层"把这三件事拆开,用任务级授权替代账号级信任。
适合读者:正在把 Agent 接进真实交付流程的技术负责人、做 Agent 平台/中台的开发者、需要评估多 Agent 协作方案的技术决策者。
前置知识:了解 MCP、RAG、Service Account 的基本概念。
背景:Agent 进入交付流程后,卡在哪
单 Agent 的能力已经不是瓶颈。读文件、调工具、跑代码、写稿子,都能做。把它放进一次真实交付里,问题才出现:
- 它不知道自己在为哪个客户、哪个项目、哪一次变更干活;
- 每次都要人重新喂一遍上下文,喂的那一刻就产生了副本;
- 客户改了一次首发范围,运营窗口里是新的,交付那边的清单还是旧的。
常见的应对是"资料放到同一个网盘/知识库"。但这只回答了"东西在哪",回答不了另外三件事:这份要求覆盖哪一次上线、谁确认过、有没有被后续变更覆盖。
本文要展开的就是这个缺口,以及 OpenHex Space 在架构上怎么补。
1. 两种协作模型:文件协作与对象协作
团队协作有一套成熟模型:文件。资料放网盘,版本靠一句约定——“看最新那版”;权限靠文件夹;责任靠人。
这套模型成立的前提是参与者是人:人会追问、会核对、会对"我看的是不是最新的"保持警觉。所以文件协作的核心是,由人遵守一致性规则。
对象协作换了一套前提:客户、项目、任务成为业务对象,资料挂在对象上,不挂在文件夹里。文件夹只有路径,对象有类型、状态、关联和负责人。
| 文件协作 | 对象协作 | |
|---|---|---|
| 上下文单位 | 文件 | 客户 / 项目 / 任务 |
| 一致性由谁保证 | 人的约定 | 对象当前版本 |
| 权限粒度 | 文件级 | 任务级 |
| 状态与确认人 | 不记录 | 对象属性 |
一句话概括差别:文件回答"在哪",对象回答"这是什么、属于谁、谁确认过"。
2. 问题:Agent 有权限,没有身份
最直接的做法是把 Agent 拉进协作:给网盘权限,让它读文件、改稿子。功能上它确实能读能写。
但这里存在一个根本区别:文件系统授予的是"能打开这个文件"的权限,而不是"此刻你在为这次交付取这份资料"的授权。
它读到了,不代表这次该读。
2.1 一次合法的工具调用,不等于一次被授权的项目参与
人靠职业判断补这个缺口:客服知道自己在为谁服务,不是因为系统提示,而是因为岗位、培训、考核和追责。Agent 没有这套机制,它的全部依据就是对话窗口里的上下文。由此产生两个可复现的失败模式:
- 上下文可被外部输入改写。 提示词注入(Prompt Injection)之所以危险,不是因为模型不听话,而是"用户输入"和"业务要求"躺在同一个窗口里,没有层级差别。一段伪造的"客户已确认放开预约",在文本上和真实确认长得一样。
- 上下文可被副本污染。 每个窗口各存一份副本,版本各自漂移,改完的稿子对不对取决于谁喂了哪一版。
2.2 为什么靠 Prompt 约束无效
“在 System Prompt 里写清楚不要越权”,是一条建议,不是一道边界。只要 Agent 手里有那把钥匙,外部用户就有机会用一段自由文本让它开门。把资料发得更全、把提示词写得更长,都解决不了这个问题。
结论:文件协作通过人的纪律维持一致,Agent 协作需要系统强制执行一致性。 这是 Space 要回答的问题。
3. 架构:对象层、身份层、执行层
Space 的做法是把三件事分开,各自交给一个承载物:
- 对象层:客户、项目、任务,回答"这是谁的、哪一次交付";
- 身份层:服务账号(Service Account),回答"它是谁、以什么身份参与";
- 执行层:右侧常驻对话窗口,通过 @ 与 MCP 取上下文、提结果。
界面上,左侧工作室挂四类对象——专家、任务、客户、项目;右侧对话常驻、可收起。分栏不是重点,重点是对话不自带上下文,上下文从左边被引用进来。
一句话概括:对象决定"这是谁的",账号决定"它是谁",任务决定"它能做什么"。
4. 机制拆解
4.1 对象:客户 — 项目 — 任务
三层分工:客户是服务对象,项目是这一次交付,任务是"核对宣传稿""更新验收清单"这类具体工作。
挂载关系决定协作是否共享同一依据:客户确认的首发范围挂项目,宣传稿和验收清单挂各自的任务。运营的任务引用项目里的范围,交付的任务引用同一份,客户的一次变更于是变成两份共享同一依据的分工,而不是两条各自转述的口径。
任务不是待办清单。 一条任务必须写清三件事:
| 要素 | 作用 | 省略的后果 |
|---|---|---|
| 核对什么 | 判断标准来自哪份确认 | 标准漂移,各按各的理解做 |
| 交什么 | 交付物形态 | 结果无法验收 |
| 谁确认 | 责任人 | 只能证明"做过",不能证明"做对" |
为什么任务是最小单位?因为任务才是可以被授权、被确认、被追溯的那一格。
4.2 引用:@ 与 MCP
复制会断开联系:副本一旦离开对象,项目里的范围后来改了,聊天窗口里那份不会跟着改,事后也没人说得清当时贴的是哪一版。
Space 的做法是把对象拖进对话,或用 @ 把项目、任务引进来,等于给对话划范围。MCP 是连接:在"我的电脑"里接入 Claude、Codex 后,外部 Agent 装上 MCP 就能理解 Space 内部的项目与任务对象,在授权范围内自取上下文,而不是把 Space 当成一个需要反复复制的网页。
与检索的差别值得单独说清:
| RAG 检索 | 对象引用 | |
|---|---|---|
| 返回内容 | 相似度最高的片段 | 某对象的当前版本 |
| 是否带确认状态 | 不带 | 带 |
| 版本处理 | 新旧两版可能一起召回 | 按对象取当前版本 |
| 权限依据 | 知识库 / Agent | 任务 |
引用保证一致,不保证正确。 引用到一份错的范围,两个 Agent 会一起错,而且错得很整齐——所以引用后面必须跟授权与确认。
4.3 授权:服务账号与任务级权限
Agent 作为项目成员参与,需要一个身份。Space 给的是服务账号:外部接入的 Agent 拿到系统内部身份,再按项目或任务分配权限,于是它看得到项目对象、跟得上任务进度、在权限内处理客户资料。
反例是把账号密码直接交给它——等于把一名员工的完整权限,交给一个会听任何人说话的程序。
粒度选择上,任务级优于项目级:核对验收清单的 Agent 需要首发范围和清单,不需要合同、报价单和内部会议记录。授权粗一档,暴露面就大一圈。
4.4 校验:三道机制
这套设计沿用 Agent 防火墙的拆法:把"决定做什么"和"允许做什么"分开。需要说明的是,这套拆法最初是为"把能力对外提供成 Agent Service"设计的,把它映射到 Space 的内部协作是一种类比,不是同一套实现——Space 项目内的权限仍由服务账号与任务权限承担。
- External Agent:理解需求、制定计划、提出操作请求;
- Firewall:按服务合约(Service Contract)校验这次操作是否在范围内;
- Operator:持有真实凭证,只执行通过校验的操作。
对应到 Space 的协作场景:
| 机制 | Space 里管什么 |
|---|---|
| Service Contract 服务合约 | 任务写清允许取哪些资料、做哪些动作 |
| Task Validation 任务校验 | 这次请求是否落在该任务范围内 |
| Result Verification 结果校验 | 哪些字段可以离开系统、进入对话 |
第三道最容易被漏。一次合法的客户资料查询可能同时带回合同金额、内部备注、对接人手机号;查询被授权,不代表所有返回字段都该进模型上下文。
再彻底一步是接口化:对外只允许调用预先定义好的接口,不接受任意自由 prompt。接口即边界,提示词注入失去落点。
4.5 回写与确认
两种常见错误:
- 不回写:依据散在聊天窗口,三个月后没人答得上来"预约功能为什么没进首发稿";
- 自动回写:把模型判断直接固化成业务事实,错误获得和正确同样的地位。
Space 走中间:提交候选变更与依据 → 负责人确认 → 确认动作留痕(谁、何时、基于哪份依据、把哪一条移出了验收)。进展收集交给 AI PMO:把领域资料 @ 给它,它梳理"现在到哪一步",价值在于结果能回到任务上被核对。
4.6 沉淀:依据链与可复用方法
依据链:DataBlock 把资料关联到客户、项目或任务,事后追问任何结论都能沿任务找到当时的确认、变更决定与最终版本。可追溯不是归档,是能重建当时的判断条件。
方法:被验证有效的做法经数据管道进入迭代回路,交给 Brain 整理为可复用 Skill——好例进知识库,坏例进测试集,方法进 Skill。
前提别漏:方法必须带适用条件。 一次好评只说明这套做法在这次的客户类型、交付形态下有效。复用前回答三个问题:适用范围多大、有哪些验证证据、什么情况下该停用。
顺带一层成本能力:每个对话轮次绑定客户、项目、任务,token 消耗可按对象拆分——管理者看到的不是"本月用了多少",而是"这个客户这次交付花了多少"。
5. 与其他协作方式对比
| 文件协作 | 知识库 / RAG | OpenHex Space | |
|---|---|---|---|
| 上下文单位 | 文件 | 文本片段 | 客户 / 项目 / 任务 |
| 一致性由谁保证 | 人的约定 | 检索相似度 | 对象当前版本 |
| 身份 | 无 | 无 | 服务账号 + 成员角色 |
| 权限粒度 | 文件级 | 知识库 / Agent 级 | 项目 / 任务级 |
| 可追溯性 | 弱 | 有引用统计,无版本归属 | 依据链可回放 |
| 成本可见性 | 无 | 无 | 按客户 / 项目 / 任务拆分 |
6. 适用边界与落地状态
技术选型要看清楚它不做什么:
- 不替代项目管理工具。 软件工程复杂度高,继续用 GitHub、GitLab;Space 更适合资料密集的服务型项目。
- 不替人做决定。 范围调整、对外承诺、例外处理最终落到负责人身上,系统负责让判断有依据、有留痕。
- 权限上限取决于企业配置。 平台提供身份与授权机制,能连哪些系统、能写回多少由企业决定。
- 仍在迭代。 UI 交互、Agent Service 的端到端能力还在完善,不宜按成熟重型平台评估。
- 版本口径。 文中"按对象取当前版本"描述的是设计意图;多版本并存时具体如何取舍,以产品实际实现为准。
7. 落地路径
- 选一件反复发生的事(如"核对客户需求与交付清单"),把材料、判断标准、确认人写进任务,别一上来铺满所有项目。
- 按任务授权,不按项目授权。 核对清单的 Agent 不需要合同和报价单。
- 每次交付留下依据链。 不是为了审计,是为了下一次不用重新问客户。
8. 总结
从文件协作到对象协作,变的不是存储方式,而是一致性从人的纪律,变成系统的强制。
- 文件回答"资料在哪",知识库回答"找得到",Space 回答"这次按什么做、谁说了算、做完留下什么"。
- 三个机制串起来是:对象给归属,服务账号给身份,任务级授权给边界,回写确认给证据。
- Agent 的边界不该由它的自我约束决定,而该由任务级授权决定。
这也是 OpenHex 把专业能力做成可调用、按边界交付的 Agent Service 之前,必须先立起来的那道边界。
更多推荐


所有评论(0)