设想一下,你的顾客不再是一个在浏览器中点来点去的人类,而是一个代表真实用户进行搜索、比较并最终完成购买的 AI 智能体。这样的场景已不再是遥远的未来——而这个智能体向你的网站提出的第一个问题就是:「你能听懂我的语言吗?」UCP 协议正是对这个问题的回答。
UCP 到底是什么?
通用商务协议(Universal Commerce Protocol,简称 UCP)是一个开放标准,允许企业以结构化、机器可读的形式发布自己的商业能力——产品搜索、库存查询、购物车和结账。正如 robots.txt 文件告诉搜索引擎应抓取网站的哪些部分,或 sitemap.xml 为它们提供页面地图一样,UCP 文件为 AI 智能体提供了一份商业路线图。
为什么企业需要 UCP?
AI 智能体在解析为人眼设计的 HTML 页面时表现不佳。JavaScript 按钮、弹窗和视觉布局是为人类浏览器设计的,而非为程序化调用而生。当一家商店为智能体提供一个干净、标准的端点时,其产品被发现、比较和购买的概率会显著提高。
- 可发现性:智能体确切知道该去哪里寻找你的能力(
/.well-known/ucp) - 更高的准确性:结构化数据意味着价格、库存和产品规格上的错误更少
- 先发优势:率先采用者将在智能体的结果中获得最多的曝光
- 标准化:无需为每个智能体单独构建 API,只需实现一次,所有人都能理解
ucp.json 文件的结构
主 UCP 文件必须能在 https://yoursite.com/.well-known/ucp 访问,并以 JSON 格式响应。这个路径是智能体总会首先检查的标准位置——就如同搜索引擎对待 robots.txt 一样。
文件的主要字段
- protocol — 协议版本,例如
ucp/v1 - merchant_name — 你的企业名称
- description — 关于你业务的简短描述
- website — 网站主地址
- capabilities — 智能体可以调用的能力列表
- payment_methods — 支持的支付方式
- supported_languages 和 currency — 语言和货币
什么是能力(Capabilities)?
UCP 中的每一项能力都是一个包含四个部分的小对象:名称、描述、端点地址和 HTTP 方法。通过读取这些信息,智能体可以准确了解应如何发起请求以及期望得到怎样的响应,而无需单独的文档或猜测。
search_offers— 搜索产品或服务get_product_details— 获取产品的完整详情check_inventory— 实时检查库存manage_cart— 添加并管理购物车initiate_checkout— 开始结账流程wallet_balance— 查询内部钱包余额book_appointment— 为服务型企业预约validate_coupon— 验证优惠码
UCP 相比传统商店 API 有什么优势?
大多数商店本身已经拥有 API——但通常是私有的、没有公开文档,且结构随意。问题在于,每个智能体都必须单独「学习」你的 API。UCP 通过一份共享的约定解决了这个问题:一旦一个智能体理解了 UCP 协议,它就能立即与任何实现了同一标准的商店协作——无需任何定制化的培训。
如果一个 AI 智能体无法发现并理解你的企业,那么对该智能体——以及信任它的顾客——而言,你根本就不存在。
如何在你的网站上实施 UCP?
- 在免费的 UCP 生成器中输入你的基本企业信息(名称、地址、描述)
- 选择你的企业类型和所需的能力
- 下载生成的
ucp.json文件和 Schema 代码 - 将该文件准确放置在你主机上的
/.well-known/ucp路径下 - 在后端实现已定义的端点(搜索、购物车、结账等)
- 使用 curl 或 Postman 等工具测试输出,确保 JSON 有效且可访问
关于 UCP 的常见问题
使用 UCP 是免费的吗?
是的。UCP 是一个开放标准,OpenCommerce 上的基础生成器工具面向所有人免费开放。
UCP 对小型商店也适用吗?
与通常的看法恰恰相反,小型企业其实从 UCP 中获益最多;因为无需依赖庞大的营销预算,它们就能直接进入 AI 智能体的决策路径。