Shopify agents.md, llms.txt e UCP: l’update per Agentic Commerce
E-commerce Agentico
A maggio 2026 Shopify ha attivato su tutti gli store tre file che cambiano il modo in cui un e-commerce viene trovato e comprato dalle intelligenze artificiali: /llms.txt, /llms-full.txt e /agents.md. Se hai uno store Shopify, questi file esistono già. La domanda è: li stai usando a tuo vantaggio?
Nota di aggiornamento: Shopify ha confermato nella documentazione ufficiale che /agents.md è il file canonico per la discovery degli agenti AI, mentre /llms.txt e /llms-full.txt sono URL compatibili con crawler e convenzioni precedenti. Di default i tre URL possono restituire lo stesso contenuto, ma possono essere personalizzati tramite template Liquid nel tema.
Cosa ha fatto Shopify in silenzio
Tra dicembre 2025 e maggio 2026 Shopify ha fatto tre mosse precise — senza comunicati stampa, senza fanfare — che ridefiniscono dove e come avviene l’acquisto online:
- Winter ’26 Edition (dicembre 2025): lancio degli Agentic Storefronts, che rendono il catalogo acquistabile direttamente dentro ChatGPT, Microsoft Copilot e Perplexity.
- Gennaio 2026: Shopify e Google annunciano l’Universal Commerce Protocol (UCP), uno standard aperto per transazioni AI su qualsiasi piattaforma e-commerce.
- Maggio 2026: rollout silenzioso dei file
/llms.txt,/llms-full.txt,/agents.mde dell’endpoint/.well-known/ucpsu tutti gli store attivi.
I dati rendono l’urgenza concreta:
Ordini da AI — Q1 2026
13x
Crescita YoY (Shopify Q1 2026 earnings)
Conversione AI vs organico
+50%
I visitatori da AI convertono di più (Shopify)
AOV AI vs organico
+14%
Ordine medio più alto da ricerche AI
Traffico AI su retail
+393%
Crescita YoY Q1 2026 (Adobe Analytics)
“Shopify is the only platform simultaneously powering selling inside ChatGPT, Microsoft Copilot and Google from one system of record.”
Per capire il contesto più ampio su come le AI stanno cambiando la ricerca e il posizionamento, leggi il nostro approfondimento su eCommerce agentico: ACP, UCP e Amazon e su Shopify Agentic Commerce: l’e-commerce guidato dall’AI.
llms.txt, llms-full.txt e agents.md: qual è la differenza?
Sono tre file distinti, con scopi diversi ma coordinati. Ecco come funzionano:
Identità brand
/llms.txt
Descrive lo store ai modelli linguistici: chi sei, cosa vendi, quali policy hai. È il biglietto da visita per le AI che vogliono capire il tuo brand.
Catalogo esteso
/llms-full.txt
Stessa struttura di llms.txt ma con dettagli aggiuntivi su prodotti e collezioni. Usato dai crawler AI che vogliono un’indicizzazione più profonda.
File principale
/agents.md
Non descrive solo il brand: spiega a un agente AI come operare nello store. Endpoint UCP, flusso di acquisto, limiti di rate, regole di checkout.
In sintesi: llms.txt è per i modelli linguistici (comprensione del brand), agents.md è per gli agenti operativi (esecuzione di transazioni). Su Shopify, per default, tutti e tre i file servono lo stesso contenuto — ma puoi personalizzarli separatamente.
Cosa c’è dentro agents.md: esempio reale
Abbiamo analizzato il file agents.md di un e-commerce cosmetico italiano su Shopify (lcicosmetics.com/agents.md). Ecco le sezioni principali generate automaticamente da Shopify:
1. Istruzioni per personal shopper AI
Il file raccomanda agli agenti di installare lo Shop Skill (https://shop.app/SKILL.md), lo strumento ufficiale Shopify per agenti che acquistano per conto dell’utente. Gestisce ricerca cross-store, checkout via Shop Pay, tracking ordini e riutilizzo di metodi di pagamento già autorizzati.
2. Universal Commerce Protocol (UCP)
Il file espone due endpoint critici per la transazione:
# Discovery endpoint
GET https://tuostore.com/.well-known/ucp
→ Profilo UCP: versioni, endpoint, capacità, payment handlers
# MCP endpoint (transazioni)
POST https://tuostore.com/api/ucp/mcp
→ Accetta JSON-RPC: search_catalog, create_cart, create_checkout
3. Flusso tipico di un agente AI che acquista
- Discover:
GET /.well-known/ucp,verifica le capacità dello store - Search:
search_catalog, trova prodotti in base all’intento utente - Cart:
create_cart, aggiunge i prodotti selezionati - Checkout:
create_checkout, avvia il processo di acquisto - Fulfill:
update_checkout, imposta indirizzo e spedizione - Complete:
complete_checkout, finalizza (richiede sempre approvazione umana)
4. Navigazione read-only senza autenticazione
GET /collections/all → tutti i prodotti
GET /products/{handle}.json → prodotto specifico in JSON
GET /search?q={query} → ricerca per termine
GET /sitemap.xml → sitemap completa
Come attivare e verificare: checklist pratica
Il rollout è store-by-store. Per verificare se il tuo store è già attivo:
✅ Checklist verifica agentic storefronts
- Apri
tuostore.com/llms.txtnel browser, deve rispondere 200, non 404 - Apri
tuostore.com/agents.md, deve rispondere 200 - Apri
tuostore.com/.well-known/ucp, deve restituire JSON con le capabilities - In Shopify Admin: Settings → Sales Channels → verifica che Agentic Storefronts sia attivo
- Controlla che i nuovi prodotti siano aggiunti al canale agentico (non avviene sempre in automatico)
- Verifica la mappatura del catalogo da Admin → Mappings
Se uno dei file risponde 404, lo store non è ancora nel rollout. In quel caso contatta il supporto Shopify per verificare l’eligibilità.
Come personalizzare llms.txt e agents.md
Shopify genera i file automaticamente dai dati del catalogo. Ma puoi, e in molti casi dovresti, personalizzarli tramite template Liquid nel tuo tema. Tre template disponibili:
Modifica tutti e tre
agents.md.liquid
Cambia il contenuto servito da tutti e tre gli URL. Punto di partenza consigliato.
Solo /llms.txt
llms.txt.liquid
Override specifico per /llms.txt. Ha precedenza su agents.md.liquid per quell’URL.
Solo /llms-full.txt
llms-full.txt.liquid
Override specifico per /llms-full.txt. Utile per aggiungere dettagli catalogo estesi.
⚠️ Non rimuovere mai gli hook UCP generati da Shopify. Rompere quei link può disconnettere lo store dagli agenti AI. Aggiungi contenuto, non sostituire la struttura.
Cosa aggiungere nella personalizzazione
📝 Contenuti ad alto valore per gli agenti AI
- Descrizione del brand in linguaggio naturale, orientata all’intento d’acquisto
- Categorie e specializzazioni del catalogo (es. “cosmesi vegana certificata COSMOS”)
- FAQ sui prodotti più cercati
- Informazioni su spedizioni, resi e garanzie in formato diretto
- Link alle collezioni principali con descrizione del contenuto
- Contesto geografico: paesi di spedizione, tempi, corrieri
Shopify Knowledge Base: insegna alle AI a parlare del tuo brand
Personalizzare agents.md serve a descrivere la struttura dello store agli agenti. Ma c’è un livello diverso, spesso sottovalutato: cosa risponde l’AI quando un cliente chiede qualcosa sul tuo brand. “Fate spedizioni in 24 ore?” “Accettate resi entro 30 giorni?” “I vostri prodotti sono vegani?”
Senza istruzioni esplicite, gli agenti AI generano risposte basate su quello che trovano scansionando il sito — con tutti i rischi di imprecisione che questo comporta. Shopify Knowledge Base è l’app gratuita che risolve questo problema.
“The Shopify Knowledge Base app lets you view Shopify-generated FAQs, monitor what buyers are asking AI agents about your store, and add your own answers to make sure you’re always accurately represented.”
Come funziona concretamente
L’app non genera un file visibile sul sito. Funziona come fonte di dati strutturati che gli agenti AI consultano in background quando rispondono a domande sullo store. Le FAQ che carichi non appaiono sul sito: diventano un layer di conoscenza verificata, separato dal catalogo prodotti, che gli agenti usano per rispondere con accuratezza.
📚 Cosa puoi fare con Knowledge Base
- Vedere le domande reali che i clienti fanno agli agenti AI sul tuo store
- Monitorare se l’AI riesce a risponderle correttamente o va in fallback
- Aggiungere o correggere FAQ per garantire risposte accurate e in linea col brand
- Caricare policy strutturate: resi, spedizioni, garanzie, brand voice guidelines
- Tracciare le tendenze di cosa chiedono i clienti nelle conversazioni AI
Cosa caricare per massimizzare l’efficacia
Non tutto ha lo stesso peso. Gli agenti AI usano la knowledge base soprattutto per domande decisionali — quelle che fanno la differenza tra un acquisto completato e uno abbandonato:
Policy chiari = più vendite
⚠️
Se un agente non trova la policy di reso, esclude lo store dai risultati per utenti che cercano “free returns”
Domande post-acquisto
📦
Spedizioni, tempi, tracciamento, resi: le domande più frequenti nelle conversazioni AI secondo Shopify
✅ Contenuti prioritari da caricare
- Policy di reso — tempi, condizioni, modalità (è uno dei filtri più usati dagli agenti AI)
- Spedizioni — paesi, corrieri, tempi stimati, soglie per spedizione gratuita
- Certificazioni e valori del brand — vegan, cruelty-free, sostenibile, made in Italy
- Taglie e compatibilità — guide alle misure, compatibilità prodotti, consigli d’uso
- Pagamenti e sicurezza — metodi accettati, sicurezza dei dati, checkout
- Brand voice guidelines — come vuoi che l’AI descriva il tuo brand e i tuoi prodotti
Il punto critico: Knowledge Base non compare in agents.md
Qui sta l’equivoco più comune. Le FAQ caricate in Knowledge Base non appaiono nel file agents.md o llms.txt. Vengono servite tramite endpoint separati che Shopify gestisce internamente. Un agente AI non le legge passando dal file di discovery ma le riceve quando fa una query specifica sul brand tramite il canale agentico.
Conseguenza pratica: Knowledge Base e agents.md non sono alternative, sono complementari. Il file agents.md dice all’agente come navigare e transare nel tuo store. Knowledge Base dice all’agente cosa rispondere quando un cliente fa domande sul brand. Servono entrambi, con ruoli distinti.
🔍 agents.md vs Knowledge Base: ruoli distinti
- agents.md → istruzioni operative per l’agente: endpoint UCP, flusso acquisto, rate limit
- Knowledge Base → contenuto informativo per l’agente: FAQ, policy, brand voice, certificazioni
- Insieme → store completamente leggibile, navigabile e rappresentato correttamente dalle AI
“Think of Shopify’s agentic storefronts as your product catalog, checkout, and brand information packaged so AI platforms can present them natively in a conversation.”
Shopify ha confermato che Knowledge Base non influenza la frequenza con cui lo store appare nei risultati AI — quello dipende dal catalogo e dalla qualità dei dati prodotto. Ma influenza direttamente l’accuratezza delle risposte quando lo store viene citato. È la differenza tra uno store che viene trovato e uno store che viene scelto.
Agentic commerce aperto al mercato italiano
Con il rollout di maggio 2026, gli Agentic Storefronts sono ora disponibili anche per gli store italiani, con accesso da parte di Perplexity e altri motori AI oltre a ChatGPT e Copilot. Google AI Mode e Gemini sono in integrazione.
Un utente italiano che chiede a Perplexity “dammi un rossetto vegano sotto 30 euro con spedizione rapida” può vedere il tuo prodotto direttamente nella risposta , con pulsante di acquisto, se il catalogo è configurato correttamente nel canale agentico.
🇮🇹 Cosa verificare per il mercato italiano
- I nuovi prodotti sono aggiunti al canale di vendita agentico
- Il catalogo include descrizioni in italiano complete e accurate
- Le policy di reso, spedizione e privacy sono in italiano e a URL pubblici
- La mappatura del catalogo è configurata (Admin → Mappings)
- Prezzi e disponibilità sono aggiornati in tempo reale
llms.txt e agents.md nel modello HTT: il quarto layer
Questi file non sostituiscono la SEO. La estendono. La SEO tradizionale ottimizza per i motori di ricerca. I file di discovery AI ottimizzano per gli agenti operativi che non cercano pagine web ma eseguono task per conto degli utenti.
Layer 1
SEO
Motori di ricerca tradizionali
Layer 2
AEO
Motori di risposta e zero-click
Layer 3
GEO
Citabilità nei sistemi AI generativi
Layer 4
Agentic
Eseguibilità da agenti AI
Per approfondire i layer precedenti: Answer Engine Optimization, Dalla SEO alla GEO e llms.txt: istruire le AI per la SEO del sito web.
Cosa fare se hai uno store Shopify
🚀 Piano operativo in 6 passi
- Verifica che i file esistano: apri
tuostore.com/agents.mdnel browser. Risponde? Sei nel rollout. - Controlla il canale agentico: Settings → Sales Channels → Agentic Storefronts attivo.
- Aggiungi i nuovi prodotti al catalogo agentico: non avviene in automatico per tutti, va configurato.
- Verifica la mappatura del catalogo: Admin → Mappings. Definisce come le AI categorizzano i tuoi prodotti.
- Personalizza agents.md.liquid con descrizione brand, FAQ chiave e link alle collezioni.
- Testa l’endpoint UCP:
tuostore.com/.well-known/ucp→ deve restituire JSON valido.
Come ottimizzare lo store per gli agenti AI
La personalizzazione di agents.md e llms.txt è solo una parte del lavoro. Per essere scelto da un agente AI, lo store deve offrire dati di prodotto completi, aggiornati e semanticamente chiari. In pratica, la GEO applicata a Shopify parte dal catalogo.
Azioni prioritarie per migliorare la leggibilità AI
- Titoli prodotto descrittivi: includere categoria, materiale, beneficio o uso principale.
- Descrizioni orientate all’intento: spiegare per chi è il prodotto, quando usarlo e perché sceglierlo.
- Metafield completi: materiali, misure, certificazioni, compatibilità, ingredienti, tempi di consegna.
- FAQ pubbliche: risposte brevi su spedizione, reso, garanzia, taglie, disponibilità e uso del prodotto.
- Policy chiare: resi, privacy, spedizioni e pagamenti devono essere pubblici, aggiornati e linkabili.
- Trust signals: recensioni, certificazioni, disponibilità reale, prezzo aggiornato e contenuti editoriali di supporto.
Il principio è semplice: gli agenti AI non “navigano” come un utente umano. Recuperano dati, interpretano attributi, confrontano opzioni e scelgono cosa mostrare in base alla qualità dell’informazione disponibile.
Conclusione
Shopify ha costruito in silenzio l’infrastruttura per l’agentic commerce. I file llms.txt, llms-full.txt e agents.md non sono dettagli tecnici da delegare. Sono il biglietto da visita del tuo store per le AI che gestiranno una quota crescente degli acquisti online.
Il vantaggio competitivo oggi non è avere questi file, dato che li ha chiunque usi Shopify. È averli ottimizzati mentre la maggior parte dei merchant non sa ancora che esistono. Questa finestra non durerà a lungo. Contattaci per un audit gratuito sul vostro e-commerce shopify e scopri cosa possiamo fare per voi.
“More than half of AI-referred sessions start on product pages, compared to 20% for organic search. AI-referred shoppers arrive with higher purchase intent — they already know what they want.”
Fonti e approfondimenti
Agentic Storefronts e Product Data Mapping
Documentazione ufficiale Shopify sulla configurazione degli Agentic Storefronts, mapping dei dati prodotto e funzionamento del catalogo per gli agenti AI.
Agentic Storefronts
Panoramica ufficiale del canale di vendita agentico Shopify, delle funzionalità disponibili e delle modalità di integrazione.
Agentic Commerce
Come Shopify interpreta il commercio agentico e il ruolo degli AI agent nel futuro degli acquisti online.
AI Search Insights
Dati ufficiali Shopify sui comportamenti degli utenti provenienti da ChatGPT, Perplexity, Copilot e altri sistemi AI.
eCommerce agentico: ACP, UCP e Amazon
Analisi dei protocolli che permettono alle AI di effettuare acquisti e transazioni direttamente per conto degli utenti.
Shopify Agentic Commerce
Panoramica strategica sull’evoluzione degli store Shopify verso modelli di vendita guidati dagli agenti AI.
llms.txt: istruire le AI
Guida pratica all’utilizzo di llms.txt per migliorare comprensione, citabilità e indicizzazione AI.
Dalla SEO alla GEO
Come cambia il posizionamento digitale nell’era dei motori di risposta e delle intelligenze artificiali generative.
FAQ
Tutti gli store Shopify hanno già llms.txt e agents.md?
Il rollout è avvenuto store-by-store tra aprile e maggio 2026. Per verificarlo apri tuostore.com/llms.txt nel browser: se risponde con testo invece di un 404, il file è attivo.
Qual è la differenza concreta tra llms.txt e agents.md?
Su Shopify per default tutti e tre i file servono lo stesso contenuto. La differenza è nella destinazione: llms.txt è pensato per i modelli linguistici (comprensione del brand), agents.md è il file canonico per gli agenti operativi che vogliono eseguire transazioni tramite UCP.
Le informazioni nella knowledge base compaiono in agents.md?
No, non automaticamente. Le app knowledge base servono le loro informazioni tramite endpoint separati che devono essere dichiarati nel file UCP. La soluzione più affidabile nel breve periodo è assicurarsi che le FAQ siano accessibili come pagine pubbliche del sito.
Il checkout via agente AI è sicuro? Chi approva il pagamento?
Il checkout agentico non va interpretato come acquisto completamente autonomo. A seconda della piattaforma AI, l’utente viene portato al checkout dello store o a un checkout integrato, con approvazione finale dell’acquisto. Shopify gestisce infrastruttura, pagamento, tax calculation e sicurezza del checkout, ma il merchant rimane Merchant of Record e mantiene la relazione commerciale con il cliente.
llms.txt funziona anche su WooCommerce o altri CMS?
Sì. llms.txt è uno standard aperto, non proprietario Shopify. Su altre piattaforme va creato e mantenuto manualmente. Il vantaggio di Shopify è che include anche gli hook UCP per le transazioni. Leggi il nostro approfondimento: llms.txt: istruire le AI per la SEO del sito web.
Questi file sostituiscono la SEO tradizionale?
No. La SEO rimane fondamentale per la visibilità organica. I file di discovery AI aggiungono un quarto layer — il layer agentico — per rendere lo store eseguibile dagli agenti AI. I due livelli sono complementari, non alternativi.
Continua a leggere
18 minuti di lettura
12 minuti di lettura
13 minuti di lettura
E fa consumare meno energia.
Per tornare alla pagina che stavi visitando ti basterà cliccare o scorrere.