NewNo plan feeNo plan fee. Just 2.9% + $0.30 per card sale, and signing up is free.Try now →

Commercio agentico

llms.txt

llms.txt è una convenzione che prevede di posizionare un file markdown nella root di un sito che riassume cos'è il sito e quale URL risponde a quale domanda, in modo che gli assistenti non debbano scansionarlo interamente.

Se i principali assistenti lo utilizzino è ancora sinceramente incerto. Ciò che è certo è l'adozione: abbiamo controllato 58 marchi DTC ben noti e il 73% di quelli raggiungibili ne pubblica già uno — ma il 70% di questi non lo ha scritto, perché Shopify genera automaticamente un file modello. Pubblicarne uno è quindi un requisito di base piuttosto che un vantaggio competitivo.

Questo sposta la domanda utile dal se averne uno al se quello predefinito ti descrive. Un file generato di 4.3KB descrive un negozio generico; non sa quali prodotti contano, quali domande pongono i tuoi acquirenti o cosa ti distingue dagli altri ventidue marchi che pubblicano un documento quasi identico.

L'unica regola che decide se vale qualcosa: generarlo, non scriverlo a mano. Un indice mantenuto a mano si deteriora entro due deploy, e un indice obsoleto è peggio di nessuno perché punta con sicurezza a pagine che si sono spostate.

Ora ci sono prove per questa regola che vanno oltre l'obsolescenza. Tra i negozi che abbiamo trovato che accettano un checkout tramite agente, diversi pubblicano un file scritto a mano che non nomina mai gli endpoint a cui il loro stesso negozio risponde — quindi il file che un team attento ha scritto nasconde una capacità che quello generato annuncia. Leggi cosa c'è a quel percorso prima di sostituirlo.

Come appare il file

La proposta descrive un documento markdown piuttosto che una nuova sintassi da imparare. Si apre con un'intestazione di primo livello che riporta il nome del sito o del progetto, seguita da una breve citazione che spiega cos'è il sito — l'unico paragrafo di cui un lettore senza altro contesto ha bisogno. Può seguirlo una prosa ordinaria.

Sotto di essa seguono sezioni di secondo livello, ognuna contenente un elenco di link con una breve nota per ciascuno: cos'è la pagina e quando è la pagina giusta. Una sezione convenzionalmente riservata al materiale opzionale contrassegna i link che possono essere saltati quando è necessario un contesto più breve, che è l'unica prioritizzazione che il formato stesso prevede.

Una convenzione complementare posiziona un file espanso in un percorso separato, contenente il contenuto stesso piuttosto che un indice di link. I due servono esigenze diverse: uno orienta un lettore che non ha mai visto il sito, l'altro fornisce testo senza elementi di navigazione attorno.

Il formato è volutamente poco appariscente. Tutto ciò che è rilevante della convenzione è editoriale — quali pagine nomini e come le descrivi — perché non c'è nient'altro in esso da sbagliare.

Dove si colloca tra i file destinati alle macchine

La confusione che costa qualcosa ai team non riguarda il formato, ma ciò che il file governa. Posizionarlo accanto alle altre superfici che un negozio pubblica per le macchine rende il confine ovvio.

L'ultima riga è l'intero argomento. Tre di questi hanno consumatori documentati e conseguenze definite; il quarto non ha nessuno dei due, il che è contemporaneamente il motivo per pubblicarne uno e il motivo contro lo spreco di un progetto su di esso.

SuperficieCosa dichiaraConsumatori documentatiCosa va storto se è sbagliato
robots.txtQuali crawler possono recuperare quali percorsiOgni principale crawler documenta di rispettarloUn disallow sconsiderato ti rimuove completamente dai motori di risposta
sitemap.xmlQuali URL esistono e quando sono cambiatiI motori di ricerca documentano la sua letturaScoperta lenta o mancata di pagine nuove e modificate
schema.org JSON-LDQuali sono i fatti su questa paginaI motori di ricerca documentano il suo utilizzo per risultati ricchiUn prezzo o una disponibilità obsoleti producono risposte errate con sicurezza
llms.txtCos'è il sito e quale URL risponde a cosaNessun fornitore di assistenti ha documentato di utilizzarloMolto poco — che è anche il motivo onesto contro lo sforzo
Le quattro superfici destinate alle macchine che un negozio pubblica, e a cosa serve ciascuna.

Cosa non può fare

Tre capacità sono regolarmente attribuite a questo file che esso non possiede, e ognuna ha una sede corretta diversa. Sbagliarle è il modo in cui un team arriva a credere di aver stabilito una politica quando ha scritto un riassunto.

  • Non concede né nega nulla. Non esiste una sintassi direttiva e nessuna semantica di permesso, quindi non può bloccare un crawler. Il permesso è robots.txt per i crawler che lo rispettano, e una regola di bordo per quelli che non lo fanno.
  • Non sostituisce i dati strutturati. Un indice di URL non dice nulla sul prezzo o sulla disponibilità della pagina a cui punta. I fatti appartengono al markup sulla pagina stessa, generati dalla stessa fonte da cui la pagina viene renderizzata.
  • Non è una sitemap. Una sitemap elenca ogni URL per completezza; questo file ne seleziona alcuni e li spiega. Riprodurre la sitemap qui scarta l'unica cosa che il formato offre, ovvero il giudizio editoriale su ciò che conta.

Cosa controllare sul tuo dominio

La maggior parte dei negozi ne serve già uno senza che nessuno abbia deciso di farlo, perché diverse piattaforme lo generano. Questo rende l'audit del file che hai più utile che scriverne uno nuovo, e l'audit consiste in quattro comandi piuttosto che in un progetto.

  • Il content-type. Una rotta che restituisce silenziosamente HTML appare corretta in un browser ed è inutile per una macchina — e una pagina catch-all che risponde 200 a quel percorso è considerata un adottante da qualsiasi sondaggio che controlla i codici di stato piuttosto che il contenuto.
  • Se nomina qualcosa che effettivamente esponi. Un file generato a volte elenca endpoint macchina che una sostituzione scritta a mano omette silenziosamente, quindi leggi cosa c'è prima di sovrascriverlo.
  • Se è generato. Un indice mantenuto a mano si deteriora entro due deploy, e un indice obsoleto è peggio di nessuno perché punta con sicurezza a pagine che si sono spostate.
  • Se qualcosa lo richiede. Cerca nel log degli accessi il percorso. Un file che nessuno recupera non è un'emergenza, ma è l'unica prova diretta disponibile su questa questione e costa un comando ottenerla.

Domande frequenti

Cos'è llms.txt?
Un file markdown nella root di un sito che riassume cos'è il sito e quale URL risponde a quale domanda, in modo che un sistema AI possa orientarsi senza scansionare tutto. È una proposta della comunità piuttosto che uno standard pubblicato da qualsiasi fornitore di motori di ricerca o assistenti, e non concede permessi di alcun tipo.
Cosa va in un file llms.txt?
Un'intestazione con il nome del sito, una breve citazione che dichiara cosa vende il sito e a chi si rivolge, poi sezioni di link con una descrizione di una riga ciascuna — categorie e le pagine che rispondono a domande reali pre-acquisto come taglie, spedizione e resi. Punta all'indice della sitemap per l'elenco completo degli URL piuttosto che riprodurlo.
Dove va il file llms.txt?
Nella root del dominio che i clienti digitano effettivamente, servito come markdown o testo semplice. Controlla il content-type dopo il deploy: una rotta che restituisce silenziosamente HTML viene renderizzata bene in un browser ed è inutile per una macchina, ed è il modo più comune in cui questo file si rompe silenziosamente.
Gli assistenti AI leggono effettivamente llms.txt?
Nessun fornitore di assistenti ha documentato di consumarlo, e Google ha dichiarato pubblicamente che i suoi sistemi non lo fanno. Alcuni log di crawler mostrano che il percorso viene richiesto, ma un recupero non è la stessa cosa di un modello che utilizza il contenuto. Tratta il file come economico e non provato piuttosto che come una tecnica con un risultato atteso.
llms.txt è lo stesso di robots.txt?
No. robots.txt indica quali crawler possono recuperare quali percorsi ed è rispettato volontariamente dai crawler ben educati. llms.txt offre un riepilogo e non concede nulla. Rimuovere robots.txt cambia ciò che i crawler sono autorizzati a fare; rimuovere llms.txt cambia solo ciò che viene loro consegnato come scorciatoia.
Cos'è llms-full.txt?
Una convenzione complementare: invece di un indice di link, un singolo file che contiene il contenuto espanso stesso, in modo che un sistema possa leggere il materiale senza recuperare molte pagine e rimuovere la navigazione da ciascuna. È molto più grande per design e risponde a un'esigenza diversa rispetto al file indice.

Approfondimento: llms.txt funziona davvero?

Termini correlati