返回知识库
Agent 购物

UCP 协议配置指南:让 Google AI Agent 发现你的商品

2026-01-17
12 分钟

什么是 UCP?

UCP(Universal Commerce Protocol)是 Google 在 2026 年 1 月发布的开放购物协议。它定义了 AI Agent 与电商系统之间的标准通信方式。

UCP 文件结构

UCP 配置文件位于 /.well-known/ucp,是一个 JSON 格式的文件:

{
  "version": "1.0",
  "merchant": {
    "name": "Your Brand",
    "domain": "yourbrand.com",
    "merchant_center_id": "123456789"
  },
  "capabilities": [
    "discovery",
    "checkout",
    "order_tracking",
    "customer_service"
  ],
  "endpoints": {
    "product_catalog": "https://yourbrand.com/products.xml",
    "checkout": "https://yourbrand.com/api/checkout"
  }
}

配置步骤

1. 创建配置文件

使用 GeoAction 的 Agent 配置生成器,填写你的商家信息,自动生成 UCP 配置文件。

2. 上传到 .well-known 目录

将生成的文件上传到你网站的 /.well-known/ucp 路径。

对于不同平台:

  • Shopify:使用 Files 功能或创建一个重定向
  • WordPress:上传到根目录或使用插件
  • 自建站:直接放到 public 或 static 目录
  • 3. 配置 Merchant Center

    如果你有 Google Merchant Center 账号,确保:

  • 产品数据已同步
  • 账号已验证
  • 域名已关联
  • 4. 验证配置

    访问 https://yourdomain.com/.well-known/ucp 确认文件可访问。

    然后使用 GeoAction GEO 诊断工具验证配置是否被正确检测。

    能力说明

    能力说明要求
    discovery商品发现提供 Product Feed URL
    checkout在线结账实现 Checkout API
    order_tracking订单追踪实现 Order Status API
    customer_service客户服务提供联系方式

    最佳实践

  • 从 discovery 开始:先让 AI 能发现你的商品
  • 保持数据同步:确保 Product Feed 实时更新
  • 测试结账流程:在启用 checkout 前充分测试
  • 监控性能:追踪来自 AI Agent 的流量和转化
  • 常见问题

    Q: 需要 Merchant Center 账号吗?

    A: 不是必须的,但有 Merchant Center 可以获得更好的商品展示效果。

    Q: 文件格式必须是 JSON 吗?

    A: 是的,UCP 规范要求使用 JSON 格式。

    Q: 支持哪些国家/地区?

    A: 目前主要在美国试点,但建议全球商家都开始准备。