把 Agent 接进老系统：企业集成最难的六类接口

企业 PoC 阶段一切顺利，一进生产就卡住。卡点通常不在 AI 侧，而在那些「能用但不友好」的老系统上。

一、六类最难对接的接口

1. 只有界面没有 API

典型：老版本 ERP、行业专用软件、部分财务系统。绕行优先级：官方 API > 数据库只读视图 > 厂商中间表/文件交换 > 浏览器自动化。最后一档慎用——RPA 在 Agent 高频调用下，界面改版、弹窗、超时都会让它卡死。

2. 有 API 但语义不清

接口叫 queryData，12 个参数，文档只有一页截图。直接包给模型是最坏的选择，它会瞎猜参数。正确做法是为每个接口写一层业务语义包装，暴露给 Agent 的是「查客户最近三个月订单」，而不是 queryData(custNo, dt1, dt2, flag=...)。

3. 分页与总量不一致

老系统分页常有 bug：total 不准、最后一页重复、offset 越界返回全量。Agent 拿到这种数据会得出错误结论。前置层必须去重和边界处理，并显式标注「结果可能不完整」。

4. 鉴权模型不兼容

难点是权限降级：Agent 不能拿用户全部权限，也不能拿超级账号。可行做法是双层——用服务账号调用，同时透传终端用户身份，由业务系统做权限校验。

5. 写操作的幂等和事务

创建工单 被重试三次，生成三张工单。老系统往往既没有幂等键也没有事务边界。必须在中台层做幂等表：外部请求带幂等键 → 查重 → 只放行一次。这是硬要求，不能靠提示词让模型「小心一点」。

6. 数据格式的隐性约定

日期是 20260426 还是 2026/04/26？金额是元还是分？空值是 null、空串还是 "NULL"？这些不写进文档，Agent 一定踩。维护一份字段规约文件，并作为工具描述的一部分提供给模型。

二、组织上的一个建议

不要指望 AI 团队打通老系统。集成层的活应由熟悉老系统的业务开发来做，AI 团队只定义工具契约。实践中失败的项目，大多是想让 AI 团队顺便把 ERP 也搞明白。

三、进度怎么估

粗糙但准确的经验：模型选型和提示工程 2 周；工具开发和联调每个老系统 3~6 周；权限与审计打通 2~4 周；灰度验收 4 周以上。比例大概是 1:10。

规划时若把这个比例反过来估，项目一定会延期。企业 AI 落地的成本，主要在不懂 AI 的那一侧。