简介:AI Agent 正在将软件的主要调用方从“人”变为“智能体”,界面不再是产品的唯一入口。本文对比 UI 优先与 Agent 优先两类架构在交互模式、调用特征、权限体系与护城河构成上的核心差异,给出系统记录价值评估的五个问题、典型场景选型建议与 API 化迁移中的幂等、授权、审计等注意事项,帮助技术决策者判断哪些能力真正值得长期投入。
过去二十年,软件产品默认的主要用户是“人”。人通过浏览器打开页面,浏览仪表盘,在表单中填写数据,逐渐形成操作习惯与使用惯性。因此,界面设计、交互体验、品牌认知构成了软件产品重要的竞争力来源,围绕界面不断堆叠功能也成为常见的防御手段。
AI Agent 的出现改变了这一前提。Agent 不需要浏览器,不需要看仪表盘,也不依赖肌肉记忆。它完成任务需要的是四样东西:API、上下文、指令,以及执行能力。当主要用户从“人”变成”Agent”,主要界面从“UI/仪表盘”变成“API/工具链”,软件的防御逻辑就需要重写。
行业近期的讨论也聚焦于此:如何建立一个评估框架,判断在 Agent 时代,什么样的系统记录(System of Record)才真正值钱。本文将围绕这一主题,系统对比两类软件形态的差异,并给出选型与迁移的参考依据。
需要说明的是,本文讨论的是两类通用架构形态,不指向任何具体厂商产品:
UI 优先架构把图形界面作为产品主体。业务逻辑通过页面、表单、向导、报表暴露给用户,数据的查看与操作都依赖人通过界面完成,典型形态包括管理后台、运营仪表盘、业务控制台等。这类架构中,接口往往只是为界面服务的“内部通道”,接口文档、错误码设计常被视为补充材料而非核心资产。
Agent 优先架构把 API 与工具链作为产品主体。智能体通过读取接口描述与结构化上下文,自主构造请求、调用接口、解析结果、完成任务。界面退化为可选层,主要承担“人监督 Agent”的职责,例如审批、异常兜底与结果抽查。
系统记录指承载业务权威数据的系统。例如记录客户资料、订单状态、财务流水、库存数量的系统,当多个系统数据冲突时,以它为准。在 UI 优先时代,系统记录的价值常被界面体验掩盖;在 Agent 优先时代,系统记录本身成为被调用、被依赖的核心资产。
尽管调用方不同,两类架构在底层依然共享相同的基础设施诉求,这也是许多系统能够渐进式演进而非推倒重来的原因。
UI 优先架构中,语义靠“人”补全。人看到按钮上的文字、表单旁的提示,能够理解字段含义与操作后果,系统只需保证界面表达清楚。
Agent 优先架构中,语义必须由接口定义显式表达。Agent 不会“看懂”界面隐喻,它依赖接口描述、参数 Schema、字段说明、约束条件来构造正确的调用。这意味着:
人类用户的调用特征是低频、串行、单请求,操作之间有自然间隔;Agent 的调用特征是高频、可并发、可批量,且会在失败后自动重试。这对系统提出三方面新要求:
用示意代码对比两种调用路径:
# 面向人的路径(示意)用户 -> 登录 -> 浏览仪表盘 -> 人工填表 -> 提交 -> 页面提示结果# 面向 Agent 的路径(示意)Agent -> 读取接口描述 -> 构造结构化请求 -> 携带委托令牌调用 API-> 解析结构化结果 -> 失败则幂等重试 -> 写入审计轨迹
UI 优先架构的权限模型通常围绕“人”设计:账号、角色、菜单可见性、按钮级控制,判断依据相对粗粒度。
Agent 优先架构中,Agent 往往“代表某个人”执行动作,权限模型必须回答:这个 Agent 是谁授权的?它被允许做哪些动作?能读哪些字段?任务结束后授权是否收回?因此需要:
权限粒度从“页面级”细化到“动作级、字段级”,这是两类架构在安全设计上最实质的差异之一。
UI 优先时代的护城河主要包括:交互体验的优势、用户操作习惯与肌肉记忆、品牌认知,以及数据迁移带来的切换成本。这些壁垒的共同前提是“人必须通过界面使用软件”。
当 Agent 绕过界面直接调用 API 时,上述前提消失:
护城河因此转移到五个可评估的位置:
UI 场景中,错误靠页面提示与表单校验,人有判断力兜底:换一种填法、换一个入口,或者求助他人。
Agent 场景中,如果错误信息模糊,Agent 可能盲目重试、错误地继续执行,甚至放大故障。因此需要:
UI 优先架构中,接口常为页面定制,界面改版容易牵动后端逻辑;Agent 优先架构中,接口是稳定契约,界面只是契约的一个消费者。这会倒逼系统做契约化设计:先定义接口与数据模型,再决定界面如何呈现。副作用是正向的——网页端、移动端、Agent 端的多端一致性更容易保障。
| 对比维度 | UI 优先架构 | Agent 优先架构 |
|---|---|---|
| 主要调用方 | 人类用户 | AI Agent、自动化程序 |
| 核心交付物 | 页面、仪表盘、表单 | API、工具链、结构化上下文 |
| 调用特征 | 低频、串行、单请求 | 高频、可并发、可批量、会重试 |
| 语义承载 | 界面文案与人工理解 | 接口描述与参数 Schema |
| 权限模型 | 账号-角色-菜单/按钮 | 委托授权、最小权限、短时凭证 |
| 错误反馈 | 页面提示、人工兜底 | 结构化错误码、状态查询、自动重试 |
| 可观测性 | 用户行为埋点 | 调用日志、审计轨迹、结果回执 |
| 护城河来源 | 体验、习惯、品牌、切换成本 | 数据权威性、API 完备性、信任体系 |
| 界面地位 | 产品主体 | 监督、审批与异常兜底层 |
实践中,绝大多数系统会走向“Agent 执行 + 人工监督”的混合形态:Agent 负责高频、标准化的执行;界面收敛为监督台,承担审批、异常处理与结果抽检。因此更准确的选型问题不是“要不要界面”,而是“界面的投入应放在监督能力上,还是继续堆叠操作功能”。
结合上文差异,可以给出一组条件化的评估问题:
对应的投入建议是条件化的:
国内主流云服务商(如百度智能云)普遍提供的 API 网关、身份认证、细粒度权限管理、日志与审计等通用能力,可以作为上述基础设施的现成构件,团队按需选用即可——重点是能力到位,而非特定产品。
从 UI 优先向 Agent 优先演进,通常不是重写系统,而是补齐机器可调用所需的成熟能力。以下事项建议逐项评估:
一个幂等写接口的通用示意:
POST /ordersHeaders:Idempotency-Key: <任务唯一标识>Authorization: Bearer <委托令牌,限定最小权限范围>Body:{ "action": "create", "payload": { ... } }Responses:200 { "status": "created", "receipt_id": "..." } # 首次执行成功200 { "status": "duplicated", "receipt_id": "..." } # 同键重复请求,返回原回执403 { "error": "PERMISSION_DENIED", "hint": "缺少 create 动作授权" }429 { "error": "RATE_LIMITED", "retry_after": 30 }
回到最初的对比:UI 优先架构与 Agent 优先架构的本质差异,不在界面有无,而在调用方与价值沉淀位置的改变。当主要用户从人变成 Agent,体验、习惯与品牌构成的传统壁垒会被绕过;数据权威性、API 完备性、语义质量、信任体系与结果可验证性,成为新的护城河来源。
对技术决策者而言,判断思路可以归纳为三步:先盘点系统记录的数据权威性与 API 覆盖度,再评估权限委托与审计能力是否支撑自动化,最后据此决定界面与接口之间的投入比例。这不是“界面无用”的绝对结论,而是一次防御逻辑的重定位——界面从产品的头颅,退为监督的窗口;系统记录与接口契约,才是躯干与神经。