什麼是 UCP 以及如何檢查它
最後更新:
UCP——通用商務協議(Universal Commerce Protocol)——是讓 AI 助手替商店購物的開放標準。商店在 /.well-known/ucp 發布一份小小的機器可讀檔案,任何講這種協議的助手讀了它,就能知道商店講哪個版本、怎樣存取它的商品目錄和結帳、接受哪些支付處理程序——不需要每家商店單獨做整合,不需要抓取頁面,不需要猜。它解決的正是 llms.txt 為內容解決的問題,只不過對象換成了商務:人讀的是店面,機器讀的應該是清單。你可以把任何商店貼進UCP 檢查器,把它的檔案讀成一個結論——可達、格式良好、版本最新,或根本不是 UCP——但本文教你自己讀這份文件,這樣下一次某份檔案檢查失敗時,你能在文字裡直接看到原因。
什麼是 UCP——以及 AI 助手為什麼需要它
UCP 是 Google 的開放標準,由 Shopify 聯合開發,給 AI 助手提供了一套統一的購物語言:發現商店、搜尋商品目錄、組裝購物車、結帳,以及事後追蹤訂單。助手透過協議和商店對話,而不是透過每家定製一次的整合;而商家仍然是交易的記錄方——按 Google 自己的指南所說,保留自己的客戶資料和客戶關係。這個標準的意義在於把 N×N 的整合問題壓成一次:沒有它,每個助手都要和每個商家單獨對接;有了它,雙方各實作一次,就能彼此互通。
這個需求是新的,因為購物場景是新的。助手現在會在 Google 搜尋的 AI Mode 和 Gemini 應用裡遇見購物者,一個問題不用打開任何店面標籤頁就能變成一筆購買。聊天視窗沒法點「加入購物車」,所以助手需要一種辦法,用機器的語言問商店:你賣什麼、怎麼買、賣完之後會發生什麼。UCP 就是這個辦法:它覆蓋從發現、結帳到售後的完整旅程——訂單、履約、折扣——並且被設計成與相鄰的傳輸標準(MCP、A2A)和支付證明標準(AP2)互通,而不是取代它們。
發現檔案:/.well-known/ucp 和它的三個必填欄位
整個協議從一個檔案開始。商家把自己的檔案——一個帶必填 ucp 成員的 JSON 物件——發布在 /.well-known/ucp,平台在做任何事之前先來取它。在 ucp 裡面,三個欄位是必填的:version,以日期表示的協議版本;services,商家提供的 API 表面,按反向網域名稱命名,比如 dev.ucp.shopping,每一條把服務和一種傳輸綁定(REST、MCP、A2A 或 embedded)及一個端點配對;以及 payment_handlers,它接受的支付方式。後兩個欄位即使為空也必須存在——空物件是一句有效的聲明(「我們暫時不提供服務」),缺失欄位則是損壞的檔案。第四個成員 capabilities 是可選的,但正是它讓檔案變得有用:它逐項列出各個功能——結帳、購物車、訂單、目錄搜尋——每項自帶版本、規範和 schema 連結。
這份檔案還有託管規則,而且相當嚴格,事出有因。已發布的檔案必須透過 HTTPS 提供、不得重新導向,而且必須帶 Cache-Control: public 和至少 60 秒的 max-age——絕不能是 private、no-store 或 no-cache。檔案是商店穩定不變的身分和能力清單,不是針對某筆交易的回應,所以它就是為了被快取、被低成本取用而設計的;一次重新導向或一條 no-cache 指令,等於告訴平台:發布者沒有把這份文件當作協議所期望的那份穩定清單來對待。平台則朝另一個方向公開自己的檔案,放在請求的 UCP-Agent 標頭裡,這正是免註冊接入得以成立的原因:任何擁有可發現檔案的平台,都能和任何擁有檔案的商家對話,無需事先註冊。
手工讀一份真實文件:Allbirds
Shopify 店面預設就會發布 UCP 檔案,所以隨便哪一家都是現成的例子——以 2026 年 11 月 21 日抓取的 Allbirds 為例。它的 ucp.version 是 "2026-08-25",也就是當前版本;而 supported_versions 物件把兩個舊版本——2026-04-08 和 2026-01-23——對應到它 myshopify.com 網域下的版本化檔案 URL,這樣講舊版本的客戶端仍然可以協商。在 services 下面,dev.ucp.shopping 出現了兩次:一次是傳輸方式為 mcp、端點在 /api/ucp/mcp,一次是 embedded——注意缺席的那一項:沒有 rest 條目。商店不必提供每一種傳輸方式,只需公開它實際運行的那幾種。第二個服務 dev.ucp.common 同樣透過 MCP 提供。
capabilities 物件是這份文件變得具體的地方。Allbirds 公開了 dev.ucp.shopping.checkout、cart、order、catalog.search 和 catalog.lookup,再加上幾個擴充:fulfillment 和 discount,兩者都聲明自己擴充了 checkout 和 cart,還有 buyer_consent、identity_linking 和一個 permalink 能力。這些名字按設計採用反向網域:dev.ucp.* 歸 UCP 管理機構管轄,而 dev.shopify.* 條目——這裡是 dev.shopify.catalog 和 dev.shopify.shopping.declared_fields 擴充——屬於 Shopify 自己。在 payment_handlers 下面是三個處理程序:com.google.pay、dev.shopify.card 和 dev.shopify.shop_pay,各自帶版本、規範和 schema。有一項東西缺席了,而它的缺席沒有問題:這份文件沒有頂層的 keys 陣列。簽名金鑰是可選的——只有商店簽署請求時才會發布——所以一份沒有金鑰的檔案不是損壞的檔案。
版本就是日期——而 2026-08-25 打破了一些東西
UCP 的版本就是日曆日期,寫成 YYYY-MM-DD 的形式,規範對此說得很直白:商家不得在檔案裡公開非日期的版本字串,比如 "draft"。當前版本是 2026-08-25;更早的版本透過 supported_versions 繼續存在,每一個指向一份完整自足的、屬於那個日期的葉子檔案。相容性按精確的版本相等來判定,而不是「越新越好」:平台和商家取雙方都支援的版本交集,如果沒有共同版本,商家必須回答 version_unsupported。還有一個值得知道的絆腳石:檔案裡每一條 dev.ucp.* 服務、能力和擴充,都必須聲明與檔案 ucp.version 相同的版本,平台一旦遇到版本不匹配的條目,必須直接拒絕該條目,把它當作不存在。
這就是為什麼舊版本只得到警告,而不是通過。2026-08-25 是這個協議最大的一次結構性改動:它從檔案 schema 裡刪掉了舊的 signing_keys[] 欄位,把頂層的 keys[] 陣列——一個 JWK Set——定為簽名金鑰唯一的 canonical 位置,所以為新版本建構的客戶端如果還去讀 signing_keys,將一無所獲;它把支付擴充從 dev.ucp.shopping.* 命名空間移到了 dev.ucp.common.payment.*;它把買家同意(buyer consent)從固定的布林旗標重構成一個動態對應;還合併了履約設定。仍在 2026-04-08 的商店,對講 2026-04-08 的客戶端仍然可用——supported_versions 正是為此而生——但一個只講新版本的助手將找不到共同版本,而任何按舊名字和舊欄位寫成的工具都會悄悄錯過目標。舊,在 UCP 裡意味著「凍結在過去」,而不是「壞了」——而警告正是這兩者的區別。
UCP vs ACP vs AP2 vs x402
ACP——Agentic Commerce Protocol(代理商務協議),由 OpenAI 和 Stripe 聯合開發——覆蓋的是聊天介面內的結帳步驟,比如在 ChatGPT 裡:買家在對話中批准購買,商家透過自己的支付服務商完成結帳。它的範圍只是結帳,不是完整的購物旅程:它回答的是買家如何在聊天裡付款,而把商品目錄發現和售後留給別的東西。可以把它理解為 UCP 在 OpenAI 陣地上的平行版本,而 UCP 則是 Google 陣地上的對應物。
AP2——Agent Payments Protocol(代理支付協議),由 Google 發布——回答的是另一個問題:不是結帳如何運行,而是使用者到底授權了什麼。它生成帶簽名的、可驗證的授權書(mandate)——針對購買本身的 checkout mandate 和針對支付環節的 payment mandate——讓商家、卡組織和發卡行各自核對同一份證明,而不是只信代理的一面之詞。它的設計就是與 UCP 協同工作,在 UCP 流程內部提供帶簽名的授權,而不是與 UCP 競爭。
x402——由 Coinbase 創建——回答的是第三個問題:代理怎樣一次性為一樣東西付款,不用帳號、不用結帳頁?它復活了沉睡的 HTTP 402 Payment Required 狀態碼:代理請求一個付費資源,伺服器以 402 和價格作答,代理再帶著帶簽名的付款重試,通常用穩定幣在鏈上結算。它是針對 API、資料和內容的一次性按呼叫計費——買一次請求正合適,裝購物車則形狀不對。
這四個是互補的,不是對手,真實系統往往把它們組合使用:UCP 跑購物旅程,AP2 在其中提供帶簽名的證明,x402 沿途為單次呼叫計價,ACP 則是 OpenAI 陣地上的結帳路徑。這也是本站檢查器的邊界:UCP 檢查器只讀 UCP 檔案,它不取、不驗證 ACP、AP2 或 x402 的文件,所以一家商店可以是 UCP-ready,同時完全沒有 ACP 或 AP2 的存在——這些協議彼此獨立,缺了某一個,並不意味著另一個失敗。
UCP 檢查器能做什麼——以及不能做什麼
檢查器透過伺服器端的檢查服務取 https://<目標>/.well-known/ucp——你的瀏覽器永遠不會直接取目標站點,因為跨域規則會擋住大多數商店——然後按規範的方式逐項檢查這份檔案。它檢查文件是否透過 HTTPS 可達、有無重新導向(按規範,重新導向就是失敗),讀取 Cache-Control 標頭並逐字引用它的實際值,解析 JSON,解析失敗就報出精確的解析錯誤,並核對三個必填欄位是否齊全、版本是否為日期、版本是否早於 2026-08-25。它逐項列出每個服務及其傳輸方式和版本、每個支付處理程序、每個能力及其所屬服務,並逐個探測聲明的端點是否可達。結論只有三種:UCP-ready、部分就緒,或不是 UCP——檔案回傳 404 是最常見的否定情況,檢查器會明確說出來。
它不能做什麼,同樣重要。它不下單,不以買家身分登入,也不驗證支付處理程序的密碼學——keys[] 陣列的存在只證明來源(這些金鑰屬於發布它們的網域),不證明可信,規範原文就是這麼說的。它不檢查 ACP、AP2 或 x402 的文件。而一份乾淨的結果也不是結帳一定成功的保證:檔案只是廣告,不是交易,它背後的端點仍可能要求認證、買家帳號或商家批准,才肯做任何事。乾淨的檢查結果意味著這家商店描述正確、可以被發現;購買能不能完成,仍然是商店自己系統的事。至於更宏觀的問題——一個網站是否為智慧體做好了準備(發現檔案只是其中一個訊號)——Agent Readiness Checker 會連同其他訊號一起檢查。
自己試試:一份最小的 UCP 檔案,它的形狀本身就是註解
{
"ucp": {
"version": "2026-08-25",
"services": {
"dev.ucp.shopping": [
{
"version": "2026-08-25",
"transport": "rest",
"endpoint": "https://business.example.com/ucp/v1",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/rest.openapi.json"
},
{
"version": "2026-08-25",
"transport": "mcp",
"endpoint": "https://business.example.com/ucp/mcp",
"spec": "https://ucp.dev/2026-08-25/specification/overview/",
"schema": "https://ucp.dev/2026-08-25/services/shopping/mcp.openrpc.json"
}
]
},
"capabilities": {
"dev.ucp.shopping.checkout": [
{
"version": "2026-08-25",
"spec": "https://ucp.dev/2026-08-25/specification/shopping/checkout",
"schema": "https://ucp.dev/2026-08-25/schemas/shopping/checkout.json"
}
]
},
"payment_handlers": {
"com.example.processor_tokenizer": [
{
"id": "processor_tokenizer",
"version": "2026-08-25",
"spec": "https://example.com/specs/payments/processor_tokenizer",
"schema": "https://example.com/specs/payments/merchant_tokenizer.json"
}
]
}
}
}