Перейти к содержанию

BLOG / sku-md-v0-10-ucp-product-knowledge.mdx

SKU.md v0.10 × UCP: проверяемые знания о товаре для коммерции в реальном времени

Как SKU.md v0.10 дополняет UCP размещаемыми продавцом и доступными для аудита знаниями, сохраняя за Catalog и Checkout полномочия над текущим коммерческим состоянием.

Опубликовано

Исходная версия спецификации: v0.10

Если агент нашёл куртку, которая вроде бы подходит пользователю, это ещё не означает, что собрана вся информация для покупки. Остаются вопросы: ткань водонепроницаема или лишь отталкивает воду, на каких данных о телосложении основан совет по размеру, есть ли ограничения по уходу за покрытием, подтверждено ли заявление о прочности протоколом испытаний. Ответ должен быть точным, но устаревший рекламный текст нельзя выдавать за текущие сведения о наличии, текущую цену или итоговую сумму Checkout.

Здесь проходит граница предложения. UCP предоставляет путь в реальном времени от обнаружения товара и выбора Variant через Cart и Checkout до Order. SKU.md может предоставить размещаемые продавцом, пригодные для цитирования знания: что это за товар, почему справедливо утверждение и где найти основания ограничений. Два слоя дополняют друг друга только тогда, когда их полномочия разделены.

Начинайте с вопроса покупателя, а не с формата файла

Один вопрос «подойдёт ли мне?» включает несколько решений: можно ли купить товар на нужном рынке, какой Variant соответствует цвету и размеру, какова текущая цена, отвечает ли материал требованиям, является ли утверждение фактом продавца, результатом стороннего испытания или выводом системы ИИ, и действительно ли покупку можно совершить за показанную сумму.

UCP отвечает за изменчивую часть. Спецификация UCP Catalog определяет Catalog Search, Catalog Lookup, Product и Variant с текущей коммерческой информацией. Обзор UCP объединяет Catalog, Cart, Checkout и Order в один путь реального времени. Catalog помогает найти и подтвердить товар, а Checkout повторно проверяет обязательные условия и выполняет транзакцию.

Профиль агента помогает участникам объявлять и согласовывать поддерживаемые возможности. Это не товарный контент, не предъявляемые учётные данные и не полная процедура аутентификации запроса. UCP может использовать опубликованные в профиле ключи подписи для проверки личности, но сам документ профиля не аутентифицирует отдельный запрос и не разрешает покупку. Аутентификация запроса, авторизация, согласие и выполнение по-прежнему зависят от согласованных протокола, транспорта, учётных данных и контекста покупателя. Если считать профиль базой товарных знаний, разные задачи смешиваются.

Два слоя и одна карта полномочий

Роли можно представить в таблице.

Решение UCP и коммерция в реальном времени SKU.md v0.10
Обнаружение и идентичность Поиск и запрос возвращают текущие Product, Variant, цену, наличие и стабильные идентификаторы. Связывает точные Product и Variant с отдельным документом знаний.
Понимание товара Ответ Catalog возвращает актуальные описание, изображения, варианты выбора и раскрытия. Публикует факты, утверждения, доказательства, рекомендации, ограничения, совместимость и время проверки с указанием источников.
Изменчивое коммерческое состояние Повторный запрос Catalog даёт текущие цену и наличие. Статический документ не выдаёт прошлое состояние за текущее.
Транзакция Cart может собрать товары и дать оценку. Checkout повторно подтверждает обязательное состояние, итоговую сумму и разрешение на покупку. Указывает полномочный путь проведения торговой операции, но не заменяет его.

Такое разделение не ослабляет ценность SKU.md, а проясняет её. Продавец может поддерживать долговечное, проверяемое объяснение, которое разные агенты цитируют при необходимости. UCP продолжает отвечать на вопросы, меняющиеся в зависимости от рынка, сеанса, наличия, права на покупку и условий Checkout.

Возможность Cart в UCP предназначена для сбора товаров и предварительной оценки до покупки. Окончательная транзакция принадлежит Checkout. Руководство Shopify по Checkout MCP также описывает Checkout как сеанс покупки, используемый после того, как покупатель подготовился к покупке. SKU.md указывает на конечный путь, но не должен выдавать предварительную оценку Cart за обещание.

Граница действует и в обратную сторону. Нельзя оставлять только в SKU.md предупреждение о безопасности или нормативное раскрытие, влияющее на возможность покупки. Если предупреждение меняет решение, оно должно при необходимости появляться и в Catalog либо Checkout. SKU.md может дополнить его контекстом и доказательствами, но не быть единственным местом, где пользователь узнаёт существенное условие.

Почему v0.10 ставит знания на первое место

v0.10 допускает документ товара, содержащий только знания. Если идентичность Product и Variant стабильна, а Knowledge не пуст, действительный документ можно публиковать без предложения. Это важно для подключённого к UCP продавца: он предоставляет цитируемые товарные знания, не копируя Catalog реального времени.

Для продавцов без доступного каталога реального времени остаётся резервное наблюдение, размещаемое продавцом. Variant может содержать offer_snapshot или live_offer; оба поля необязательны и взаимоисключающи. Они не получают полномочий Catalog или Checkout. offer_snapshot — прошлое наблюдение, live_offer — отдельно объявленный поиск в реальном времени. При наличии актуального ответа UCP ни одно поле нельзя считать сегодняшней ценой или итоговой суммой.

Идентичность проверяется точным совпадением, а не сходством. Product ID, Variant ID, SKU и объявленный GTIN в документе знаний должны совпасть с Product или Variant, возвращённым UCP. При любом расхождении использование прекращается: убедительное объяснение нельзя прикреплять к другому Variant. Нормативная граница описана в англоязычной спецификации и JSON Schema.

Узкий мост к UCP Catalog

SKU.md можно использовать самостоятельно в открытой веб-среде, но агент не должен угадывать соответствие между найденным Product и документом знаний. Предложение определяет независимое расширение md.sku.shopping.product_knowledge для dev.ucp.shopping.catalog.search и dev.ucp.shopping.catalog.lookup. Вместо полного документа Markdown ответ Catalog возвращает только небольшую типизированную ссылку.

{
  "sku_md": {
    "documents": [
      {
        "url": "https://merchant.example/products/trail-jacket.sku.md",
        "schema_version": "sku.md/0.10-draft",
        "content_language": "en-US",
        "market": { "country": "US", "currency": "USD" },
        "revision": "2026-08-02"
      }
    ]
  }
}

Указатель содержит HTTPS-URL, версию схемы SKU.md, язык содержимого, страну и валюту рынка, а также необязательную редакцию. Бизнес-профиль (Business Profile) может объявлять разрешённые источники HTTPS. Потребитель читает указатель только тогда, когда профиль платформы (Platform Profile) и бизнес-профиль согласовали одно расширение, а родительская возможность Catalog совместима.

Разрешённый источник ограничивает адрес ссылки, но не доказывает подлинность, актуальность, безопасность или авторизацию документа. Эталонный потребитель рассматривает полученный документ как недоверенные внешние данные и проверяет HTTPS, точный источник, тип содержимого, ограничение размера, число документов и идентичность товара. Markdown, HTML, вводные метаданные YAML, ссылки и инструкции на естественном языке остаются данными. Нельзя выполнять найденные в документе скрипты, инструменты, команды оболочки, шаблоны или инструкции, похожие на промпты.

Локальный черновик опубликован в /ucp/draft/ вместе со схемой расширения. /ucp/draft/ обозначает черновой статус, а профили расширения используют явную версию возможности 2026-08-02. Эта дата не означает стабильность, сертификацию или поддержку Shopify. Для зрелости нужны дополнительные реализации, проверка безопасности и доказательства совместимости.

Путь выполнения — это цикл, а не передача полномочий

Осторожный агент использует два слоя в следующем порядке.

  1. UCP находит текущий Product через Catalog Search или Catalog Lookup.
  2. Точно сопоставляются Product, Variant, SKU и объявленный GTIN.
  3. Из связанного SKU.md читаются факты, доказательства, сведения о совместимости и ограничения.
  4. Агент возвращается в UCP за текущими ценой и наличием для рынка и контекста пользователя.
  5. Checkout повторно подтверждает выбранный товар и сохраняет полномочия над итоговой суммой и разрешением на покупку.

Четвёртый шаг принципиален. Богатый цитатами документ знаний отвечает, почему товар подходит, но не позволяет пропустить проверку текущего коммерческого состояния. Если актуальный источник недоступен, следует вернуть результат «неизвестно», а не копировать цену из старого текста.

Практика для продавца Shopify

Исходными материалами для документа знаний могут быть проверенные Metafields, Metaobjects, инструкции к товару, протоколы испытаний, правила ухода, гарантийные условия и публичные доказательства. Само хранение ещё не делает их истинными. Фактом, пригодным для нормативной публикации, материал становится лишь после проверки Product, Variant, рынка, доказательств и редакции ответственным специалистом до публикации.

Текст, созданный ИИ, может помочь найти пропущенные поля или составить понятное резюме, но до ручного сравнения с доказательствами остаётся кандидатом и не может автоматически стать фактом. Издатель также сохраняет источник, время проверки и причину принять или отклонить утверждение. Ценность SKU.md — не в объёме текста, а в прослеживаемом пути от утверждения к доказательству.

Профили агентов Shopify объясняют участие профиля в согласовании UCP, руководство Shopify Catalog — поиск, результаты и чтение товаров, а расширение глобального каталога — расширение глобального каталога Shopify. Это собственные интерфейсы возможностей Shopify; документация не говорит, что Shopify автоматически читает SKU.md или поддерживает это независимое расширение.

Что может измерить локальный Reference Consumer

Локальная оценка использует фиксированные товарные данные, согласованные возможности, метаданные ресурсов и текст документа. Она измеряет не ранжирование в поиске или конверсию, а способность дать ответ с доказательствами и ясными границами.

Вопрос Только UCP UCP + SKU.md
Цитирование факта 0 1
Ошибочное принятие утверждения за факт 0 0
Воспроизведение раскрытия 0 1
Ответ о совместимости 0 1
Безопасный отказ при несовпадении варианта 1 1
Использование устаревшего предложения для покупки 0 0

Это локальный контролируемый результат. Он не доказывает улучшение ранжирования, конверсии, показателя принятия, реальную интеграцию с Shopify или использование внешним агентом. Тестовые данные и ограничения описаны в оценке эталонного потребителя.

Миграция без притворства, что черновик завершён

Существующие URL и поведение проверки v0.9 по-прежнему полезны. Продавец может сохранить действительный документ v0.9, пока готовит v0.10: изменить маркер схемы, сохранить стабильную идентичность и проверенные Knowledge, перенести изменчивые коммерческие данные за пределы Knowledge. Руководство по миграции с v0.9 объясняет, как удалить предложение или сохранить необязательный резервный вариант, не выдавая его за Catalog или Checkout.

Следующий шаг — не объявлять расширение стандартом. Нужно проверить обе стороны в независимых реализациях, проверить композицию схемы и поведение при ошибках, провести анализ безопасности и конфиденциальности и собрать отзывы потребителей и продавцов. До этого SKU.md v0.10 остаётся экспериментальным слоем товарных знаний, размещаемым продавцом, а UCP отвечает за обнаружение и коммерческое состояние в реальном времени и за окончательное решение о покупке.

Дополнительные материалы

Продолжите чтение статьей о передаче полномочий от знаний к живому Catalog и Checkout.