别让 AI 智能体直接调外部 API——5 层工具调用架构 + 25 个 API 契约清单
带客服 Agent 项目这一年最常见的伪架构：『我们让 Agent 直接调订单 / 工单 / 物流 API，接了 25 个，覆盖率高』——然后问「换 OMS 供应商怎么办」答「重写」，问「Mock 联调」答「等真实接口」，问「写操作合规审计」答「自己加日志」。这是没分层。写给正在带企业 Agentic 落地的架构负责人、老板、项目需求方：5 分钟能识破「Agent 直连 API」这个最贵的架构错误，10 分钟能拍板 5 层（Adapter / Service ABC / Tool / Workflow / Critic）的职责边界，20 分钟拿到 6 大外部系统 25 个 API 的分层接入清单 + 5 个本周要推动的架构决策。
May 27, 2026·17分钟阅读