← Toate subiectele de ajutor

Vitrină pentru agenți (UCP) pe orice platformă

Agenții AI descoperă magazinele prin manifestul /.well-known/ucp. Magazinele WooCommerce îl primesc din pluginul Botmetria, cele PHP și Node.js proprii — din SDK-urile open-source. Acest ghid acoperă calea complet statică / self-hosted: cum se servesc fișierele și formatul. Calea fără cod — din feedul de produse, prin panou (cardul de mai jos).

Cum se servește manifestul

Fișierul nu are extensie, deci serverul web trebuie să-l servească drept 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>

Puneți regulile .htaccess în directorul .well-known (creați alături fișierul simplu numit „ucp”).

Metoda statică (fără cont Botmetria)

Catalog mic sau fără feed? Publicați ambele fișiere manual. Manifestul (puneți domeniul și valuta dvs.; endpoints.catalog poate indica orice URL de pe site):

{
  "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": []
}

Și catalogul propriu-zis — o pagină JSON de produse în format canonic (prețul e șir zecimal, 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
}

Verificați că funcționează

1. Deschideți https://domeniul-dvs/.well-known/ucp în browser — trebuie să vedeți JSON-ul (nu o pagină 404).
2. Rulați demo-ul cumpărăturii cu agent pe domeniul dvs.: cu vitrina, agentul trece „manifest → catalog → alegere” și spune onest că checkout-ul e oprit.