Что такое UCP и как его проверить
Последнее обновление:
UCP — Universal Commerce Protocol, универсальный протокол коммерции — это открытый стандарт, позволяющий ИИ-ассистенту совершать покупки от имени магазина. Магазин публикует небольшой машиночитаемый профиль по адресу /.well-known/ucp, и любой ассистент, говорящий на этом протоколе, может прочитать его и узнать, какую версию говорит магазин, как добраться до его каталога и оформления заказа и какие платёжные обработчики он принимает — без индивидуальной интеграции для каждого магазина, без парсинга страниц, без догадок. Это та же задача, которую llms.txt решает для контента, применённая к коммерции: человек читает витрину, а агенту нужен манифест. Вы можете вставить любой магазин в проверку UCP и прочитать его профиль как вердикт — доступен, правильно оформлен, актуален или вообще не UCP, — но эта статья учит вас читать документ самостоятельно, чтобы в следующий раз, когда профиль не пройдёт проверку, вы увидели причину в самом тексте.
Что такое UCP — и зачем он нужен ИИ-ассистентам
UCP — открытый стандарт Google, разработанный совместно с Shopify, который даёт ИИ-ассистентам общий язык для покупок: найти магазин, поискать в его каталоге, собрать корзину, оформить заказ и затем отследить его. Ассистент разговаривает с магазином через протокол, а не через индивидуальную интеграцию, а продавец остаётся продавцом по сделке — сохраняя свои клиентские данные и отношения, как сказано в собственном руководстве Google. Смысл стандарта — свернуть задачу интеграции N на N: без него каждому ассистенту понадобилось бы отдельное соглашение с каждым продавцом; с ним каждая сторона реализует протокол один раз — и они взаимодействуют.
Потребность нова, потому что нова поверхность покупок. Ассистенты теперь встречают покупателей в AI Mode в поиске Google и в приложении Gemini, где вопрос может превратиться в покупку, ни разу не открыв вкладку магазина. Окно чата не может нажать «добавить в корзину», поэтому ассистенту нужен способ спросить магазин на языке машин, что он продаёт, как это купить и что происходит после продажи. UCP — это такой способ: он покрывает весь путь от обнаружения через оформление заказа до послепродажного обслуживания — заказы, выполнение, скидки — и спроектирован так, чтобы взаимодействовать с соседними стандартами транспорта (MCP, A2A) и подтверждения платежа (AP2), а не заменять их.
Файл обнаружения: /.well-known/ucp и его три обязательных поля
Весь протокол начинается с одного файла. Компания публикует свой профиль — JSON-объект с обязательным членом ucp — по адресу /.well-known/ucp, а платформа скачивает его, прежде чем делать что-либо ещё. Внутри ucp три поля обязательны: version — версия протокола в виде даты; services — API-поверхности, которые предлагает компания, именованные обратным доменом, например dev.ucp.shopping, где каждая запись связывает сервис с одной транспортной привязкой (REST, MCP, A2A или embedded) и конечной точкой; и payment_handlers — принимаемые способы оплаты. Последние два должны присутствовать, даже если они пусты: пустой объект — это допустимое утверждение («мы пока не предлагаем сервисов»), а отсутствующее поле — сломанный профиль. Четвёртый член, capabilities, необязателен, но именно он делает профиль полезным: он перечисляет отдельные возможности — оформление заказа, корзину, заказ, поиск по каталогу — каждую со своей версией, spec и URL-адресами схем.
У файла есть также правила хостинга, и они строги по веской причине. Опубликованные профили должны отдаваться по HTTPS, не должны перенаправлять и должны нести Cache-Control: public с max-age не менее 60 секунд — никогда private, no-store или no-cache. Профиль — это стабильная идентичность и список возможностей магазина, а не ответ на отдельную транзакцию, поэтому он предназначен для кэширования и дешёвого скачивания; перенаправление или директива no-cache говорит платформе, что издатель не настроил документ как стабильный манифест, которого ожидает протокол. Платформы объявляют свой собственный профиль в обратном направлении — в заголовке запроса UCP-Agent, — что и делает возможным подключение без разрешения: любая платформа с обнаружимым профилем может разговаривать с любой компанией, у которой он есть, без предварительной регистрации.
Читаем настоящий документ вручную: Allbirds
Магазины Shopify публикуют профиль UCP по умолчанию, так что любой из них — живой пример. Возьмём Allbirds, скачанный 21 ноября 2026 года. Его ucp.version — "2026-08-25", то есть текущая версия, а объект supported_versions отображает две более старые версии — 2026-04-08 и 2026-01-23 — на версионированные URL-адреса профилей в его домене myshopify.com, чтобы старые клиенты могли продолжать договариваться. В 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, каждый со своей версией, spec и схемой. Одной вещи не хватает, и её отсутствие — нормально: в документе нет массива keys верхнего уровня. Подписные ключи необязательны — профиль публикует их только тогда, когда магазин подписывает запросы, — так что профиль без ключей не является сломанным профилем.
Версии — это даты, а 2026-08-25 кое-что сломала
Версии UCP — это календарные даты в формате YYYY-MM-DD, и спецификация категорична: компания не должна объявлять в своём профиле строку версии, не являющуюся датой, например "draft". Текущая версия — 2026-08-25; более ранние версии продолжают жить через supported_versions, каждая из которых указывает на полный самодостаточный листовой профиль для этой даты. Совместимость устанавливается точным равенством версий, а не по принципу «чем новее, тем лучше»: платформа и компания пересекают версии, которые поддерживают обе, и если общей версии нет, компания должна ответить version_unsupported. Есть ещё одна ловушка, о которой стоит знать: каждая запись сервиса, возможности и расширения dev.ucp.* в профиле должна объявлять ту же версию, что и ucp.version профиля, а платформа, встретившая запись с несовпадающей версией, должна отклонить эту запись безоговорочно, считая её отсутствующей.
Вот почему старая версия получает предупреждение, а не «пройдено». Релиз 2026-08-25 стал крупнейшим структурным изменением протокола: он удалил старое поле signing_keys[] из схемы профиля и сделал массив keys[] верхнего уровня — набор JWK — единственным каноническим местом для подписных ключей, так что клиент, построенный для нового релиза и читающий signing_keys, ничего не найдёт; он перенёс платёжные расширения из пространства имён dev.ucp.shopping.* в dev.ucp.common.payment.*; он перестроил согласие покупателя с фиксированных булевых флагов в динамическую карту; и он консолидировал конфигурацию выполнения заказов. Магазин, всё ещё находящийся на 2026-04-08, продолжает работать для клиентов, говорящих на 2026-04-08, — именно для этого и существует supported_versions, — но ассистент, говорящий только на новом релизе, не найдёт взаимно поддерживаемой версии, а любой инструмент, опирающийся на старые имена или поля, молча пройдёт мимо. Старый в UCP означает «замороженный во времени», а не «сломанный» — и предупреждение в этом и состоит.
UCP против ACP, AP2 и x402
ACP — Agentic Commerce Protocol, протокол агентной коммерции, разработанный совместно OpenAI и Stripe, — охватывает шаг оформления заказа внутри чат-поверхности, такой как ChatGPT: покупатель подтверждает покупку в разговоре, а компания проводит оплату через своего собственного платёжного провайдера. Его область — оформление заказа, а не полный путь покупки: он отвечает, как покупатель платит в чате, а обнаружение каталога и послепродажное обслуживание оставляет чему-то другому. Думайте о нём как о параллели UCP на поверхностях OpenAI, где UCP — эквивалент на поверхностях Google.
AP2 — Agent Payments Protocol, протокол платежей агентов, опубликованный Google, — отвечает на другой вопрос: не как работает оформление заказа, а что именно пользователь авторизовал. Он создаёт подписанные, проверяемые мандаты — мандат оформления заказа для самой покупки и платёжный мандат для платёжной стороны, — чтобы продавец, сеть и эмитент могли проверить одно и то же доказательство, а не верить агенту на слово. Он спроектирован для работы рядом с UCP, предоставляя подписанное разрешение внутри потока UCP, а не для конкуренции с ним.
x402 — созданный Coinbase — отвечает на третий вопрос: как агент платит за одну вещь один раз, без учётной записи и без страницы оформления заказа? Он возрождает спящий HTTP-код состояния 402 Payment Required: агент запрашивает платный ресурс, сервер отвечает 402 с ценой, а агент повторяет попытку с подписанным платежом, обычно в стейблкоинах с расчётом в цепочке. Это счётчик оплаты за вызов для API, данных и контента — правильный инструмент, когда покупка представляет собой один запрос, и неподходящая форма для корзины.
Все четыре дополняют друг друга, а не соперничают, и большинство реальных систем их комбинируют: UCP выполняет путь покупки, AP2 может предоставить подписанное доказательство внутри него, x402 тарифицирует отдельные вызовы по ходу дела, а ACP — это путь оформления заказа на поверхностях OpenAI. Это также граница проверки на этом сайте: проверка UCP читает только профили UCP. Она не скачивает и не проверяет документы ACP, AP2 или x402, поэтому магазин может быть готов к UCP и при этом вообще не иметь присутствия ACP или AP2 — протоколы независимы, и отсутствие одного не является провалом другого.
Что делает проверка UCP — и чего она не делает
Проверка скачивает https://<цель>/.well-known/ucp через серверный сервис проверки — ваш браузер никогда не скачивает цель напрямую, потому что правила кросс-доменных запросов заблокировали бы большинство магазинов, — а затем проходит по профилю так, как это делает спецификация. Она проверяет, доступен ли документ по HTTPS без перенаправления (перенаправление — это провал, согласно спецификации), читает заголовок Cache-Control и цитирует его фактическое значение, разбирает JSON и сообщает точную ошибку разбора при неудаче, а также проверяет, что три обязательных поля присутствуют, версия является датой и версия не старше 2026-08-25. Она перечисляет каждый сервис с его транспортом и версией, каждый платёжный обработчик и каждую возможность с сервисом, к которому она принадлежит, и проверяет каждую заявленную конечную точку на доступность. Вердикт — один из трёх: готов к UCP, частичный или не UCP; 404 на профиле — обычный отрицательный случай, и проверка прямо говорит об этом.
Что она не делает, столь же важно. Она не размещает заказ, не аутентифицируется как покупатель и не проверяет криптографию платёжных обработчиков — наличие массива keys[] доказывает происхождение (ключи принадлежат домену, который их опубликовал), а не доверие, и спецификация говорит об этом именно такими словами. Она не проверяет документы ACP, AP2 или x402. А чистый результат — не обещание, что оформление заказа сработает: профиль — это реклама, а не транзакция, и конечная точка за ним может по-прежнему требовать аутентификации, учётной записи покупателя или одобрения продавца, прежде чем что-либо сделать. Чистая проверка означает, что магазин описывает себя правильно и может быть обнаружен; завершится ли покупка — дело собственных систем магазина. Для более широкой картины — готов ли сайт к агентам вообще, включая файл обнаружения, — проверка готовности к агентам проверяет файл UCP среди прочих сигналов.
Попробуйте сами: минимальный профиль 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"
}
]
}
}
}