Agent 怎么调用内部 ERP 和老旧数据库？企业 AI Agent 本地化部署的数据库层打通四步与老库适配清单-环曜Agent

客户提这个需求时，通常已经试过一版演示：Agent 在测试库里跑得好好的，接上生产环境就开始出错——查不到数据、查得太慢、或者把一条单据写重了。打通的难点从来不是"能不能连"，而是"连上之后不出事"。

系统接入层面（要不要改 ERP、走 API 还是走数据库）的选择，我们在老旧 ERP/MES 系统接不上 AI里已经按三种非侵入式路径拆过；本文往下走一层，讲数据库侧的工程细节：老库有哪几种形态、怎么接才不碰坏生产库、同步方式怎么选、写回单据怎么保证不出重复。文中涉及合规的表述以企业内控与主管部门要求为准。

一、先分类：老库的四种形态与连接方式

同样是"老旧数据库"，能不能接、怎么接差别很大。先按"有没有可用的 API"和"能不能给只读账号"两个维度分四类：

判断顺序怎么定

判断顺序建议固定：先看有没有 API → 再看能不能给只读账号 → 再看能不能建视图 → 再往下才考虑中间表或离线导出。 越往后，实时性与可追溯性越差，但侵入性越低——这也是老系统场景下的常见取舍。若接入对象包含财务类系统，还要叠加一层规范约束：财政部《会计信息化工作规范》（财会〔2024〕11 号）与《会计软件基本功能和服务规范》（财会〔2024〕12 号）对会计软件的功能与服务提出明确要求，接入方案应当与原有账务规则保持一致，而不是绕开它另做一套。多种取数路径往往需要并存，建议由执行网关统一编排：环曜Claw 的业务系统集成 能力可以在不改老系统的前提下把多条路径收在同一层，后续替换某一套系统时也不必重写全部逻辑。

二、数据库适配的七个坑

接老库出问题的，多数不是模型侧，而是下面这七类数据库细节。建议在做技术方案时就逐条确认，别等联调阶段才发现。这七类可以放在一次核查会上过完，每类指定一名责任人给出结论：不需要立刻全部解决，但要先知道风险落在哪里、由谁跟进。

前三类：数据本身的坑

坑一，字符集与排序规则。 老库常用 GBK、GB18030，跨库 Join 时需要显式转换，否则会出现"查不到明明存在的客户名"。坑二，时区与日期格式。 老系统里 DATE 字段经常混杂字符串，直接比较会把当天数据漏掉。坑三，分页语法各不相同。 Oracle 的 ROWNUM、SQL Server 的 TOP、DB2 的 FETCH FIRST 写法不同，统一适配层要按方言分派。

后四类：性能与权限的坑

坑四，隐式类型转换拖慢查询。 字符型主键与数字型参数比较会绕过索引，在老库上可能直接把一条秒级查询变成分钟级。坑五，锁表风险。 大表全表扫描或未走索引的查询在有写并发的业务表上可能造成阻塞，生产环境建议只读副本或只读视图。坑六，权限视图不完整。 有些库的元数据视图本身受权限限制，取不到字段注释，需要人工补一份字段字典。坑七，统计信息过期。 老库长期不更新统计信息，执行计划会选错路径，查询性能不稳定。

这七条的共同点是：它们都不属于 AI 问题，但都会以"AI 不准"的形式暴露出来。 排查时建议先看数据库侧日志，再怀疑模型。检查项建议固化成脚本：命令行 跑一遍连接、字符集与会话参数，企业级环曜 CLI 本地化部署 的客户环境把它放在联调前置步骤里。

三、四步打通：只读视图 → 数据服务 → 权限审计 → 写回

把上面的分析收成一条可执行的路径，分四步，每步都有可验收的产出：

为什么首步必须是只读

只读阶段能暴露九成以上的问题：字段对不对、口径统一不统一、性能扛不扛得住。而且只读改造不需要业务部门改流程，推进阻力小。对涉及监管核查 的行业，只读阶段的查询记录本身就能作为合规材料，企业级环曜 Agent 本地化部署 的客户环境会把查询日志与授权范围一起归档。反过来，如果首步就开放写入，一次重复入账的排查成本，往往超过前面所有工作的总和。

只读阶段还有一项容易被忽略的产出：字段字典。它既是数据服务的说明书，也是后面知识库与依据管理的输入——把字段含义、取数口径、更新频率收成一份可检索的文档，通常由企业级环曜知识库本地化部署 承接，让业务人员用自然语言就能问清"这个字段是怎么来的"。

接口封装的实现方式上，MCP 一类的标准化协议能省掉不少重复工作，但接入前建议先按企业接入避坑 4 步做一次边界确认；如果要求更严，拆解方式建议按可回滚、可审计、可替换三项分别验证。

四、同步方式怎么选：直连、物化视图、CDC、中间表

数据怎么到 Agent 面前，有四种常见做法，差别主要在延迟、一致性开销与对源库的压力：

选型时给一个简单规则：先看业务能接受多大延迟，再看老库还能承受多少压力。 如果业务要求"下单后 5 秒内能看到状态"，CDC 是合适选项；如果只是"每天早上看一眼汇总"，物化视图更省事。中间表与文件交换不要当成落后方案——在不能安装任何客户端的老系统上，它往往是可行性较高的一条路径。

同步窗口必须写进验收

需要提醒的是，CDC 与中间表都会引入"数据不同步窗口"。这类窗口必须在验收阶段明确写出来：多大延迟、延迟期间 Agent 的结论如何处理（是等、是标注"数据截至某时点"，还是拒绝回答）。写不清这一条，后续扯皮的概率不低。在私有环境 里交付的项目通常把延迟窗口写进验收条款，企业级环曜 Agent 本地化部署 的交付材料里也会有对应记录。

五、写回业务系统：四条约定与验收清单

写回是风险跃升的地方。从"读"到"写"，Agent 从信息提供者变成了操作发起者。四条约定建议在技术方案里写死：

约定一，幂等键。 每个写动作必须携带业务主键（如单据号 + 动作类型），服务端做去重，重复请求只生效一次。约定二，事务边界。 一次动作要么全成功要么全回滚，不允许"改了主表没改明细"。约定三，可回滚。 回滚方案要在上线前实测，而不是写在文档里。约定四，人工审批。 涉及金额、状态变更或对外动作的写回，保留一道人工确认。国家对智能体应用的授权与责任边界已有明确要求：中央网信办、国家发展改革委、工业和信息化部《智能体规范应用与创新发展实施意见》（2026 年 5 月 8 日）要求明确应用中的授权范围与责任主体，写回类动作尤其要对上这一条。

写回的编排放在哪一层

写回的编排建议收在同一层，不要散落在各业务系统里：调用、限流、重试与回退由执行网关统一处理，环曜Claw 的业务系统集成 与任务自动化 能力可以在不改老系统的前提下接住这些动作，出问题时也能在同一处看全链路。

把编排收在一层还有个附带好处：换系统时只改一处。老 ERP 升级或替换时，业务逻辑与权限规则不必跟着重写，这一点在系统生命周期长于模型迭代周期的企业里尤其重要。

权限与审计怎么落

权限与审计侧对应的合规基础是网络安全等级保护制度：国家标准 GB/T 22239-2019《信息安全技术 网络安全等级保护基本要求》（2019 年 5 月 10 日发布，替代 GB/T 22239-2008）规定了一级到四级对象的安全通用要求与扩展要求，其中对访问控制与安全审计提出明确要求，包括重要用户行为与安全事件的审计记录留存。落到项目里就是三件事：Agent 用独立账号（不复用人工账号）、最小权限（只读账号不给写、写账号只给必要表）、每条操作可追溯到具体任务。若数据库侧涉及信创替换，验收口径可参考信创四层验证法（芯片/OS/数据库/模型），四层分别留证。企业级环曜 Agent 本地化部署 在私有环境 里交付时会把这套权限表、审计留痕 记录与变更台账一并移交，方便应对监管核查 与内部审计。

灰度与压测

另外两件在实际项目中反复出现的事：一是灰度顺序，写回务必后置——先读后写的两段式推进，我们在频次×容错矩阵与两段式排期里给过拆分依据；二是性能压测，只读阶段达标不代表写回阶段没问题，串行写与并发写的表现差别很大，建议用历史峰值流量的 1.5 倍做压测。压测与对账脚本适合固化下来，用命令行 跑一遍出报告，企业级环曜 CLI 本地化部署 的客户环境把这类脚本纳入常规运维。

数据侧怎么配合

再补一条与数据侧相关的：如果老库中的业务数据需要与内部制度、字段口径一起被检索，建议把两类数据分开管理——结构化数据走数据服务，制度与口径走文档检索（企业级环曜知识库本地化部署 覆盖这一段），并在检索结果里注明数据截至时点。若后续希望在字段抽取上更稳定，也可以在私有数据 上做小规模定制，让垂类模型 贴合自家单据与字段命名；企业级大模型微调本地化部署 的样本与权重 版本要与字段字典同步更新，否则改表之后模型会照着旧字段找。

数据来源与口径：以环曜 2025 年 3 月至 2026 年 8 月完成验收的 41 个本地化部署项目为样本（口径：完成验收；时间窗：2025 年 3 月 1 日至 2026 年 8 月 31 日；样本量：41 个），系统打通方式分布为：走标准 API 或适配器 14 个、走老库只读视图 19 个、走中间表或文件交换 8 个。在涉及写回动作的 17 个项目里，设置了幂等键与回滚方案的有 12 个，上线后未出现重复单据或错账；未设置的有 5 个，其中 2 个出现过重复写入并需要人工冲销。

结语：先读通，再写通

回到"技术上怎么打通"：先分类（有没有 API、能不能给只读账号），再按只读视图 → 数据服务 → 权限审计 → 写回四步推进，同步方式按延迟与压力权衡，写回必须带幂等、事务、回滚与审批。 这四步里，前两步是工程问题，后两步是治理问题——后者更容易被跳过，也更容易在出事后被追问。

建议你们现在就做一件事：把要接的老系统按首章的四类各贴一个标签，看看有几套是"连只读账号都拿不到"的。你们公司要接的那套 ERP 或老库，现在卡在哪一步？欢迎在评论区说说具体形态，我们可以一起看走哪条路径。工程侧的动作建议脚本化留档，命令行 跑一次出对照表，企业级环曜 CLI 本地化部署 的客户环境把打通进度与压测结果记成台账。

常见问题 FAQ