商品数据与传输
5.1 商品数据结构
UCP使用JSON格式描述商品,所有金额遵循ISO 4217最小货币单位:5.2 必填与可选字段
5.3 变体管理
有多个规格(颜色、尺码、材质等)的商品使用variants 数组:
- 每个变体有独立的
id、sku、price和availability - 变体的
attributes对象定义规格属性(key-value格式) - AI代理展示商品时可以列出所有可选规格
- 变体可以有不同的价格(如大码加价)
5.4 四种传输机制
UCP的商品数据可以通过四种传输方式提供给AI代理,每种方式适用于不同的集成场景。REST传输 (OpenAPI 3.x)
最传统的服务端到服务端集成方式。商家提供符合OpenAPI 3.x规范的REST API:MCP传输 (OpenRPC / JSON-RPC 2.0)
面向AI应用的传输方式。UCP通过MCP协议暴露商品目录工具,使用OpenRPC schema定义。提供三个标准工具: search_catalog — 搜索商品目录A2A传输 (Agent Card Specification)
面向多代理协作场景。商家发布Agent Card,让其他AI代理发现和对接。Agent Card遵循Google的Agent-to-Agent协议规范。 适用于:购物代理调用支付代理、比价代理同时查询多个商家代理等场景。Embedded传输 (OpenRPC schema)
嵌入式场景下的传输方式,仅使用OpenRPC schema(不通过完整的MCP协议)。适用于商家在自己的网页中嵌入AI购物助手。5.5 各传输方式对比
5.6 价格格式规范
UCP使用整数表示价格(ISO 4217最小货币单位),避免浮点数精度问题:
实现建议: 始终从ISO 4217的exponent表查询货币的小数位数,不要硬编码。
5.7 搜索与过滤
UCP定义了标准化的搜索和过滤参数:下一章: 安全与认证 — RFC 9421签名、JWK密钥、mTLS和Content-Digest