《AI Agent 产品开发·组织、平台与规模化》2.2 平台与业务的边界

平台管契约与配额,业务管任务与验收。本节给出一张边界表,用 A Relay 的 8 个工单队列、P1–P4 优先级与首响模板说明哪些规则必须留在业务,用模型网关配额、审计日志与评测调度说明哪些设施必须收进平台,并列出平台写业务规则、业务造平台管道两种越界及其后果。

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

三个案例分别是 A Relay(Northwind 的客服工单分诊 Agent)、B Quill(Meridian 的客户报告起草 Agent)和 C Runner(Kettle 的电商运营任务执行 Agent);后文简称 A、B、C。

能力目录写清楚之后,共享能力会迅速变成一块争夺的地盘。平台团队说,队列规则、优先级映射、模型配额都应该收进来,才能统一;业务团队说,这些规则每天都在变,收进平台就要排期,根本跟不上。双方都有道理,争论却经常没有结果,因为大家在用组织名称讨论边界,而不是用决策权讨论边界。

平台与业务的边界,不是「谁的技术更强」或「谁的级别更高」,而是谁对什么做决定。平台对契约和配额做决定:模型怎么调用、每个租户能用多少、审计日志留多久、评测任务怎么调度。业务对任务和验收做决定:哪些队列存在、优先级怎么映射、模板写什么、什么叫这次做得好。两条线交叉的地方,就是越界发生的地方。

三个案例的平台形态差别很大:A 没有平台,B 没有平台、只有工具集合,C 有内部平台,包含调度、审计和回滚。这个差别决定了边界讨论的起点:A 和 B 不应该照搬 C 的边界表,C 也不应该把自己的平台边界当成全公司标准。

边界不是组织架构图

用组织架构图画边界,会得到一张按汇报关系排列的图:平台部、业务部、算法部各管一块。这张图能回答「谁向谁汇报」,不能回答「这个规则该谁改」。一个规则由平台部维护,不代表它属于平台;一个能力由业务团队开发,也不代表它不属于平台。

用决策权画边界,问题会变得具体:这个决定影响一个产品还是所有产品?变更频率是每天还是每季度?错了之后谁承担后果?三个问题的答案,基本能确定归属。

影响所有产品、变更频率低、错了由平台承担后果的,通常属于平台:模型网关契约、租户配额、审计日志格式与保留期、评测调度、权限门。影响单个产品、变更频率高、错了由业务承担后果的,通常属于业务:队列划分、优先级映射、模板内容、验收阈值、升级规则。

这条判据不是绝对的,但它能解释大多数争论。比如「首响模板」看起来是内容,应该归业务;但如果模板的渲染引擎、变量替换和版本管理由平台提供,那么引擎归平台、内容归业务。边界不是把东西切成两半,而是把「机制」和「策略」分开。

一张边界表

把平台与业务的职责拆成六类,可以得到一张可直接用于评审的表。

层管什么具体例子变更频率错了谁承担
平台契约模型网关的输入输出格式、错误码低平台
平台配额每租户调用量、并发上限、超时低平台
平台管道审计日志、评测调度、回滚执行、权限门低平台
业务任务工单分诊、报告起草、运营任务的定义高业务
业务验收采纳率、错误率、返工率的阈值中业务
业务策略队列划分、优先级映射、模板内容、升级规则高业务

这张表里最容易被平台拿走的是「策略」,因为它看起来可以抽象成配置。平台确实可以提供配置机制,但不能拥有配置内容。机制归平台,策略归业务;一旦平台开始维护具体策略,它就从基础设施变成了业务部门,而且是一个离用户更远、变更更慢的业务部门。这条判据在《互联网产品的 AI 架构》里有多产品、多租户条件下的完整形态,可对照 平台与业务的边界 一起看。

最容易被业务重复建设的是「管道」,因为它看起来简单:记一条日志、重试一次调用、加一个开关。每个产品自己写一份,短期最快,长期会出现三类问题:日志格式不一致,跨产品审计无法合并;重试策略不一致,同样的故障在不同产品表现不同;权限模型不一致,同一个用户在两个产品里有不同权限。

A Relay 的规则归属

A Relay 的边界样例很适合用来练手,因为它同时包含策略、任务、验收和平台管道。

A 有 8 个工单队列:账单、登录、集成、数据、Bug、功能请求、退款、其他。这 8 个队列的划分、新增和合并,必须归业务。理由不是「支持团队更懂业务」这种笼统说法,而是变更频率和责任:队列会随着产品线、促销季、客户结构变化而调整,如果每次调整都要平台排期,支持团队会在一个季度内失去对分诊的控制;分错队列的后果由支持团队承担,平台不承担。

P1–P4 的优先级映射也归业务。优先级不是技术等级,而是 SLA 承诺:P1 意味着多久首响、多久升级、谁来盯。平台可以提供优先级字段和排序机制,但不能决定 P1 对应多少分钟;这个决定绑定客户合同和支持团队的人力安排,必须由业务拥有。

首响模板的内容同样归业务。模板措辞、适用场景、语气,都是支持团队对客户的承诺;平台可以提供模板渲染、变量替换和版本回滚,但不能替业务写模板。把模板内容收进平台,会让一次措辞调整变成一次平台发布,支持团队会绕过平台自己维护副本,最后两边不一致。

反过来,模型网关的输入输出契约、每租户调用配额、审计日志的保留与导出、评测任务的调度,必须归平台。这些设施被多个产品使用,变更频率低,错了由平台承担后果;如果让每个业务团队自己实现,会出现配额口径不一致、审计日志无法合并、评测结果无法比较。

把这 8 项放进一张表,可以得到一个清晰的 4 比 4:4 项业务策略,4 项平台设施。这个比例不是标准答案,但它说明边界不是按「技术含量」分的;队列规则的技术含量很低,却必须归业务,因为它绑定责任。

越界的两种表现

越界只有两个方向,每个方向都有典型症状。

第一种:平台写业务规则。 平台团队为了「统一」,做一个通用路由框架,把队列、优先级、升级规则都做成配置,再让业务团队填。开始时看起来很美,几个月后会出现三个症状:配置越来越复杂,业务团队看不懂;平台团队成为所有策略变更的瓶颈,排期从一周变成一个月;出了分诊错误,平台说配置是业务填的,业务说框架是平台定的,责任无人承担。

这种越界的根源,是把「可配置」当成「可拥有」。平台可以提供配置能力,但配置的默认值、变更流程和最终解释权必须归业务。判断是否越界,可以问一句:这个策略错了,平台团队会因此被追责吗?如果不会,平台就不应该拥有它。

第二种:业务造平台管道。 业务团队为了快,自己实现重试、日志、配额、权限。开始时也很快,几个月后会出现另外三个症状:每个产品的审计日志格式不同,跨产品查询要写三套解析;同一个模型供应商故障,三个产品的重试策略不同,恢复时间从 4 小时变成一天;权限模型各自为政,同一个用户在 A 能看工单、在 C 不能看订单,安全评审无法通过。

这种越界的根源,是把「基础设施」当成「业务功能」。业务团队可以提出管道需求,但不应该各自实现;管道应该由平台提供一组稳定契约,业务按契约接入。判断是否越界,可以问一句:这段代码换一个产品还能用吗?如果能,它大概率属于平台。

两种越界还有一个共同的后果:责任地图变得模糊。事实表第十节里,A 与 B 的「做了但没人知道」一格都是未定义;如果平台和业务都可以做同一件事,这一格会从「未定义」变成「都说是对方做的」,问题只会更难追。

边界成文:一页就够

C 的平台边界写成了一页文档,A 和 B 没有。这不是因为 C 更爱写文档,而是因为 C 有三条任务线和一层平台,跨团队协作必须有书面契约;A 只有一个产品,B 只有两个产品和三个共享能力,口头对齐的成本更低。

一页边界文档不需要复杂,包含四件事就够:平台拥有什么、业务拥有什么、共享契约怎么变更、争议怎么升级。平台拥有什么,列的是契约、配额、管道;业务拥有什么,列的是任务、验收、策略;共享契约怎么变更,写清楚谁提需求、谁评审、多久生效;争议怎么升级,写清楚最后由谁裁决。

这页文档的价值不在于「写下来」,而在于「写下来之后可以检查」。每次出现边界争议,先看文档;文档没写,说明边界还没定义;文档写了但双方理解不同,说明文档写得不具体;文档写了、理解也一致,但有人绕过,说明治理没执行。四种情况对应四种动作,比每次重新吵一遍有效得多。

A 和 B 现在不需要这页文档,但需要一份「共享能力清单」:哪些能力可以跨产品使用、由谁维护、变更怎么通知。B 的三个共享能力(数据包接入、文档渲染、事实核查)就应该在这份清单里;没有清单,两个产出团队会在第二次迭代时各自改一份,共享层名存实亡。

写成可检查的归属模型

下面这个模型把六类职责做成归属表:契约、配额、管道归平台,任务、验收、策略归业务。输入一个条目的声明层和类型,输出它是否越界、往哪个方向越界。A Relay 的 8 个条目作为样例,4 项业务、4 项平台,全部合规。

// file: src/scale/02-2-platform-boundary.ts
// tier: L2
// verify: node --test test/scale/02-2-platform-boundary.test.ts

// 平台管契约与配额,业务管任务与验收。
// 越界只有两种方向:平台写业务规则,或业务自己造平台管道。

export type Layer = "platform" | "business";

export type ItemKind =
  | "contract"
  | "quota"
  | "plumbing"
  | "task"
  | "acceptance"
  | "policy";

export const OWNER: Record<ItemKind, Layer> = {
  contract: "platform",
  quota: "platform",
  plumbing: "platform",
  task: "business",
  acceptance: "business",
  policy: "business",
};

export type BoundaryItem = {
  readonly id: string;
  readonly layer: Layer;
  readonly kind: ItemKind;
  readonly statement: string;
};

export type CrossingMode =
  | "platform-writes-business-rule"
  | "business-builds-platform-plumbing";

export type Violation = {
  readonly id: string;
  readonly declared: Layer;
  readonly expected: Layer;
  readonly mode: CrossingMode;
};

export function expectedLayer(kind: ItemKind): Layer {
  return OWNER[kind];
}

export function checkItem(item: BoundaryItem): Violation | null {
  const expected = expectedLayer(item.kind);
  if (item.layer === expected) return null;
  return {
    id: item.id,
    declared: item.layer,
    expected,
    mode:
      item.layer === "platform"
        ? "platform-writes-business-rule"
        : "business-builds-platform-plumbing",
  };
}

export function diagnose(items: readonly BoundaryItem[]): readonly Violation[] {
  const violations: Violation[] = [];
  for (const item of items) {
    const violation = checkItem(item);
    if (violation) violations.push(violation);
  }
  return violations;
}

export function summarize(items: readonly BoundaryItem[]): {
  readonly platform: number;
  readonly business: number;
  readonly violations: number;
} {
  let platform = 0;
  let business = 0;
  for (const item of items) {
    if (item.layer === "platform") platform += 1;
    else business += 1;
  }
  return { platform, business, violations: diagnose(items).length };
}

// A Relay 的边界样例:队列与优先级属于业务,配额、契约与审计管道属于平台。
export const RELAY_ITEMS: readonly BoundaryItem[] = [
  {
    id: "queue-taxonomy",
    layer: "business",
    kind: "policy",
    statement: "8 个工单队列的划分与新增流程",
  },
  {
    id: "priority-map",
    layer: "business",
    kind: "policy",
    statement: "P1–P4 的优先级映射与 SLA 承诺",
  },
  {
    id: "reply-template",
    layer: "business",
    kind: "task",
    statement: "首响模板的内容与适用场景",
  },
  {
    id: "acceptance-threshold",
    layer: "business",
    kind: "acceptance",
    statement: "建议采纳率与错误率的验收线",
  },
  {
    id: "tenant-rate-limit",
    layer: "platform",
    kind: "quota",
    statement: "每个租户的模型调用配额",
  },
  {
    id: "model-contract",
    layer: "platform",
    kind: "contract",
    statement: "模型网关的输入输出契约",
  },
  {
    id: "audit-retention",
    layer: "platform",
    kind: "plumbing",
    statement: "审计日志的保留、导出与访问控制",
  },
  {
    id: "eval-scheduler",
    layer: "platform",
    kind: "plumbing",
    statement: "评测任务的调度与结果存储",
  },
];

// 平台的样子随复用率变化:A 没有,B 是工具集合,C 才有内部平台。
export const PLATFORM_FORM: Record<"A" | "B" | "C", string> = {
  A: "无",
  B: "无平台,只有工具集合",
  C: "内部平台,含调度、审计与回滚",
};

OWNER 是唯一的归属事实源,checkItem 只做一件事:比较声明层和应有层。声明层是平台、应有层是业务,就是「平台写业务规则」;声明层是业务、应有层是平台,就是「业务造平台管道」。diagnose 返回全部越界项,summarize 同时给出平台项、业务项和越界数,方便在评审会上快速看结构。

RELAY_ITEMS 里的 8 个条目值得逐条对照。队列划分、优先级映射、首响模板、验收阈值归业务;租户配额、模型契约、审计保留、评测调度归平台。这个样例不包含任何越界项,但它不是「标准答案」,而是一个已经划清的边界;真实项目里更常见的是平台条目里混进策略,或者业务条目里混进管道。

模型只能检查声明,不能检查实质。一个条目声明为业务策略,实际却由平台团队维护,模型会判定合规;反过来,一个条目声明为平台管道,实际却编码了业务规则,模型也看不出来。所以归属模型要和责任人对齐使用:声明层、实际维护人、出错后的追责对象,三者一致,边界才算真正成立。

边界随复用率演进

平台边界不是一次划定就永久有效,它随复用率演进。A 的复用率是 0%,没有平台,所有东西都归产品;此时讨论「平台边界」是空谈。B 的复用率约 30%,有三个共享能力,但没有平台,边界体现为一份共享能力清单;C 的复用率约 55%,有内部平台,边界才需要写成正式的一页文档。

这条演进线意味着:不要把 C 的边界表直接复制给 A 或 B。A 没有平台团队,把队列规则「收进平台」等于收进一个不存在的组织;B 只有工具集合,把三个共享能力升级成平台管道,会增加一层不必要的协调。边界应该跟着复用率和产品数量走,而不是跟着「最佳实践」走。

下一节讨论迁移与统一的机会成本,会把这条演进线算成时间和人周:统一到一个平台,开发、迁移、培训、风险各要多少,省下的重复开发能不能覆盖这些成本。边界表回答「该谁管」,成本模型回答「值不值得合并」,两个问题要一起回答。

小结

  • 平台与业务的边界按决策权划,不按组织架构图划;平台管契约与配额,业务管任务与验收。
  • 六类职责的归属是:契约、配额、管道归平台;任务、验收、策略归业务。
  • 机制归平台,策略归业务;平台可以提供配置能力,但不能拥有配置内容。
  • A Relay 的 8 个队列、P1–P4 映射、首响模板、验收阈值归业务;租户配额、模型契约、审计保留、评测调度归平台。
  • 越界有两种方向:平台写业务规则,会让平台变成慢速业务部门;业务造平台管道,会让审计、重试和权限各自为政。
  • 两种越界都会让责任地图更模糊;A 与 B 的「做了但没人知道」一格本来就是未定义,越界会让它更难追。
  • 边界成文一页就够:平台拥有什么、业务拥有什么、契约怎么变更、争议怎么升级。
  • 边界随复用率演进:A 无平台、B 共享清单、C 一页文档;不要直接把 C 的边界复制给 A 或 B。

阅读导航:上一节:2.1 能力目录的产品字段 · 下一节:2.3 迁移与统一的机会成本 。

常见错误与边界

  1. 用组织架构图代替决策权。 平台部维护的规则不一定属于平台;判断标准是影响范围、变更频率和追责对象。
  2. 把可配置当成可拥有。 平台可以提供配置机制,但策略内容必须归业务;否则平台会成为所有业务变更的瓶颈。
  3. 把基础设施当成业务功能。 重试、日志、配额、权限看起来简单,但各产品自己实现会导致审计无法合并、故障恢复不一致。
  4. 在只有工具集合时建平台。 B 的复用率约 30%,三个共享能力用清单管理即可;过早平台化会增加协调成本。
  5. 边界文档写成原则。 「平台负责通用能力」这种句子无法检查;要写到具体条目和变更流程,才能用于裁决。
  6. 只检查声明,不检查实际维护人。 条目声明归业务、实际由平台维护,模型会判合规,但责任仍然错位;三者必须对齐。

继续阅读

探索更多技术文章

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

全部文章 返回首页

「books」更多文章

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