开源购物智能体如何限制下单权限
Open Shopping Agent 优先用站点适配器读取商品,页面变化导致适配器失败时才调用模型。下单授权绑定单个商家和以分计的总价,流程分三处校验,并在提交前重读页面金额。
AI 深度解读
Open Shopping Agent(OSA)能根据一句需求搜索美国零售网站、比较报价、填购物车,最后还能提交订单。作者把付款决定留给用户,把用户看到的结算总额写进审批数据,再让代码在下单前逐层核对。即使总价降了,也要重新确认。
这套设计对做 AI 工具的前端和全栈开发者有参考价值。模型可以读页面,真正涉及花钱的入口却能独立检查。作者也交代了验证边界:363 项离线测试覆盖了模拟环境里的下单路径,真实购买还没有跑通过。
模型负责看页面,谁有权提交订单
OSA 用 MIT 许可证开源,运行 npx open-shopping-agent web 就能打开本地界面,无需账号。你可以让它找一个带 HDMI 的 USB-C 扩展坞,再配一根 6 英尺 HDMI 线,预算低于 60 美元。它会搜索 Amazon、Walmart、eBay、Best Buy、Target 和 Shopify 商店,对比报价并填购物车。
每家店有一个适配器,优先用普通代码读页面。页面改版导致读取失败时,才让 AI 模型接手。适配器负责读页面和执行点击,搜索结果怎么排序、限额怎么算、何时请求审批,都由引擎决定。整套代码只有一个地方调用适配器的 placeOrder()。下面这段把审批校验和同一轮里的重复提交防护放进了这个入口。
// src/core/engine.ts:777-794 (trimmed)
async approve(store: StoreId, approval: Approval, domain?: string): Promise<OrderResult> {
const review = shop ? this.reviews.get(shop.key) : undefined;
const problem = approvalProblem({ store, review, approval, limits: this.limits,
budget: this.budget, placed: this.placedTotal(), ordered: this.ordered });
if (problem || !shop || !review) throw new LimitError("approval", `Order not placed: ${problem ?? "no store"}`);
// Mark first so a second approve() for the same store cannot race this one.
this.ordered.add(store === "shopify" ? `${store}:${shop.domain}` : store);
result = await withTimeout(shop.adapter.placeOrder(shop.ctx, approval), ...);
留意 this.ordered.add(...) 在 await 前面。第二次点击或客户端重试进来时,这轮运行已经记下该店,校验会挡住它。Shopify 用 shopify:<domain> 区分不同店铺。这里解决的是同一轮内的并发提交,代码片段没有交代进程重启后如何处理结果未知的订单。
为什么降价一分钱也要重新确认
用户确认的是眼前这份结算预览。前端据此构造 Approval,里面有 store、带币种且以整数分表示的 approvedTotal、时间戳以及 by: "user"。Web、CLI 和 MCP 共用的会话层先对待确认预览核一次金额,引擎再用纯函数 approvalProblem() 检查业务规则。函数不读页面,也不调接口,给定输入就能直接断言是否放行和用户会看到的错误。
引擎要求 requireApproval === true,审批要对应店铺和本轮由 reviewCheckout 取得的预览。金额和币种必须精确相等。即便变便宜,也可能是换了卖家、少了一件商品,或者配送方式变了。预览默认 20 分钟过期,代码通过 maxReviewAgeMs 控制;审批时间无效,或比预览早超过 5_000 毫秒,也会被拒绝。页面仍需要用户操作、总额为零,或结算明细混进订阅和会员试用,同样会拦截。作者举了 Prime、Walmart+ 和「订阅省」的例子。零元也有可能是适配器把页面读错了,直接放行会让这个错误变成一笔订单。
前两次检查拿到的都是之前保存的预览,店铺页面仍可能变化。Walmart 适配器在点击前重新读取结算页,发现总额变动就结束这次下单。
// src/stores/walmart.ts:517-526
async placeOrder(ctx, approval) {
if (approval.store !== "walmart") throw new Error("approval is for another store");
const review = await walmartCheckoutReview(ctx);
if (review.needsUser) return { store: "walmart", placed: false, needsUser: review.needsUser };
if (!approvalMatches(review.total, approval)) {
return { store: "walmart", placed: false, total: review.total,
error: `Walmart total is now ${formatMoney(review.total)}, approved ${formatMoney(approval.approvedTotal)}; order not placed` };
}
const clicked = await clickFirstVisible(page, ["[data-automation-id=\"place-order-button\"]", ...], 15_000);
关键是 approvalMatches(review.total, approval) 比的是这次从店铺读出的币种和整数分。金额变化按适配器约定返回 { placed: false, error },引擎也会把适配器抛出的异常转换成失败结果。点击函数的 15_000 参数还有一个提醒:重新读取发生在调用点击函数之前,两步之间仍有时间窗口。
本地网页和 MCP 各自要守哪道门
卡号、密码、一次性验证码和 3-D Secure 交给用户在店铺页面处理,也可以使用店铺已保存的卡。适配器没有填写支付或密码字段的代码。本地 AI 回退还会用正则检查控件的无障碍名称,拦住看起来像支付、登录或卡号输入的操作。这层检查依赖页面标签,覆盖有局限。Browsa 托管回退的同类限制写在任务指令里。两种回退都无法调用引擎里的 placeOrder(),这个约束来自代码的调用关系。
MCP 的 place_order 描述要求模型先问人,但店铺页面是模型会读取的不可信输入。OSA 默认关闭 MCP 下单,Claude 或 Cursor 仍能搜索、比价、加购并展示结算预览,用户可以回 Web 或 CLI 完成订单。部署者设置 OSA_MCP_ALLOW_ORDERS 后才能开放下单。它接受 1、true、on、yes,忽略大小写和首尾空白。开放后,approved_total 依旧要精确到分,适配器也依旧会重读结算页。
本地 Web 默认监听 127.0.0.1:4319。作者专门处理了 DNS 重绑定,因为只监听回环地址仍可能收到来自浏览器的非预期请求。无令牌模式会检查 Host,缺失或超出回环范围就返回 403。绑定到非回环地址时,服务启动会生成随机令牌,通过带 HttpOnly、SameSite=Strict 的 Cookie 或 Bearer 请求头接收。修改状态的请求还要通过 Origin 与 Host 的匹配检查。
我的判断
最值得借鉴的是把「用户批准了什么」变成服务端能检查的数据。相比给模型加一句「付款前先问我」,这种做法能把审批规则测清楚,也能让 Web、CLI、MCP 对金额变化给出一致结果。相比只确认预算上限,精确匹配会多打断用户几次,但预算上限适合筛选报价,结算审批还要回答用户同意提交的是哪一笔订单。
这里也有一个缺口。最终重读的代码只展示了对币种和总额的匹配,同价换品或换卖家未必能靠这一步发现。文章也没给出平台侧的原子提交机制,或真实订单在点击超时后如何核对结果。作者做了 363 项离线测试,用模拟环境和保存的页面验证点击路径,所有测试和基准任务都在购买前停止。规则能否挡住这些已知情况有离线验证,真实站点的下单可靠性还没有端到端证据,也没有对照数据能量化这套方案比其他做法稳多少。
能拿来做什么
- 做结算确认弹窗时,从用户当前看到的预览生成审批对象,把店铺、币种和整数分一起提交。服务端发现金额变化就返回最新预览,让用户看到差异后再次确认。
- 在 Node 里把有效期、零金额、币种不符和禁止明细写成纯函数,用表格驱动测试覆盖边界。错误文案直接告诉前端用户该刷新预览,还是先回店铺完成操作。
- 给现有 AI 购物流程接 MCP 时,先开放搜索、比价、加购和结算预览。把下单权限放进部署配置,并让各入口最终汇到同一个审批检查。
- 给本地购物助手做 Web 界面时,将
Host检查放在服务端,并验证审批接口对不符合要求的请求返回403。部署到 Docker 等非回环环境时,再验证令牌和修改状态请求的来源检查。