
UCP 资料是一个公开的 JSON 文件,用来告诉 AI 购物智能体您的店铺能做什么:支持哪些能力、端点在哪里、如何处理支付。您需要把它托管在 /.well-known/ucp 这个路径下,放在您的域名上,Google 会读取它,以决定智能体如何搜索、填充购物车并完成结账。UCP,即 Universal Commerce Protocol,是 Google 面向智能体结账的开放标准。虽然很多人会搜索“product profile”,但实际上并不存在单独的“商品资料”:商品本身在您的 feed 和商品目录里,资料描述的是承载这些商品的店铺能力。
无论人们用 Google 搜索、去 Amazon,还是询问聊天机器人,如今 AI 都会给出包含商品的回答,而大多数电商品牌不知道如何让自己的商品成为 AI 选中的那个。真正让人意外的是,智能体根本不会看您的首页,它读的是一个文件。我觉得这是这十年来最有意思的改版需求:网站上最重要的页面,如今成了一个您永远不会为它设计样式的页面。
要点速览
- UCP 资料是一个 JSON 文件,位于
/.well-known/ucp,用于声明您支持的能力、版本、端点、支付处理方式和公钥。 - 它必须是公开可访问的,前面不能有登录。智能体拿不到文件,就无法与之协商。
- 只声明您的店铺确实支持的内容。版本和能力由商家选择,所以夸大支持范围会导致结账失败。
- profile 是入口。商品信息流、商品目录和结构化数据,才是智能体进入后真正读取的内容,而大多数商店恰恰输在这里。
- 先用 validator 检查文件,再完整跑一遍测试购买流程,然后才能算完成。
UCP 资料到底是什么
Google 的文档将该资料描述为一个 JSON 文件 ,托管在您服务器上约定的标准路径中, 用于公开声明您的服务器能做什么,以便 Google 与其协商能力。可以把它理解为一张商务名片:智能体在尝试购买任何商品之前,会先读这张名片。名片上写着:我支持这些能力;这里是调用我的地址;我是这样处理支付的;这些密钥可以用来验证消息确实来自我。
协商这一步很关键。按照 Google 的指南,选择协议版本和能力的是商家,而不是智能体;商家会从自身资料与智能体资料的交集中做选择。UCP 社区将这视为一项有意为之的设计选择: 平台和商家在本地协商 而不是向某个中心化的把关方登记。这对商家是好事。但也意味着不会有人替您修好这个文件。
如果想了解更广泛的背景,弄清 UCP 如何在智能体与商家服务器之间选择兼容能力, 电商中的 AI 应用案例 展示了这在商店当前使用 AI 的其他方式中处于什么位置。
文件中包含哪些内容
Google 关于 创建 UCP 配置文件 的实现指南列出了其结构。通俗地说:
ucp 对象保存协议元数据:版本、提供的服务以及支持的能力。指南中的示例列出了一个购物服务端点,地址是 https://business.example.com/ucp/v1,这其实就是智能体发起购物相关调用的地址。支付配置与 ucp 对象并列,而不是放在其中。另外还有一个 signing_keys 数组:采用 JWK 格式的公钥,用于验证来自您的服务器的 webhook 和其他已认证消息上的签名。
因此,这个文件主要承担四项工作:
| 配置文件中的部分 | 它向智能体说明什么 | 为什么这很重要 |
|---|---|---|
| 能力与版本 | 您支持哪些功能,以及使用哪些规范和 schema 版本 | 如果声明过多,智能体就会尝试执行商店实际上做不到的事 |
| 服务端点 | 搜索、购物车和结账请求应发送到哪里 | 地址错了,结账流程就会中断 |
| 支付处理 | 订单的支付如何配置 | 很多智能体结账就是在这里悄无声息地失败 |
| 公开签名密钥 | 如何验证来自您的服务器的消息 | 没有它们,就无法信任带签名的消息 |
注意这里缺了什么:价格、标题、描述、图片。这些都不在配置文件里。
您的商品在其中处于什么位置
资料说明智能体如何与您完成购物;商品数据说明它可以买什么。这是两个独立层次,而把两者混为一谈,是我最常见到的误区。
智能体会读取您的商品 feed、商品目录以及商品页面上的结构化数据。它正是通过这些内容了解商品标题、属性、库存情况和价格。如果这些数据过于单薄、模糊或有错误,即使资料本身毫无问题,也只会把智能体带到一家它不会选择购买的商店。
我们已经看到这件事有多重要。到 2026 年 10 月,我们已在 ecentic 中运行了 36,797 次模拟购买;在同一商品目录上,ChatGPT 选择商品的频率大约是 Claude 或 Gemini 的 3 倍(51.6%,而后两者约为 18.5%)。同样的商品,不同的智能体,结果会非常不同。在一次针对某烈酒交易平台的匿名检测中,该平台年销售额约 €70M,其 9,699 个商品中有 88% 在智能体读取的数据上存在问题;当让智能体回答“两瓶该店有货的酒该去哪里买”时,20 次提问中这家商店出现了 0 次。无论配置文件多完善,那家商店都是不可见的。
结论是:资料要发布,但不要止步于此。关于“读取”这一侧,我们在这里有更深入的说明: AI 购物智能体如何推荐您的商品.

如何发布您的 UCP 配置文件
具体操作并不复杂。真正需要思考的是第 1 步。
- 先确定自己真正支持什么。 列出商店当前真正能处理的能力,而不是路线图上的能力。Google 的指导是:只声明您的实现当前支持的内容。
- 编写 JSON。 按照 Google 的 配置文件指南.
- 托管在
/.well-known/ucp. 路径位于您自己的域名下,因此yourstore.com/.well-known/ucp应返回该文件。 - 设为公开访问。 前面不要加登录、密码或机器人验证。Google 表示必须无需身份验证即可访问。
- 进行验证。 先在浏览器中打开该 URL,再用检查工具验证(下文会详细介绍)。
- 测试完整购买流程。 在真实用户使用前,先让智能体完成一次从商品目录搜索到支付完成的全流程。
在托管平台上,第 3 步最容易出问题。并非所有平台都允许自由提供 /.well-known/ 路径下的文件,因此最好尽早确认,而不是等到上线当天晚上 11 点才发现问题。
Shopify 与 WooCommerce
这两个平台的区别在于谁来承担主要工作。
在 Shopify 上,配置文件和结账基础设施主要由 Shopify 负责,您剩下的工作基本集中在商品数据。这正是 ecentic 的作用:它连接您的店铺,让 ChatGPT、Claude 和 Gemini 将每个商品与指定竞品进行对比,并显示您的商品为何落选。点击“应用”后,它会重写标题、描述和结构化数据并发布到店铺,然后同步修复内容到 Google Merchant Center,并跟踪来自 AI 助手的访问。我们的 Shopify 页面 有详细说明。
在 WooCommerce 上,不要默认核心安装已经支持 UCP。完整集成需要在 WooCommerce 与 UCP 规范之间增加一层。对我们来说,这层就是免费的 ecentic 插件,它让智能体能够通过 UCP 搜索商品、填充购物车并完成结账。请查看 WooCommerce 页面 了解它如何适配您的店铺。
需要说明的是:目前只有美国的 Google AI Mode 和 Gemini 已支持在 AI 回答内直接购买。ChatGPT 仍会将用户跳转到您店铺自己的结账页面。因此,UCP 主要针对 Google 这一侧,而在其他场景中,真正发挥作用的仍是您的商品数据。

如何检查您的配置文件是否正常工作
按以下顺序进行三项检查。
首先,访问它。打开 /.well-known/ucp 并在浏览器隐私窗口中访问。如果无需登录即可看到 JSON,“公开访问”测试就通过了。如果跳转到登录页或防火墙页面,那就是您的问题。
其次,像智能体一样读取它。声明的能力是否与您的店铺实际能力一致?版本是否正确?端点是否在线?支付处理是否存在?公钥是否齐全?一个声明了结账无法完成能力的配置文件,比一个能力较少但真实可靠的配置文件更糟。
第三,用验证工具检查它。我们的 免费 UCP 验证工具 可以帮您检查该文件。也有其他免费的检查工具,例如 UCPtools 和 UCPList。如果您想获得第二意见,或者希望在文件出错时通过 CI 阻止构建,它们也是不错的选择。我会同时运行两个。
然后测试真正重要的部分:一次购买。我们的 UCP Playground 可以让您把 AI 购物智能体指向某个店铺,查看实际会发生什么。构建更复杂流程的团队,往往会借鉴其他已经成熟验证长用户旅程的领域,例如 全渠道联络中心测试,只有完整路径全部跑通后,流程才会被视为正式上线。
一个真实案例说明了这一点为何重要。在对某瑞典护肤品牌进行的一次匿名检测中,AI 购物智能体在 6 个国家的结账流程中有 0 个进入支付环节,原因只是配送设置要求填写电话号码。智能体无法提供电话号码,于是流程中断。配置文件本身没有问题,问题出在结账流程。
会导致智能体结账失败的错误
大多数失败原因其实都很普通,这反而是好消息,因为普通问题通常都能修复。
文件被放在身份验证或机器人过滤之后,导致智能体只能看到登录页面。配置文件声明了店铺实际上无法完成的能力。端点指向了某个被遗忘的测试环境地址。支付设置默认由真人填写,包含智能体无法填写的必填字段。文件更新后缓存副本没有及时刷新,因此更新文件时值得检查缓存头。还有商品 feed 数据不完整,结果智能体来了,看了一眼,转头选择了竞品。
最后这一种才是隐形杀手。配置文件失败很明显:结账会报错,您能定位问题。数据失败则是无声的:您只是始终没有被选中,而且没有任何仪表盘会提醒您。
我们的看法
我认为,接下来一年行业会花大量时间讨论协议,却忽略那些枯燥但关键的中间环节。每个人都想解释 UCP,但很少有人愿意真正打开商品 feed,看看里面到底有什么。
我们的看法是这样的。智能体分两个阶段做决定。第一步,它会问:我能否在这个店铺完成购买?这对应配置文件和结账流程。第二步,它会问:我该选哪个商品?这对应标题、描述和结构化数据。只修复其中一部分而忽略另一部分,就像给一家没人进门的店铺做了一个优秀的结账流程。
这也是 ecentic 聚焦店铺本身的原因:商品 feed、商品目录,以及智能体实际用来购买的结账流程。普通 feed 工具只停留在数据层面,而我们继续深入到智能体真正能完成购买的环节。在美国的 Google AI Mode 和 Gemini 中,这意味着 UCP,而这正是 feed 工具通常不涉及的部分。
OpenAI 有 ACP,Google 有 UCP,Amazon 则建立了自己的壁垒。商家无法只选一种协议后高枕无忧。我更希望他们把时间投入到所有智能体都会读取的商品数据上,并在某种协议真正适用于其市场时,再把它当作需要打开的一扇门。
需要说明的是:我们目前尚未产生收入,并且正在进行试点。我们的首个客户 DUA Flavours 在 2026 年 4 月到 7 月期间,来自 AI 助手和直接流量的访问量提升了 12%。这里说的是访问量,不是销售额,我不会把它描述得超出事实。
Xhurian Shaba
当 AI 负责购物时拿下订单
如果您想在接触 JSON 文件之前先了解商品当前表现,可以先试试免费扫描。它覆盖您的前 10 个商品,无需绑定银行卡。它会展示智能体如何将您的商品与指定竞品进行对比,以及您为何落选。
当您准备修复发现的问题时,Compete 每月 14.90 USD,支持最多 100 个商品。Scale 每月 44.90 USD,支持最多 1,000 个商品,并提供一键修复。Dominate 每月 149 USD,增加 Google Merchant Center 同步和智能体结账配置。更希望按效果付费?按使用量计费模式收取 AI 归因订单金额的 3%,每月上限 $500。所有内容都可在 ecentic 定价页面.

想先从成本最低的问题开始?我们的 WebMCP 购物检测 免费提供,而 功能概览 会展示其余功能。
FAQ
UCP 商品配置文件与商品 feed 是同一回事吗?
不是。UCP 配置文件描述的是您店铺的能力、端点、支付处理和密钥。商品 feed 和商品目录描述的则是商品本身。智能体两者都需要:配置文件用于了解如何在您的店铺购物,feed 用于决定选择哪个商品。
UCP 配置文件应该放在哪里?
请将其托管在您自己的域名下,路径为 /.well-known/ucp,并确保无需身份验证即可公开访问。Google 的 配置文件指南 说明了相关要求。如果您的平台限制该路径,请优先解决这个问题。
ecentic 会生成我的 UCP 配置文件吗?
不会。ecentic 不生成 UCP 配置文件。我们的免费 UCP 验证工具 可以检查配置文件;而在 WooCommerce 上,免费的 ecentic 插件可让智能体通过 UCP 搜索商品、填充购物车并完成结账。在所有平台上,点击“应用”后,ecentic 都会重写商品标题、描述和结构化数据。
如果我只关心 ChatGPT,还需要 UCP 配置文件吗?
对于结账流程来说,不需要。ChatGPT 会把用户跳转到您店铺自己的结账页面,因此真正关键的是商品数据。UCP 则关系到 Google AI Mode 和 Gemini 中的站内购买功能,目前该功能已在美国上线。强大的商品数据在这两种场景中都很重要。