Shopify Agentic Storefronts 的商品数据 QA
看清购物 Agent
找到了什么、漏掉了什么、误解了什么。
ShelfProbe 以真实 UCP Agent 身份查询你的 Shopify Catalog，把每个结果与 Admin 商品数据比对，每条问题都附带查询、响应和判定规则。
高
PIPELINE_PRICE_MISMATCH示例数据价格在 Admin 源数据与 Catalog 返回之间不一致
受影响的查询
“100 美元以内的美利奴羊毛连帽衫”
Admin 源值
- price
- 89.00 USD
- availableForSale
- true
Catalog 实际值
- price
- 109.00 USD
- availableForSale
- true
判定规则
Catalog 返回的价格应与 Admin 最低可售变体价一致。
修复建议
核对该商品在目标市场的价目表与货币设置，改完后复测。
为什么重要
Agent 只能卖它读得懂的商品
ChatGPT、Google AI Mode、Gemini、Copilot 和 Shop 里的购物 Agent 通过 Shopify Catalog 发现商品。Admin 数据与 Catalog 返回之间的差距，会让你损失看不见的销售。
- Agent 找不到的商品本该命中的真实购买意图查询没有返回该商品，或返回了别的商品。
- Agent 误读的属性标题、分类、价格、库存和变体在 Admin 数据与 Catalog 响应之间不一致。
- Agent 买不了的商品已发布的商品在 Catalog 里没有可售变体，或没有有效的购买链接。
工作方式
从探测到可证明的修复
每次扫描都走同一个闭环，你做的每次修改都能和上一次对比。
- 读取源数据通过 Admin API 只读读取商品、变体、价格、库存、分类与图片替代文本。
- 以 Agent 身份探测 Catalog用公开的 UCP Agent Profile，向你的 Storefront Catalog 发送精确名称、品类、使用场景、约束条件和变体选择查询。
- 比对并给出证据确定性规则比对源值与 Catalog 响应，每条问题都附带证据。
- 修复并复测商品更新后自动定向复测，报告标出已修复、新增和仍存在的问题。
扫描 #14 对比 #13
示例数据- 新增
- 2
- 已修复
- 5
- 仍存在
- 3
- 已修复
越野跑鞋
CATALOG_VARIANT_UNRESOLVED
- 新增
羽绒背心
SOURCE_CATEGORY_MISSING
- 仍存在
帆布托特包
SOURCE_IMAGE_ALT_MISSING
原则
证据优先，不做承诺
ShelfProbe 衡量数据质量、查询命中和可购买性，不承诺 Shopify 或任何 AI 渠道的排名。
真实请求，不靠猜测
结论来自真实的 UCP Catalog 响应，而不是由模型推测 Agent 可能看到什么。
每条问题都有证据
展示规则、Admin 源值、Catalog 实际值、受影响的查询和修复建议。
确定性规则
完整性、一致性和可购买性由可检查的规则判定，而不是一个需要你信任的分数。
默认只读
ShelfProbe 只申请商品读取权限；任何写回都需要你先明确批准。
持续回归
定期扫描与商品变更触发的复测持续运行同一组查询，退化会尽早暴露。
Storefront 与 Global Catalog
以本店 Storefront Catalog 为基线；Global Catalog 的发现结果单独呈现，不混成一个分数。
从最重要的商品开始
在 Shopify 后台安装 ShelfProbe，打开控制台，运行第一次扫描。