在这里插入图片描述

一句话结论:Agent 拿不到项目上下文,通常不是模型能力问题,而是它没有业务对象可挂、没有可被授权的身份。OpenHex Space 用"对象层 + 身份层 + 执行层"把这三件事拆开,用任务级授权替代账号级信任。

适合读者:正在把 Agent 接进真实交付流程的技术负责人、做 Agent 平台/中台的开发者、需要评估多 Agent 协作方案的技术决策者。
前置知识:了解 MCP、RAG、Service Account 的基本概念。

背景:Agent 进入交付流程后,卡在哪

单 Agent 的能力已经不是瓶颈。读文件、调工具、跑代码、写稿子,都能做。把它放进一次真实交付里,问题才出现:

  • 它不知道自己在为哪个客户、哪个项目、哪一次变更干活;
  • 每次都要人重新喂一遍上下文,喂的那一刻就产生了副本;
  • 客户改了一次首发范围,运营窗口里是新的,交付那边的清单还是旧的。

常见的应对是"资料放到同一个网盘/知识库"。但这只回答了"东西在哪",回答不了另外三件事:这份要求覆盖哪一次上线、谁确认过、有没有被后续变更覆盖。

本文要展开的就是这个缺口,以及 OpenHex Space 在架构上怎么补。

1. 两种协作模型:文件协作与对象协作

团队协作有一套成熟模型:文件。资料放网盘,版本靠一句约定——“看最新那版”;权限靠文件夹;责任靠人。

这套模型成立的前提是参与者是人:人会追问、会核对、会对"我看的是不是最新的"保持警觉。所以文件协作的核心是,由人遵守一致性规则。

对象协作换了一套前提:客户、项目、任务成为业务对象,资料挂在对象上,不挂在文件夹里。文件夹只有路径,对象有类型、状态、关联和负责人。

文件协作对象协作
上下文单位文件客户 / 项目 / 任务
一致性由谁保证人的约定对象当前版本
权限粒度文件级任务级
状态与确认人不记录对象属性

一句话概括差别:文件回答"在哪",对象回答"这是什么、属于谁、谁确认过"。

2. 问题:Agent 有权限,没有身份

最直接的做法是把 Agent 拉进协作:给网盘权限,让它读文件、改稿子。功能上它确实能读能写。

但这里存在一个根本区别:文件系统授予的是"能打开这个文件"的权限,而不是"此刻你在为这次交付取这份资料"的授权。

它读到了,不代表这次该读。

2.1 一次合法的工具调用,不等于一次被授权的项目参与

人靠职业判断补这个缺口:客服知道自己在为谁服务,不是因为系统提示,而是因为岗位、培训、考核和追责。Agent 没有这套机制,它的全部依据就是对话窗口里的上下文。由此产生两个可复现的失败模式:

  1. 上下文可被外部输入改写。 提示词注入(Prompt Injection)之所以危险,不是因为模型不听话,而是"用户输入"和"业务要求"躺在同一个窗口里,没有层级差别。一段伪造的"客户已确认放开预约",在文本上和真实确认长得一样。
  2. 上下文可被副本污染。 每个窗口各存一份副本,版本各自漂移,改完的稿子对不对取决于谁喂了哪一版。

2.2 为什么靠 Prompt 约束无效

“在 System Prompt 里写清楚不要越权”,是一条建议,不是一道边界。只要 Agent 手里有那把钥匙,外部用户就有机会用一段自由文本让它开门。把资料发得更全、把提示词写得更长,都解决不了这个问题。

结论:文件协作通过人的纪律维持一致,Agent 协作需要系统强制执行一致性。 这是 Space 要回答的问题。

3. 架构:对象层、身份层、执行层

Space 的做法是把三件事分开,各自交给一个承载物:

  • 对象层:客户、项目、任务,回答"这是谁的、哪一次交付";
  • 身份层:服务账号(Service Account),回答"它是谁、以什么身份参与";
  • 执行层:右侧常驻对话窗口,通过 @ 与 MCP 取上下文、提结果。

MCP

@ 引用

任务级权限

候选结果 + 依据

确认

确认留痕

团队成员

对话窗口:执行层

外部 Agent
Claude / Codex

对象层
客户 / 项目 / 任务

服务账号:身份层

回写

负责人

界面上,左侧工作室挂四类对象——专家、任务、客户、项目;右侧对话常驻、可收起。分栏不是重点,重点是对话不自带上下文,上下文从左边被引用进来。

一句话概括:对象决定"这是谁的",账号决定"它是谁",任务决定"它能做什么"。

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. 与其他协作方式对比

文件协作知识库 / RAGOpenHex Space
上下文单位文件文本片段客户 / 项目 / 任务
一致性由谁保证人的约定检索相似度对象当前版本
身份无无服务账号 + 成员角色
权限粒度文件级知识库 / Agent 级项目 / 任务级
可追溯性弱有引用统计,无版本归属依据链可回放
成本可见性无无按客户 / 项目 / 任务拆分

6. 适用边界与落地状态

技术选型要看清楚它不做什么:

  • 不替代项目管理工具。 软件工程复杂度高,继续用 GitHub、GitLab;Space 更适合资料密集的服务型项目。
  • 不替人做决定。 范围调整、对外承诺、例外处理最终落到负责人身上,系统负责让判断有依据、有留痕。
  • 权限上限取决于企业配置。 平台提供身份与授权机制,能连哪些系统、能写回多少由企业决定。
  • 仍在迭代。 UI 交互、Agent Service 的端到端能力还在完善,不宜按成熟重型平台评估。
  • 版本口径。 文中"按对象取当前版本"描述的是设计意图;多版本并存时具体如何取舍,以产品实际实现为准。

7. 落地路径

  1. 选一件反复发生的事(如"核对客户需求与交付清单"),把材料、判断标准、确认人写进任务,别一上来铺满所有项目。
  2. 按任务授权,不按项目授权。 核对清单的 Agent 不需要合同和报价单。
  3. 每次交付留下依据链。 不是为了审计,是为了下一次不用重新问客户。

8. 总结

从文件协作到对象协作,变的不是存储方式,而是一致性从人的纪律,变成系统的强制。

  • 文件回答"资料在哪",知识库回答"找得到",Space 回答"这次按什么做、谁说了算、做完留下什么"。
  • 三个机制串起来是:对象给归属,服务账号给身份,任务级授权给边界,回写确认给证据。
  • Agent 的边界不该由它的自我约束决定,而该由任务级授权决定。

这也是 OpenHex 把专业能力做成可调用、按边界交付的 Agent Service 之前,必须先立起来的那道边界。

Logo

更多推荐