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. Для зрелости нужны дополнительные реализации, проверка безопасности и доказательства совместимости.
Путь выполнения — это цикл, а не передача полномочий
Осторожный агент использует два слоя в следующем порядке.
- UCP находит текущий Product через Catalog Search или Catalog Lookup.
- Точно сопоставляются Product, Variant, SKU и объявленный GTIN.
- Из связанного SKU.md читаются факты, доказательства, сведения о совместимости и ограничения.
- Агент возвращается в UCP за текущими ценой и наличием для рынка и контекста пользователя.
- 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.