Главная

AI-документация

Данные карточки товара

Как AI-агенту читать карточку товара

Структура карточки товара Vesremont и данные, которые AI-агент может использовать: идентичность, цена, характеристики, schema.org, отзывы и действия. Исходный файл для машинного чтения: /llms/products.md.

URL и идентичность

Товар открывается по /catalog/product/{product-code}/. Страница размечена schema.org/Product и содержит canonical URL, название, SKU/артикул, GTIN при наличии, бренд, изображения, описание и характеристики.

Основные источники в HTML:

  • itemtype="https://schema.org/Product" — корень товара;
  • itemprop="url", name, sku, mpn, gtin*, brand, image, description;
  • таблица характеристик и additionalProperty/PropertyValue;
  • itemprop="offers"/Offer для цены, валюты и schema availability;
  • itemprop="aggregateRating" при наличии отзывов.

Корень товара и карточки листинга также публикуют data-product-id, data-product-url, data-product-price, data-product-stock и data-product-orderable. Листинг добавляет old-price и discount-percent, когда скидка реально показана. Stateful-кнопки имеют data-agent-action и data-product-id; эти атрибуты описывают действие, но не отменяют требования session + CSRF.

Цена и скидка

Актуальная цена находится в Offer: itemprop="price", валюта — RUB. В листинге также могут отображаться старая цена и процент скидки. На детальной карточке текущая реализация не выводит отдельный old-price/discount контракт, поэтому не переносите старую цену из другой страницы без проверки.

Положительная актуальная цена определяет, можно ли оформить товар. Если цена отсутствует или равна нулю, страница показывает «Недоступно для заказа».

Остаток и получение

При положительном локальном остатке HTML показывает:

  • «На складе N»;
  • inventoryLevel с числом и единицей шт;
  • «Самовывоз Сегодня».

При нулевом остатке эти блоки скрыты, но покупка может оставаться доступной, если цена положительна. Подробности: наличие.

Характеристики и бренд

Характеристики находятся в обычной таблице. Значения, имеющие страницу каталога, являются ссылками. Бренд имеет ссылку /catalog/brand/{brand-code}/ и блок количества товаров бренда.

Аналоги

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

Отзывы и вопросы

Счётчики, вкладки, опубликованные материалы и формы находятся на карточке. Формы stateful и отправляются через JavaScript/AJAX; см. reviews.md.

Действия

  • Избранное — кнопка, session + CSRF, JavaScript/AJAX.
  • В корзину — кнопка, session + CSRF, JavaScript/AJAX.
  • Быстрый заказ — добавляет одну позицию и переводит в корзину; JavaScript/AJAX.
  • Изменение количества — кнопки появляются после чтения корзины из сессии.

Перед state-changing действием прочитайте capabilities.md и не отправляйте заказ без подтверждения пользователя.