← Все темы помощи

Витрина для агентов (UCP) на любой платформе

ИИ-агенты находят магазины через манифест /.well-known/ucp. Магазинам на WooCommerce его даёт плагин Botmetria, самописным PHP и Node.js — открытые SDK. Этот гайд — про полностью статический / self-hosted путь: как отдавать файлы и каков формат. Путь без кода — из товарного фида через кабинет (карточка ниже).

Как отдавать манифест

У файла нет расширения, поэтому веб-серверу нужно сказать отдавать его как JSON:

nginx

location = /.well-known/ucp {
    default_type application/json;
    alias /var/www/your-site/ucp-manifest.json;
    add_header X-Robots-Tag noindex;
}

Apache (.htaccess)

<Files "ucp">
    ForceType application/json
    Header set X-Robots-Tag noindex
</Files>

Правила .htaccess положите внутрь каталога .well-known (рядом создайте обычный файл с именем «ucp»).

Статический способ (без аккаунта Botmetria)

Каталог маленький или фида нет? Опубликуйте оба файла руками. Манифест (подставьте свой домен и валюту; endpoints.catalog может указывать на любой URL вашего сайта):

{
  "ucp_version": "1",
  "profile": {
    "name": "your-store.com",
    "url": "https://your-store.com/",
    "currency": "EUR",
    "country": ""
  },
  "capabilities": { "catalog": true, "checkout": false, "payment": false },
  "endpoints": {
    "catalog": "https://your-store.com/ucp-catalog.json",
    "feed": ""
  },
  "policies": {},
  "payment_methods": []
}

И сам каталог — JSON-страница товаров в каноническом формате (цена — десятичная строка, availability — in_stock / out_of_stock / unknown):

{
  "data": [
    {
      "id": "101",
      "name": "Product name",
      "description": "Short plain-text description.",
      "description_full": "Full plain-text description.",
      "url": "https://your-store.com/product/101",
      "sku": "SKU-101",
      "gtin": "",
      "brand": "",
      "category": ["Category"],
      "currency": "EUR",
      "price": "49.00",
      "availability": "in_stock",
      "stock_qty": null,
      "images": ["https://your-store.com/img/101.jpg"],
      "attributes": {},
      "rating": null
    }
  ],
  "next_cursor": null
}

Проверьте, что работает

1. Откройте https://ваш-домен/.well-known/ucp в браузере — должен показаться JSON (а не страница 404).
2. Запустите демо покупки агентом на своём домене: с витриной агент пройдёт «манифест → каталог → выбор» и честно скажет, что чекаут выключен.