基础篇
进阶篇
高频篇
精选篇
手写篇
面经篇
AI 篇
原理篇
每日一题
小程序题库
  • 知识卡片碎片时间过考点
  • 场景篇按分类整理的大前端场景考点
  • 历年面经按年份追踪真实考点
  • 算法题库NEW在线编码即时判题
  • 专项自测100 题快速查漏
  • 前端基础
    • HTTP从报文一路讲到 HTTPS
    • 浏览器渲染、事件循环、进程
    • 计算机基础Linux、网络、操作系统
  • 进阶专项
    • 设计模式23 种模式怎么用
    • 前端系统进阶学习大型项目工程化
    • 前端综合文章长期沉淀的实践文
  • 工程与工具
    • Node学习指南从环境搭建到服务端
    • NPM工作流script、依赖与发布
    • Docker容器化部署上手
    • Canvas图形与动画实战
  • 路线与导图
    • 思维导图知识点全景图
    • 学习路线按图索骥不跑偏
  • 动态
    • 公众号动态公众号历史文章
    • 博客动态站长的技术博客
    • 开发者导航常用工具与文档站
    • AI 热点每日 AI 资讯与动向
AI 工作台
旧版
AIHT
内容
精选全部 AI 动态热点榜AI 日报收藏
分类
模型行业编程产品技术观点开源
更多
Agent 接入
返回首页开发者导航
AIHT
精选 / 资讯详情
8.0
热点
AI SCORE
技术实践2026-11-18 20:29

SaaS 接入 Agent 前先梳理业务 API

dev.to · AI#API设计#MCP#多租户
Editor brief · 编辑速览

文章建议用稳定、带版本的业务 API 承载前端、合作方和 Agent 的调用,由同一领域服务统一处理授权、租户隔离、输入校验和事务。MCP 适配层负责向 Agent 暴露可发现的能力。

文章思维导图
Knowledge map
拖拽缩放
AI deep read

AI 深度解读

给 SaaS 接上 MCP,并不等于它已经能安全地交给 AI agent 使用。原文的核心判断是:先把业务能力做成稳定、有版本、能鉴权且经得起重试的 API,再考虑让模型调用。否则,原来藏在界面后面的权限漏洞和重复写入问题,只会多一个触发入口。

这篇值得读的地方,是把「接入 agent」拆成了程序员熟悉的工程问题:业务逻辑放在哪、租户怎么隔离、请求重发怎么办、下游系统挂了如何恢复。它也给出了一份 90 天路线图。不过,这是一篇带服务推广的架构建议,不能当成经过对照验证的实施报告。

三种调用入口,为什么要共用一套业务规则

原文所说的 API-first,是先定义稳定、带版本的业务契约,再把能力开放给 Web UI、企业集成和 AI agent。契约不只是请求字段,还包括权限、状态变化、错误和返回结果。

作者认为,多数 SaaS 不需要重写,而是要把困在 UI handler 或遗留服务里的高价值流程提取出来。这是架构主张,原文没有提供样本证明「多数」的适用范围。

对前端和全栈开发者,关键区别在于:按钮点击后的校验、合作伙伴接口里的校验、agent 工具里的校验,不能各写一份。三个入口应经过 API gateway、身份与租户策略,最终调用同一套领域服务,再通过事件对接 CRM / ERP。

业务规则应该跟着业务动作走,而不是跟着调用入口走。

因此,接口应表达 create_invoice_draft,而不是 update_invoice_table。前者承诺「创建发票草稿」的业务结果;后者把修改数据表的能力暴露出去,却没交代哪些修改合法。

契约还需要明确:输入采用类型约束和字段校验;权限同时包含 OAuth scopes 与记录级授权;行为包含幂等重试、状态转换和错误说明;输出提供稳定 ID、状态和下一步。变更则由 OpenAPI specifications、schema tests 和弃用策略约束。

创建草稿,怎样才能经得起重试和越权

原文最具体的例子,是让 agent 创建发票草稿,而不是直接触发收费。请求如下:

POST /v1/invoice-drafts HTTP/1.1
Authorization: Bearer <delegated_token>
Idempotency-Key: draft-req-7c92
Content-Type: application/json

{
  "customer_id": "cus_42",
  "items": [{"sku": "pro", "quantity": 1}]
}

重点看 Authorization 和 Idempotency-Key:前者承载委托身份,后者用于识别同一次业务请求。

服务端从验证后的 token 推导租户,不能相信请求体自报的租户身份。随后检查 invoice.draft:create 权限,并确认 cus_42 属于该租户。具备创建草稿的权限,不代表能给任意客户创建草稿。

幂等性解决的是重复请求:同一个请求重试,应返回原来的草稿;同一个 key 携带不同 payload,应返回 409 Conflict。作者要求原子地保存幂等结果,但没有展开并发控制、记录有效期和实现方式,这些仍需团队设计。

响应只返回 draft_id、status、approval_required。发送发票另设一个受权限保护的操作,经过策略检查或人工审批后执行,避免创建草稿顺带触发后续动作。

数据库写入成功,也不代表 CRM 已收到更新。作者建议采用事务发件箱(transactional outbox):把待发布事件与业务数据一起提交,再可靠地向下游投递。它处理数据库提交后事件丢失的问题,具体投递与恢复机制仍需实现。

OpenAPI、MCP、A2A 各自该放在哪一层

原文用三个层次解释协议的分工:

  • OpenAPI 描述 HTTP API 的结构与行为,供应用和企业系统集成。
  • Model Context Protocol(MCP)让 AI 客户端发现并调用获准使用的工具,工具背后仍是业务 API。
  • Agent2Agent(A2A)让独立 agent 跨组织交换任务,在确实需要委派时协调工作。

原文提到,2026 年 7 月 MCP specification 引入无状态协议核心和授权改进;AWS 在 2026 年 11 月 12 日演示了企业与 SaaS agent 跨独立云账号协作。这些是原文援引的进展,文章没有给出对应实测数据,也不能据此推导出应该开放所有内部端点。

工具描述帮助模型找到能力,真正的权限必须由服务端执行。

服务端需要同时验证调用应用和被委托用户的权限,对每个资源、每个动作授权,并配备持久化幂等记录、限流、审计和不可逆操作审批。企业采购还可能要求 SSO(SAML/OIDC)、适当的 SCIM 用户预配、签名 webhook、租户级限额以及数据保留规则。MCP authorization specification 只能作为起点。

作者把实施拆成 90 天:第 1–30 天盘点 UI 流程、接口、故障和授权缺口,选一个流程,记录完成率、失败写入、重复操作和集成支持工单基线;第 31–60 天发布 OpenAPI 契约,接入领域服务、委托 OAuth、租户策略、幂等、outbox 及契约和安全测试,确有 AI 客户端需求再开放窄范围 MCP 工具。

第 61–90 天用两个隔离测试租户和一个企业连接器试点,重放写入、撤销 token、触发限流、模拟 CRM 停机并核对审计。扩展条件是重试测试没有重复副作用、负向测试没有跨租户访问,以及满足约定的延迟和恢复目标。原文没有给出具体目标值。

我的判断

我认同它的优先级。对已有 SaaS,把 UI、企业连接器和 agent 接到统一业务能力上,比维护三套授权与状态规则更容易控制一致性。相比直接把内部 CRUD 包装成工具,按业务结果开放少量操作,也更容易界定权限和失败边界。

但共用领域服务不要求所有入口使用完全相同的接口。前端可能需要页面聚合层,企业连接器可能需要批处理;这些适配可以保留,底层业务约束应保持一致。

90 天路线适合作为推进顺序,不能直接当工期承诺。遗留逻辑的耦合程度、现有身份体系和数据质量,都可能改变工作量。原文没有迁移前后的故障率、成本或交付周期对照,因此效果判断仍是经验之谈。

文章后半段推广 Quokka Labs,提到其 15+ 年工程经验、LangProtect,以及产品工程、数据工程和 Ai Native Engineering 服务。这些信息说明文章有商业目的,却不能替代方案有效性的证据。

能拿来做什么

  • 从一个已有 UI 流程入手,检查前端提交后,Node 服务端是否独立完成字段校验、记录归属检查和状态约束,并让其他入口复用这些规则。
  • 给可能被自动重试的写接口定义幂等契约,写清同 key 同 payload、同 key 不同 payload 的行为,再验证并发重试是否产生重复副作用。
  • 为 agent 先开放草稿、预览或其他边界清楚的操作,把发送、收费等后续动作放在独立权限和审批之后。
  • 在试点中准备两个隔离租户,实际执行越权访问、token 撤销、写入重放和下游停机测试,用结果决定是否扩大工具范围。
Original source

本文由 AI 通读原文后重新编写,观点部分为站内判断,细节以原文为准,来源 dev.to · AI,原文版权归原作者所有。

阅读原文
上一篇
小模型微调实验中旧任务困惑度升至156
下一篇
Optimizely 第三方脚本投毒波及178家机构

资讯速览

dev.to · AI · 2026-11-18 20:29

AI 评分 8.0 / 10

相关标签

#API设计#MCP#多租户

继续阅读

  • 用 robots.txt 开放 AI 搜索并限制训练抓取
  • 小模型微调实验中旧任务困惑度升至156
  • Optimizely 第三方脚本投毒波及178家机构
  • Kubernetes 安全补丁也要验证业务行为
  • 蜜罐发现智能体用盗取的密钥支付推理费用