Что такое 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"
        }
      ]
    }
  }
}

Источники

Часто задаваемые вопросы

У моего магазина нет /.well-known/ucp. Значит ли это, что ИИ-ассистенты не смогут продавать мои товары?

Нет. 404 на профиле означает лишь, что магазин — не UCP: ассистенты по-прежнему могут добраться до него старым путём — через ссылки, ленты и результаты поиска. UCP — это необязательная машиночитаемая входная дверь, а не требование для онлайн-продаж. Магазины Shopify публикуют профиль автоматически; на других платформах вы публикуете его сами, либо ваша платформа или платёжный провайдер публикует его за вас. Вердикт проверки «не UCP» — это констатация факта, а не неудовлетворительная оценка: он говорит вам, что двери нет, а не что магазин закрыт.

Проверка предупреждает, что моя версия UCP устарела. Нужно ли мне обновляться?

Не немедленно, и не паникуйте. Старые версии продолжают работать для клиентов, которые их говорят, — именно для этого существует supported_versions, — но ассистент, говорящий только на текущей версии, не найдёт взаимно поддерживаемой версии, а инструменты, построенные для нового релиза, могут искать имена и поля, которые ваш профиль больше не использует (signing_keys[] — знаменитый пример). Когда будете обновляться, обновите вместе схемы, имена возможностей и чтение полей ключей, а затем перепроверьте, какие возможности реально договариваются после этого; смена версии только на бумаге, с устаревшими идентификаторами внизу, хуже, чем сознательное пребывание на старой версии.

Магазин проходит проверку — гарантирует ли это, что оформление заказа сработает?

Нет. Профиль — это реклама, а не транзакция: он говорит, что предлагает магазин и где это найти, а проверка подтверждает, что реклама правильно оформлена. Она никогда не размещает заказ, никогда не входит как покупатель и никогда не проверяет криптографию платёжных обработчиков. Конечная точка оформления заказа за профилем может по-прежнему требовать аутентификации, учётной записи покупателя или одобрения продавца, а платёжный обработчик может отклонить платёж. Воспринимайте чистую проверку как «обнаружим и описан правильно» — завершится ли покупка, по-прежнему работа магазина.