AI Agent 工程 · 11
11.1 企业系统集成：API、Webhook 与幂等边界
用模拟订单与工单接口理解认证、超时、重试和数据同步。
目标与原理
企业集成不是让模型直接登录 Shopify 或 ERP，而是受控应用通过 **API（应用程序接口）**读取订单、创建工单，再用 Webhook（事件回调）接收异步变更。前置 10 Database：所有请求必须认证、授权、超时可见，并以幂等键抵抗重试。
客服 Agent → 应用 API（身份/权限）→ 订单系统 → 工单 → 模拟通知
↓ 超时/错误/重复请求
实践与验收
运行 npm run test:agent-course。V5 的 apiCreateTicket 验证越权 403、重复 key 复用结果、超时 504；它没有调用真实 Shopify 或飞书。真实接口应按各供应商的 OAuth、Webhook 签名与版本文档实现。排查：不要把超时当作“订单不存在”，重试需沿用幂等键。
主动回忆：为什么认证通过后仍必须按 merchant/customer 授权？
- 必须记：重试与幂等是一对。
- 建议记：Webhook 输入也要验签和去重。
- 不用记：示例状态码。