什么是 UCP 以及如何检查它
最后更新:
UCP——通用商务协议(Universal Commerce Protocol)——是让 AI 助手替商店购物的开放标准。商店在 /.well-known/ucp 发布一份小小的机器可读档案,任何讲这种协议的助手读了它,就能知道商店讲哪个版本、怎样访问它的商品目录和结账、接受哪些支付处理程序——不需要每家商店单独做集成,不需要抓取页面,不需要猜。它解决的正是 llms.txt 为内容解决的问题,只不过对象换成了商务:人读的是店面,机器读的应该是清单。你可以把任何商店粘贴进UCP 检查器,把它的档案读成一个结论——可达、格式良好、版本最新,或根本不是 UCP——但本文教你自己读这份文档,这样下一次某份档案检查失败时,你能在文本里直接看到原因。
什么是 UCP——以及 AI 助手为什么需要它
UCP 是 Google 的开放标准,由 Shopify 联合开发,给 AI 助手提供了一套统一的购物语言:发现商店、搜索商品目录、组装购物车、结账,以及事后跟踪订单。助手通过协议和商店对话,而不是通过每家定制一次的集成;而商家仍然是交易的记录方——按 Google 自己的指南所说,保留自己的客户数据和客户关系。这个标准的意义在于把 N×N 的集成问题压成一次:没有它,每个助手都要和每个商家单独对接;有了它,双方各实现一次,就能彼此互通。
这个需求是新的,因为购物场景是新的。助手现在会在 Google 搜索的 AI Mode 和 Gemini 应用里遇见购物者,一个问题不用打开任何店面标签页就能变成一笔购买。聊天窗口没法点“加入购物车”,所以助手需要一种办法,用机器的语言问商店:你卖什么、怎么买、卖完之后会发生什么。UCP 就是这个办法:它覆盖从发现、结账到售后的完整旅程——订单、履约、折扣——并且被设计成与相邻的传输标准(MCP、A2A)和支付证明标准(AP2)互通,而不是取代它们。
发现文件:/.well-known/ucp 和它的三个必填字段
整个协议从一个文件开始。商家把自己的档案——一个带必填 ucp 成员的 JSON 对象——发布在 /.well-known/ucp,平台在做任何事之前先来取它。在 ucp 里面,三个字段是必填的:version,以日期表示的协议版本;services,商家提供的 API 表面,按反向域名命名,比如 dev.ucp.shopping,每一条把服务和一种传输绑定(REST、MCP、A2A 或 embedded)及一个端点配对;以及 payment_handlers,它接受的支付方式。后两个字段即使为空也必须存在——空对象是一句有效的声明(“我们暂时不提供服务”),缺失字段则是损坏的档案。第四个成员 capabilities 是可选的,但正是它让档案变得有用:它逐项列出各个功能——结账、购物车、订单、目录搜索——每项自带版本、规范和 schema 链接。
这份文件还有托管规则,而且相当严格,事出有因。已发布的档案必须通过 HTTPS 提供、不得重定向,而且必须带 Cache-Control: public 和至少 60 秒的 max-age——绝不能是 private、no-store 或 no-cache。档案是商店稳定不变的身份和能力清单,不是针对某笔交易的响应,所以它就是为了被缓存、被低成本取用而设计的;一次重定向或一条 no-cache 指令,等于告诉平台:发布者没有把这份文档当作协议所期望的那份稳定清单来对待。平台则朝另一个方向公开自己的档案,放在请求的 UCP-Agent 头里,这正是免注册接入得以成立的原因:任何拥有可发现档案的平台,都能和任何拥有档案的商家对话,无需事先注册。
手工读一份真实文档:Allbirds
Shopify 店面默认就会发布 UCP 档案,所以随便哪一家都是现成的例子——以 2026 年 11 月 21 日抓取的 Allbirds 为例。它的 ucp.version 是 "2026-08-25",也就是当前版本;而 supported_versions 对象把两个旧版本——2026-04-08 和 2026-01-23——映射到它 myshopify.com 域名下的版本化档案 URL,这样讲旧版本的客户端仍然可以协商。在 services 下面,dev.ucp.shopping 出现了两次:一次是传输方式为 mcp、端点在 /api/ucp/mcp,一次是 embedded——注意缺席的那一项:没有 rest 条目。商店不必提供每一种传输方式,只需公开它实际运行的那几种。第二个服务 dev.ucp.common 同样通过 MCP 提供。
capabilities 对象是这份文档变得具体的地方。Allbirds 公开了 dev.ucp.shopping.checkout、cart、order、catalog.search 和 catalog.lookup,再加上几个扩展:fulfillment 和 discount,两者都声明自己扩展了 checkout 和 cart,还有 buyer_consent、identity_linking 和一个 permalink 能力。这些名字按设计采用反向域名:dev.ucp.* 归 UCP 管理机构管辖,而 dev.shopify.* 条目——这里是 dev.shopify.catalog 和 dev.shopify.shopping.declared_fields 扩展——属于 Shopify 自己。在 payment_handlers 下面是三个处理程序:com.google.pay、dev.shopify.card 和 dev.shopify.shop_pay,各自带版本、规范和 schema。有一项东西缺席了,而它的缺席没有问题:这份文档没有顶层的 keys 数组。签名密钥是可选的——只有商店签署请求时才会发布——所以一份没有密钥的档案不是损坏的档案。
版本就是日期——而 2026-08-25 打破了一些东西
UCP 的版本就是日历日期,写成 YYYY-MM-DD 的形式,规范对此说得很直白:商家不得在档案里公开非日期的版本字符串,比如 "draft"。当前版本是 2026-08-25;更早的版本通过 supported_versions 继续存在,每一个指向一份完整自足的、属于那个日期的叶子档案。兼容性按精确的版本相等来判定,而不是“越新越好”:平台和商家取双方都支持的版本交集,如果没有共同版本,商家必须回答 version_unsupported。还有一个值得知道的绊脚石:档案里每一条 dev.ucp.* 服务、能力和扩展,都必须声明与档案 ucp.version 相同的版本,平台一旦遇到版本不匹配的条目,必须直接拒绝该条目,把它当作不存在。
这就是为什么旧版本只得到警告,而不是通过。2026-08-25 是这个协议最大的一次结构性改动:它从档案 schema 里删掉了旧的 signing_keys[] 字段,把顶层的 keys[] 数组——一个 JWK Set——定为签名密钥唯一的 canonical 位置,所以为新版本构建的客户端如果还去读 signing_keys,将一无所获;它把支付扩展从 dev.ucp.shopping.* 命名空间移到了 dev.ucp.common.payment.*;它把买家同意(buyer consent)从固定的布尔标志重构成一个动态映射;还合并了履约配置。仍在 2026-04-08 的商店,对讲 2026-04-08 的客户端仍然可用——supported_versions 正是为此而生——但一个只讲新版本的助手将找不到共同版本,而任何按旧名字和旧字段写成的工具都会悄悄错过目标。旧,在 UCP 里意味着“冻结在过去”,而不是“坏了”——而警告正是这两者的区别。
UCP vs ACP vs AP2 vs x402
ACP——Agentic Commerce Protocol(代理商务协议),由 OpenAI 和 Stripe 联合开发——覆盖的是聊天界面内的结账步骤,比如在 ChatGPT 里:买家在对话中批准购买,商家通过自己的支付服务商完成结账。它的范围只是结账,不是完整的购物旅程:它回答的是买家如何在聊天里付款,而把商品目录发现和售后留给别的东西。可以把它理解为 UCP 在 OpenAI 阵地上的平行版本,而 UCP 则是 Google 阵地上的对应物。
AP2——Agent Payments Protocol(代理支付协议),由 Google 发布——回答的是另一个问题:不是结账如何运行,而是用户到底授权了什么。它生成带签名的、可验证的授权书(mandate)——针对购买本身的 checkout mandate 和针对支付环节的 payment mandate——让商家、卡组织和发卡行各自核对同一份证明,而不是只信代理的一面之词。它的设计就是与 UCP 协同工作,在 UCP 流程内部提供带签名的授权,而不是与 UCP 竞争。
x402——由 Coinbase 创建——回答的是第三个问题:代理怎样一次性为一样东西付款,不用账号、不用结账页?它复活了沉睡的 HTTP 402 Payment Required 状态码:代理请求一个付费资源,服务器以 402 和价格作答,代理再带着带签名的付款重试,通常用稳定币在链上结算。它是针对 API、数据和内容的一次性按调用计费——买一次请求正合适,装购物车则形状不对。
这四个是互补的,不是对手,真实系统往往把它们组合使用:UCP 跑购物旅程,AP2 在其中提供带签名的证明,x402 沿途为单次调用计价,ACP 则是 OpenAI 阵地上的结账路径。这也是本站检查器的边界:UCP 检查器只读 UCP 档案,它不取、不验证 ACP、AP2 或 x402 的文档,所以一家商店可以是 UCP-ready,同时完全没有 ACP 或 AP2 的存在——这些协议彼此独立,缺了某一个,并不意味着另一个失败。
UCP 检查器能做什么——以及不能做什么
检查器通过服务器端的检查服务取 https://<目标>/.well-known/ucp——你的浏览器永远不会直接取目标站点,因为跨域规则会挡住大多数商店——然后按规范的方式逐项检查这份档案。它检查文档是否通过 HTTPS 可达、有无重定向(按规范,重定向就是失败),读取 Cache-Control 头并逐字引用它的实际值,解析 JSON,解析失败就报出精确的解析错误,并核对三个必填字段是否齐全、版本是否为日期、版本是否早于 2026-08-25。它逐项列出每个服务及其传输方式和版本、每个支付处理程序、每个能力及其所属服务,并逐个探测声明的端点是否可达。结论只有三种:UCP-ready、部分就绪,或不是 UCP——档案返回 404 是最常见的否定情况,检查器会明确说出来。
它不能做什么,同样重要。它不下单,不以买家身份登录,也不验证支付处理程序的密码学——keys[] 数组的存在只证明来源(这些密钥属于发布它们的域名),不证明可信,规范原文就是这么说的。它不检查 ACP、AP2 或 x402 的文档。而一份干净的结果也不是结账一定成功的保证:档案只是广告,不是交易,它背后的端点仍可能要求认证、买家账号或商家批准,才肯做任何事。干净的检查结果意味着这家商店描述正确、可以被发现;购买能不能完成,仍然是商店自己系统的事。至于更宏观的问题——一个网站是否为智能体做好了准备(发现文件只是其中一个信号)——Agent Readiness Checker 会连同其他信号一起检查。
自己试试:一份最小的 UCP 档案,它的形状本身就是注释
{
"ucp": {
"version": "2026-08-25",
"services": {
"dev.ucp.shopping": [
{
"version": "2026-08-25",
"transport": "rest",
"endpoint": "https://business.example.com/ucp/v1",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/rest.openapi.json"
},
{
"version": "2026-08-25",
"transport": "mcp",
"endpoint": "https://business.example.com/ucp/mcp",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
}
]
},
"capabilities": {
"dev.ucp.shopping.checkout": [
{
"version": "2026-08-25",
"spec": "https://ucp.dev/2026-08-25/specification/shopping/checkout",
"schema": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
}
]
},
"payment_handlers": {
"com.example.processor_tokenizer": [
{
"id": "processor_tokenizer",
"version": "2026-08-25",
"spec": "https://example.com/specs/payments/processor_tokenizer",
"schema": "https://example.com/specs/payments/merchant_tokenizer.json"
}
]
}
}
}