Shopify и SKU.md: знания о товарах, которыми управляет сам бренд

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

Разговор о покупке выходит за пределы названия и цены. Человеку важно, подходит ли вещь его привычкам, климату или уже имеющимся устройствам. Бренд может объяснить то, что знает о своём продукте: замысел, способ использования и ограничения. С этого имеет смысл начинать разговор о SKU.md для магазина Shopify.

У Shopify уже есть каналы покупок с ИИ

Agentic Storefronts позволяют подходящим товарам появляться в поддерживаемых каналах ИИ. Возможности зависят от региона, соответствия магазина требованиям и конкретного канала. Опыт поиска или покупки в одном канале нельзя автоматически переносить на другой. Требования Shopify Catalog также помогают проверить полноту основных данных о товаре.

Эти данные заслуживают внимания прежде всего. Неясное название, пропущенный материал или характеристики, спрятанные в рекламном тексте, затрудняют понимание товара в любом месте. Сначала стоит исправить запись в Shopify и публичные страницы, которые уже читают покупатели.

Shopify также поддерживает собственную информацию для агентов в agents.md. По умолчанию её следует сохранять. SKU.md представляет собой отдельное экспериментальное предложение версии 1.0.0-beta для входного каталога и необязательных знаний о товарах с источниками. Наличие каналов, каталога и файла агента не означает, что Shopify принял это предложение.

Бренд может объяснить условия использования

Характеристика отвечает на вопрос, что представляет собой товар. Покупатель часто спрашивает, подходит ли он именно ему. Доля шерсти не объясняет способ стирки, а фраза «на каждый день» не заменяет ограничения по уходу. Документ знаний может связать ответ с публичной страницей, на которой основана информация.

Инструкция по стирке не подтверждает, что свитер подходит любой чувствительной коже или никогда не покроется катышками. В материалах, долговечности и совместимости удаление одного условия способно превратить верное утверждение в неподтверждённое обещание.

За факты может отвечать продуктовая команда, за понятную формулировку редактор. Оба работают с одними публичными источниками. Каждому факту и указанию в необязательном документе знаний нужна ссылка Source. Она помогает найти основание при исправлении и позволяет читателю проверить его самостоятельно.

Публичные страницы дают поддержке, дилерам и партнёрам по контенту общую точку проверки. Каждый оформляет описание для своей площадки, но возвращается к инструкции конкретной модели, когда нужно уточнить условие. Бренд поддерживает источник, документ на него ссылается. Будет ли канал использовать документ, зависит от собственных механизмов чтения канала.

Начните с небольшого каталога

Минимальный каталог по текущей спецификации обозначает бренд, сайт и список товаров. Создавать документ для каждой позиции сразу не требуется. Когда для одного товара есть достаточно надёжных публичных материалов, можно добавить необязательный документ через раздел Product knowledge.

Выберите товар, о котором регулярно спрашивают и для которого уже есть хорошая страница или инструкция. Сопоставьте вопросы с источниками по одному. Если две страницы противоречат друг другу, ответственный за продукт должен установить факт и исправить публичную информацию до создания документа. Формат файла не разрешает разногласия внутри бренда.

Для этой работы подходят относительно устойчивые характеристики, назначение и ограничения. Цены, остатки, доставка, налоги и статус заказа остаются в действующих системах Shopify. Корзина, оплата и оформление покупки продолжают работать обычным способом. Документ может объяснять применение товара, но не должен превращать остаток на дату создания в долгосрочное обещание наличия.

Способ публикации зависит от существующей витрины

Команда, уже использующая Hydrogen или собственную витрину, может поручить ответственному за хостинг проверить путь /sku.md на том же источнике сайта. Создайте минимальный каталог, определите владельца маршрута, опубликуйте Markdown и проверьте адрес валидатором публичного URL. Рекомендуется прямой ответ 200. Спецификация допускает не более трёх проверенных безопасных перенаправлений, но конечный адрес каталога всё равно должен соответствовать корневому пути.

У магазина на размещённой в Shopify теме другая отправная точка: улучшить стандартные данные и публичные пояснения. Переносить витрину ради одного файла не нужно. agents.md.liquid является определённым платформой шаблоном, а не возможностью добавить произвольный корневой файл. App Proxy ограничен префиксами a, apps, community и tools, поэтому напрямую не предоставляет корневой путь каталога.

Руководство для Shopify поможет продолжить разговор с командой сайта. Не добавляйте неподдерживаемый прокси перед доменом ради эксперимента. В официальной инструкции по доменам Shopify указывает, что Cloudflare Proxy, включая O2O, не поддерживается перед размещённым магазином.

Обновляйте знания вместе с товаром

После пилота проверьте, удобно ли находить источник, исправлять старую инструкцию и отвечать на вопрос, который раньше требовал поиска по нескольким страницам. При изменении материала или ухода пересмотрите страницу товара и документ знаний. Возможность поддерживать эту работу полезнее для решения о продолжении, чем число созданных файлов.

Руководство Google по поиску с ИИ прямо говорит, что специальные файлы AI Markdown не улучшают и не ухудшают видимость или позиции в поиске Google. Доступные страницы, точный контент и обычная работа над SEO сохраняют значение. Публикация SKU.md сама по себе не подтверждает, что модель его прочитает.

Сравните этот подход с WooCommerce и многоканальным взглядом BigCommerce. Если существующая витрина позволяет опубликовать документ, откройте генератор для Shopify и начните с каталога бренда.