《AI Agent 产品开发·组织、平台与规模化》3.2 用户是否需要「一个团队」的隐喻

用户是否需要「一个团队」的隐喻,取决于他是否按角色派活、是否有多个责任主体。本节区分「一个团队」与「一个负责人」两种隐喻的适用条件,用 B Quill 的四个内部写作角色说明团队隐喻的解释负担,并给出判断责任归属是否清晰的三条检查线,避免把内部编排成本转嫁给用户。

以下人物、公司与数字均为教学假设,不构成对任何真实产品的评价。

内部有多个角色,界面就要展示一个团队吗?这是多 Agent 产品最常见的设计冲动:既然系统里有研究、写作、审校,就让用户看到三个头像在协作。问题是,用户打开产品不是为了参观组织架构,而是为了把一件事交出去,并且知道出问题时找谁。

核心判断只有一句:多数用户不需要「一个团队」,需要的是「这件事有人负责」。

用户真正要的是责任归属

「团队」是一种组织隐喻。它承诺两件事:分工更专业,以及有人兜底。前半句是能力承诺,后半句是责任承诺。多数产品只能兑现前半句,却在界面上同时暗示了后半句。

当用户看到三个角色,他会自然产生三个问题:

  1. 这件事归谁管?是三个都管,还是有一个主负责人?
  2. 我该找谁说?如果我只想改一句结论,需要同时通知三个角色吗?
  3. 出了问题谁解释?是写作角色、审校角色,还是「系统」?

这三个问题不回答,团队隐喻就从「更专业」变成了「更麻烦」。用户不会因为角色多而更信任系统,只会因为找不到负责人而更不信任。

两种隐喻的适用条件

团队隐喻不是不能用,它有明确的适用条件。把它和单负责人放在一起对照,判断会清楚很多。

条件一个团队一个负责人
用户是否按角色派活是,不同角色接不同任务否,用户只提交一个任务
责任主体数量两个以上,各自对结果负责一个,最终结果只有一个人解释
角色是否对用户可见是,用户需要直接与角色交互否,角色只是内部实现
解释层数用户愿意理解分工与升级路径用户只想知道进度与结论
典型场景代运营、外包团队、多交付物项目单份报告、单次分诊、单条任务线

判断顺序很重要:先看「用户是否按角色派活」,再看「是否有多个责任主体」,最后才看「角色是否可见」。如果第一项是否,后面两项再漂亮也只适合单负责人。

团队隐喻的解释负担

团队隐喻不是免费的。它要求用户理解角色名、分工边界、升级路径,还要在多个角色之间维护上下文。解释负担可以用一个结构量表示:需要解释的角色数乘以解释层数。

以 B Quill 为例,一份客户月报的写作可以拆成研究、撰写、图表、审校四个内部角色。如果界面把这四个角色都展示出来,用户至少要多理解四件事:谁找数据、谁写正文、谁做图、谁对事实错误负责。这还没有算「审校发现问题后回到撰写」的循环。

隐喻用户看到的角色需要解释的层数解释负担
一个团队4 个内部角色1 层角色名4
一个负责人1 个交付入口1 层责任说明1

解释负担不是用户调研数字,而是界面必须承载的信息量。四个角色意味着四套状态、四种失败提示、四条通知路径。每增加一个角色,产品经理就要多回答一次「这个角色和上一个有什么区别」。

B Quill 的多角色写作

B Quill 是说明这个问题的最好例子,因为它内部确实有多个角色,但用户只需要一个入口。

B 的咨询团队有 15 人,每月产出 606 份客户月报,单份 12–20 页。写作过程可以拆成研究、撰写、图表、审校:研究角色读数据包,撰写角色按模板成稿,图表角色渲染图表,审校角色做事实核对。这四个角色在系统内部是真实存在的。

但用户看到的是什么?上传数据包、选择模板、等待初稿、审改发布。用户不按角色派活,也不需要知道图表是谁做的。用户关心的是:这份报告能不能发、哪些数字需要核对、出了问题找谁。

B 的质量分布也支持这个判断:一次采纳率 63%,小改率 28%,返工率 9%,事实错误率 4.6%,平均审改 1.6 小时。用户的工作是审改,不是管理四个角色。如果界面把四个角色都摆出来,用户还要额外判断「这句结论该找研究角色还是撰写角色」,审改时间只会更长。

把内部角色暴露给用户,本质上是把编排成本转嫁出去。系统省了「统一入口」的设计工作,用户多了一组需要理解的角色。

什么时候团队隐喻是对的

团队隐喻成立的条件不是「内部角色多」,而是「用户确实在按角色管理交付」。考虑一个配置:用户需要分别拿到数据结论和报告初稿,两份交付物由不同的人负责,用户会直接找研究角色改口径、找撰写角色改结构。这时团队隐喻是帮助,因为用户本来就在做角色管理。

反过来,如果用户只有一个诉求——「给我一份能发的报告」——团队隐喻就是干扰。即使内部有十个角色,界面上也应该只有一个负责人。

这里有一条简单的边界:用户是否需要知道「谁做的」,取决于他是否需要「找谁改」。 如果用户只需要说「这里改一下」,不需要指定角色,那就不要展示角色。

把隐喻选择写成模型

下面的模型把两种隐喻的选择条件写成可执行判断。它先检查责任是否有主,再检查用户是否按角色派活,最后计算两种隐喻的解释负担。

// file: src/scale/03-2-team-metaphor.ts
// tier: L2
// verify: node --test test/scale/03-2-team-metaphor.test.ts

// 团队隐喻判定:只有当用户真的按角色派活、且责任分属多人时,
// 「一个团队」才是帮助;否则它只是把内部编排负担转嫁给用户。

import { fail, ok, type Result } from "../core/result.ts";

export type Metaphor = "team" | "single-owner";

export const METAPHOR_LABEL: Record<Metaphor, string> = {
  team: "一个团队",
  "single-owner": "一个负责人",
};

export type Role = {
  readonly id: string;
  readonly userFacing: boolean;
};

export type Responsibility = {
  readonly outcome: string;
  readonly owner: string;
};

export type Need = {
  readonly roles: readonly Role[];
  readonly responsibilities: readonly Responsibility[];
  // 用户是否会按角色分别派活,而不是只提交一个任务。
  readonly userRoutesWork: boolean;
  // 用户需要被告知多少层解释(角色名、分工、升级路径)。
  readonly explanationLayers: number;
};

export const TEAM_MIN_USER_ROLES = 2;
export const TEAM_MIN_OWNERS = 2;

export function userFacingRoles(need: Need): Role[] {
  return need.roles.filter((role) => role.userFacing);
}

export function owners(need: Need): string[] {
  const names = need.responsibilities
    .map((item) => item.owner.trim())
    .filter((name) => name.length > 0);
  return [...new Set(names)];
}

// 解释负担 = 需要解释的角色数 × 解释层数。
// 这是一个结构量,不是用户调研数字;用来比较两种隐喻的沟通成本。
export function explanationLoad(need: Need): number {
  return need.roles.length * need.explanationLayers;
}

export type Decision = {
  readonly metaphor: Metaphor;
  readonly visibleRoles: readonly string[];
  readonly ownerCount: number;
  readonly explanationLoad: number;
  readonly reason: string;
};

export function choose(need: Need): Result<Decision> {
  const namedOwners = owners(need);
  if (need.responsibilities.length > 0 && namedOwners.length === 0) {
    return fail("responsibility has no named owner");
  }

  const visible = userFacingRoles(need);
  const team =
    visible.length >= TEAM_MIN_USER_ROLES &&
    namedOwners.length >= TEAM_MIN_OWNERS &&
    need.userRoutesWork;

  return ok({
    metaphor: team ? "team" : "single-owner",
    visibleRoles: visible.map((role) => role.id),
    ownerCount: namedOwners.length,
    explanationLoad: explanationLoad(need),
    reason: team
      ? "user routes work across roles and more than one owner is accountable"
      : "one owner can absorb the work; role names add explanation without adding control",
  });
}

// B Quill 的内部写作角色:研究、撰写、图表、审校。
// 四个角色都在系统内部,用户只面对一个「报告初稿」入口。
export const QUILL_ROLES: readonly Role[] = [
  { id: "researcher", userFacing: false },
  { id: "writer", userFacing: false },
  { id: "chart-maker", userFacing: false },
  { id: "reviewer", userFacing: false },
];

export const QUILL_NEED: Need = {
  roles: QUILL_ROLES,
  responsibilities: [
    { outcome: "客户月报初稿", owner: "account lead" },
  ],
  userRoutesWork: false,
  explanationLayers: 1,
};

// 反例:一个真的需要团队隐喻的配置——用户按角色派活,两个角色各自负责结果。
export const TEAM_NEED: Need = {
  roles: [
    { id: "researcher", userFacing: true },
    { id: "writer", userFacing: true },
    { id: "reviewer", userFacing: false },
  ],
  responsibilities: [
    { outcome: "数据结论", owner: "researcher" },
    { outcome: "报告初稿", owner: "writer" },
  ],
  userRoutesWork: true,
  explanationLayers: 2,
};

`choose` 返回的是一个 `Result`,因为「责任没有主人」不是一种可接受的默认状态,必须显式失败。`owners` 会去掉空白名字并去重,避免用空字符串冒充负责人。

B Quill 的配置里,四个角色全部是内部角色,用户不按角色派活,责任只有一位客户负责人,所以结果是单负责人。解释负担仍然是 4,但这个数字现在用来提醒产品经理:如果改成团队隐喻,用户要多承担四份解释。

`TEAM_NEED` 是一个反例配置:两个角色对用户可见、两个责任主体、用户按角色派活,这时团队隐喻才成立。它不是第四家案例,只是一组用来测试边界条件的输入。

把两种隐喻放在同一个任务上比较,判断会更容易:如果换成「一个团队」后,用户需要多做的动作只是「选角色」,而不是「换交付物」,那这个团队就是多余的。

## 检查清单

- 先问用户是否按角色派活,而不是先问内部有几个角色。
- 责任主体超过一个时,必须能说出每个主体对什么结果负责。
- 角色可见的前提是用户需要直接与角色交互,不是内部实现需要曝光。
- 计算解释负担:角色数乘以解释层数,看看这个成本由谁承担。
- 只有一个交付入口时,界面只展示一个负责人。
- 责任没有主人时,选择模型必须失败,不能默认「由负责人兜底」。

## 小结

- 用户要的不是团队,是「这件事有人负责」。
- 团队隐喻成立的三个条件是:用户按角色派活、多个责任主体、角色对用户可见。
- 团队隐喻的解释负担等于角色数乘以解释层数,成本由用户承担。
- B Quill 内部有研究、撰写、图表、审校四个角色,但用户只需要一个交付入口。
- B 的用户工作是审改,不是管理角色;一次采纳率 63%、小改率 28%、返工率 9% 都指向同一件事。
- 用户是否需要知道「谁做的」,取决于他是否需要「找谁改」。
- 责任没有主人时必须显式失败,不能用「团队」掩盖责任空白。

阅读导航:上一节:[3.1 什么时候该上多 Agent](/aia-scale-03-1-when-multi/) · 下一节:[3.3 交接在用户眼里是什么](/aia-scale-03-3-handoff-ux/)。

## 常见错误与边界

1. **把内部角色当卖点。** 用户不管理组织架构,角色越多,解释负担越重;内部角色应默认隐藏。
2. **用团队隐喻掩盖责任空白。** 「这是团队的决定」等于没有人负责;责任主体必须是一个可指认的角色。
3. **只展示角色,不展示升级路径。** 用户看到三个角色却不知道出事找谁,比只看到一个负责人更焦虑。
4. **在单交付物产品上使用团队隐喻。** 一份报告只有一个最终负责人,多角色入口只会增加协调成本。
5. **把「角色可见」当成「能力可见」。** 用户需要的是进度、依据与可改之处,不是内部谁在干活。
6. **忽略解释层数。** 角色名、分工、升级路径每多一层,用户就要多学一套心智模型。

下一节进入更具体的问题:当系统真的把任务交给另一个人或另一个 Agent 时,用户在界面上应该看到什么。

继续阅读

探索更多技术文章

浏览归档,发现更多关于系统设计、工具链和工程实践的内容。

全部文章 返回首页

「books」更多文章

  1. 《大规模分布式计算深入解析》15.3 落地:从 Neo4j 到自研图引擎
  2. 《大规模分布式计算深入解析·图计算与图数据库内核》 · 目录与学习路径(45 篇)
  3. 《大规模分布式计算深入解析》15.2 十一卷主线:从切分到图