文档
核心概念

核心概念

概述

UCP 通过三层抽象模型解决商业互操作问题：

  1. Service（服务）：定义 API 表面和传输绑定
  2. Capability（能力）：声明支持的功能特性
  3. Extension（扩展）：可选的能力增强模块

这种设计让 UCP 既保持核心简洁，又支持垂直领域扩展。

参与者角色

UCP 定义了四种主要参与者，各自承担明确的职责：

角色职责示例
Platform（平台）发现商家能力，发起结账会话，向用户展示界面AI 购物助手、超级应用、搜索引擎
Business（商家）暴露商业能力，履行订单，处理支付零售商、航空公司、酒店集团
Credential Provider（凭证提供方）安全管理用户敏感数据，发行支付令牌Google Wallet、Apple Pay
Payment Service Provider（支付服务商）处理支付授权、清算、结算Stripe、Adyen、PayPal

关键设计原则

  • 商家作为 Merchant of Record：商家保留财务责任和订单所有权
  • 平台不接触原始支付数据：通过令牌化最小化 PCI-DSS 合规范围
  • 凭证单向流动：支付凭证仅从平台流向商家，商家不回传

Service：服务层

Service 定义了一个垂直领域（如 shopping、common）的 API 表面，包含：

字段说明示例
version服务版本（YYYY-MM-DD 格式）2026-01-11
spec服务文档 URLhttps://ucp.dev/specification/overview
restREST 传输绑定（可选）OpenAPI 3.x 规范
mcpMCP 传输绑定（可选）OpenRPC 规范
a2aA2A 传输绑定（可选）Agent Card URL
embedded嵌入式传输绑定（可选）OpenRPC 规范

传输绑定示例 

{
  "rest": {
    "schema": "https://ucp.dev/services/shopping/rest.openapi.json",
    "endpoint": "https://business.example.com/api/v2"
  }
}

命名规范

所有 Service 和 Capability 名称使用反向域名格式：

{reverse-domain}.{service}.{capability}

示例：

名称权威方服务能力
dev.ucp.shopping.checkoutucp.devshoppingcheckout
dev.ucp.common.identity_linkingucp.devcommonidentity_linking
com.example.payments.installmentsexample.compaymentsinstallments

Capability：能力层

Capability 是 Service 内的独立功能特性，声明支持的功能和文档位置。

Capability 定义

字段必填说明
name是能力名称（反向域名格式）
version是能力版本（YYYY-MM-DD 格式）
spec是规范文档 URL
schema是JSON Schema URL
extends否父能力名称（用于扩展）

标准能力

UCP 定义了以下核心能力：

能力说明
Checkout结账会话管理，包括购物车和税费计算
Identity Linking基于 OAuth 2.0 的身份关联
Order订单生命周期事件通知

Extension：扩展层

Extension 是可选的能力增强模块，通过 extends 字段声明父能力。

扩展示例 

{
  "name": "dev.ucp.shopping.fulfillment",
  "version": "2026-01-11",
  "spec": "https://ucp.dev/specification/fulfillment",
  "schema": "https://ucp.dev/schemas/shopping/fulfillment.json",
  "extends": "dev.ucp.shopping.checkout"
}

扩展类型

扩展说明扩展自
Fulfillment履约配送Checkout
Discount折扣优惠Checkout
AP2 MandatesAP2 加密支付指令Checkout

Profile：配置文件

Profile 是参与者在 /.well-known/ucp 发布的 JSON 文档，声明身份、支持的能力和端点。

Business Profile 示例 

{
  "ucp": {
    "version": "2026-01-11",
    "services": {
      "dev.ucp.shopping": {
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/overview",
        "rest": {
          "schema": "https://ucp.dev/services/shopping/rest.openapi.json",
          "endpoint": "https://business.example.com/ucp/v1"
        }
      }
    },
    "capabilities": [
      {
        "name": "dev.ucp.shopping.checkout",
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/checkout",
        "schema": "https://ucp.dev/schemas/shopping/checkout.json"
      }
    ]
  },
  "payment": {
    "handlers": [...]
  },
  "signing_keys": [...]
}

能力协商

UCP 使用"服务端选择"架构进行能力协商：

  1. 平台声明：通过 UCP-Agent header 或请求体声明 Profile URI
  2. 能力交集：商家计算平台和商家能力的交集
  3. 剪枝孤立扩展：移除父能力不在交集中的扩展
  4. 响应声明：商家在响应中包含活跃能力列表

协商流程 

Platform Profile → Business Profile → 交集计算 → 活跃能力
     [A, B]           [A, C]              [A]              [A]

传输协议

UCP 是传输无关的，支持多种协议：

传输适用场景规范格式
REST标准应用集成OpenAPI 3.x
MCPLLM 智能体直接调用OpenRPC
A2A智能体间协作Agent Card
Embedded内嵌商家 UIOpenRPC

下一步

架构设计