Come rendere la documentazione pronta per l'IA per ChatGPT e Claude

Aggiornato il 3 novembre 2026

Per rendere la documentazione pronta per l'IA, parti dalle basi che contano davvero: i crawler IA devono poter recuperare le tue pagine come HTML semplice, il tuo robots.txt deve consentire l'accesso ai bot di ricerca e ogni articolo deve rispondere chiaramente a una domanda, indicando piano, ruolo e limiti. Mantieni le pagine aggiornate, poi aggiungi copie in Markdown, un llms.txt e un server MCP per gli agenti IA. Questi extra sono economici, ma il loro effetto misurabile sulle risposte dell'IA è finora limitato.

Questa guida è rivolta ai responsabili dell'assistenza i cui clienti chiedono ormai a ChatGPT, Perplexity o agli AI Overviews di Google come usare il prodotto, e ai team i cui sviluppatori puntano Claude Code o Cursor verso la documentazione. Distingue ciò che è supportato da prove concrete da ciò che è ancora una scommessa.

Cosa significa documentazione pronta per l'IA?#

La documentazione pronta per l'IA è quella che i sistemi di IA possono recuperare, comprendere e citare correttamente: documentazione leggibile dall'IA per i motori di risposta e documentazione per gli agenti IA che agiscono in base ad essa. Due tipi di lettori sono importanti:

• Motori di risposta (ricerca di ChatGPT, Perplexity, Claude, Google AI Overviews e AI Mode) rispondono alle domande dei tuoi clienti e citano le pagine come fonti.
• Agenti IA (Claude Code, Cursor, Codex, assistenti personalizzati) leggono la tua documentazione per eseguire un compito, spesso tramite file Markdown o un server MCP.

Entrambi crescono rapidamente. Il sondaggio del 2025 di Stack Overflow ha rilevato che l'84% degli sviluppatori utilizza o prevede di utilizzare strumenti di IA, e Similarweb ha contato 1,13 miliardi di visite di riferimento da piattaforme IA nel giugno 2025, in crescita del 357% rispetto all'anno precedente, con ChatGPT che ne genera oltre l'80%. E quando Google mostra un riepilogo IA, le persone cliccano meno: Pew Research ha rilevato che gli utenti hanno cliccato su un link nei risultati nell'8% delle visite con un riepilogo IA, contro il 15% senza. Se la risposta viene mostrata senza il clic, è meglio che sia corretta, ed è corretta solo quanto la tua documentazione. Altri numeri su dove i clienti cercano aiuto si trovano nelle nostre statistiche sul self-service dei clienti.

I crawler IA possono davvero leggere il tuo centro assistenza?#

Verifica prima questo aspetto, perché nient'altro conta se la risposta è no.

Il testo è nell'HTML? L'analisi del traffico dei crawler di Vercel di dicembre 2024 ha rilevato che nessuno dei principali crawler IA esegue JavaScript, con le eccezioni del crawler di Gemini di Google e di quello di Apple. Un centro assistenza che carica i propri articoli con JavaScript lato client può apparire vuoto ai crawler di ChatGPT e Claude. Mettilo alla prova:

curl -s -A "GPTBot" https://help.example.com/your-article \
  | grep "a sentence from the article"

Se la frase non è nella risposta, anche il crawler non la vede. Le pagine renderizzate lato server o pre-renderizzate risolvono il problema.

I tuoi URL funzionano? Negli stessi dati di Vercel, circa il 35% dei recuperi dei crawler di ChatGPT e Claude ha riscontrato pagine 404. Mantieni i redirect quando sposti o rinomini gli articoli e tieni aggiornata la sitemap. Se stai cambiando piattaforma, segui una checklist per la migrazione del centro assistenza.

La pagina è pubblica? I motori di risposta non possono leggere le pagine protette da login. Se hai documentazione privata per i clienti, accetta il fatto che le risposte dell'IA proverranno invece dalle tue pagine pubbliche, dai forum e da siti di terze parti.

Quali bot IA dovrebbe consentire il tuo robots.txt?#

Ogni azienda di IA gestisce bot separati per l'addestramento e per la ricerca. Bloccare "tutti i bot IA" ti esclude anche dalle risposte dell'IA.

I dettagli provengono dalla documentazione di ciascuna azienda: OpenAI, Anthropic e Perplexity. Un centro assistenza che vuole essere citato ma non utilizzato per l'addestramento può dire:

User-agent: GPTBot
Disallow: /

User-agent: ClaudeBot
Disallow: /

User-agent: Google-Extended
Disallow: /

User-agent: *
Allow: /

Sitemap: https://help.example.com/sitemap.xml

Un bot che ha il proprio gruppo ignora le regole *, quindi ripeti eventuali righe Disallow (come /admin) in ogni gruppo nominato. Bloccare Google-Extended impedisce anche alle app Gemini di basare le risposte sulle tue pagine; la Ricerca Google e gli AI Overviews non ne sono influenzati.

Controlla anche la tua CDN o il firewall. Un interruttore "blocca bot IA" lì può sovrascrivere un robots.txt permissivo.

Come dovresti scrivere gli articoli di assistenza affinché l'IA risponda correttamente?#

I motori di risposta estraggono un passaggio, non l'intero sito. Ogni passaggio deve essere autosufficiente.

• Un compito per articolo, chiamato come lo chiedono i clienti. "Annulla o metti in pausa l'abbonamento", non "Gestione abbonamento".
• Rispondi subito. Le prime due frasi sotto ogni intestazione dovrebbero rispondere a quell'intestazione. Il nostro modello di articolo per il centro assistenza è costruito in questo modo.
• Specifica le condizioni. Quale piano, quale ruolo, quale piattaforma. "Solo gli amministratori possono eliminare un'area di lavoro" è citabile; "puoi eliminare un'area di lavoro" produce risposte errate per tutti gli altri.
• Dì cosa il prodotto non può fare. Agli assistenti viene spesso chiesto "posso...?" Se la tua documentazione descrive solo ciò che esiste, il modello tira a indovinare.
• Usa un solo nome per ogni cosa e definiscilo una volta. Se "area di lavoro", "account" e "organizzazione" significano la stessa cosa, scegline uno e tieni una breve pagina di glossario che definisce i termini del tuo prodotto.
• Dai a ogni pagina metadati puliti. Un titolo specifico, una descrizione di una riga, una data dell'ultimo aggiornamento e, ove applicabile, il piano o l'area del prodotto. I motori di risposta e la tua ricerca li usano per decidere quale pagina risponde a una domanda.
• Non nascondere i passaggi in immagini o video. Dai a ogni screenshot un testo alternativo reale e assicurati che ogni passaggio mostrato in un video esista anche come testo.
• Copri le basi prima dei casi limite. Se stai ancora costruendo il centro assistenza, inizia da come costruire una knowledge base con l'IA.
• Mantienilo aggiornato. Un articolo obsoleto è ora una risposta obsoleta, ripetuta con sicurezza. La nostra guida su come mantenere aggiornata la documentazione copre una routine di rilascio per rilascio, e come aggiornare automaticamente la documentazione a ogni rilascio mostra come avviarla dal rilascio stesso.

Google afferma lo stesso in parole più semplici: per le sue funzionalità IA, "non ci sono requisiti aggiuntivi" e non sono necessarie ottimizzazioni speciali oltre alla normale SEO. La sua guida dice anche che non è necessario suddividere i contenuti in piccoli pezzi per l'IA, quindi non frammentare gli articoli per adattarli a un modello.

Dovresti aggiungere llms.txt per la documentazione?#

Aiuta meno di quanto suggeriscano i fornitori. llms.txt è un file Markdown nella root del tuo sito che elenca le tue pagine più utili con brevi descrizioni. Jeremy Howard lo ha proposto nel settembre 2024 come mappa per i modelli linguari.

Le prove finora:

• Google lo ignora. La guida di Google afferma che non servono nuovi file leggibili dalle macchine, file di testo AI, markup o Markdown per apparire nella Ricerca Google, e che i file llms.txt non aiuteranno né danneggeranno, poiché la Ricerca li ignora. Nel 2025, John Mueller di Google ha paragonato llms.txt al meta tag keywords.
• Pochi bot lo richiedono. Ahrefs ha analizzato 137.210 domini e ha scoperto che il 97% dei file llms.txt ha ricevuto zero richieste a maggio 2026. I bot di recupero AI hanno effettuato solo l'1,1% delle richieste arrivate (gli assistenti AI un altro 2,5%); gli agenti di programmazione come Claude Code erano tra i principali lettori menzionati.

Quindi: aggiungi un llms.txt se la tua piattaforma di documentazione lo rende gratuito, specialmente se gli sviluppatori usano la tua documentazione con agenti di programmazione, ma non aspettarti che cambi ciò che ChatGPT dice su di te. llms-full.txt (tutte le pagine in un unico file) è una convenzione comune, non parte della proposta.

La tua documentazione dovrebbe essere disponibile in Markdown?#

Sì, se non ti costa nulla. Gli agenti che recuperano una pagina funzionano meglio con un Markdown pulito rispetto a un HTML pieno di navigazione e script, e la proposta llms.txt suggerisce di servire ogni pagina allo stesso URL con .md aggiunto. Tre dettagli:

• Contrassegna le copie Markdown come noindex (un'intestazione X-Robots-Tag funziona), così i motori di ricerca non le tratteranno come duplicati delle pagine HTML.
• Mantienile generate dalla stessa fonte dell'HTML, in modo che non si disallineino mai.
• Lascia che gli agenti le trovino: la proposta suggerisce un tag <link rel="alternate" type="text/markdown"> su ogni pagina HTML.

Come usano la documentazione gli agenti AI tramite MCP?#

Il Model Context Protocol è uno standard aperto che consente a un'applicazione AI di richiamare strumenti e leggere dati da altri sistemi. Un server MCP per la documentazione permette a un agente di cercare nella tua documentazione su richiesta invece di affidarsi a ciò che ha appreso durante l'addestramento e, con le giuste autorizzazioni, di redigere o aggiornare le pagine. Per un confronto dei server disponibili, vedi Server MCP per la documentazione.

Le stesse regole si applicano se crei il tuo assistente sulla tua documentazione (generazione aumentata dal recupero, o RAG): può essere accurato solo quanto i passaggi che recupera. Due avvertenze: concedi l'accesso in sola lettura a tutto ciò che è rivolto al cliente, a meno che una persona non revisioni le scritture, e ricorda che MCP aiuta gli agenti che i tuoi utenti collegano da soli. Non cambia ciò che dicono i motori di risposta pubblici.

Come testi ciò che gli assistenti AI dicono del tuo prodotto?#

Nessuno può vedere all'interno dei modelli, quindi testa l'output. Una volta al mese:

1. Scrivi 20 domande reali dei clienti provenienti da ticket e ricerche fallite nel centro assistenza.
2. Poni ciascuna domanda a ChatGPT, Perplexity, Claude e Google (Modalità AI o Panoramiche AI).
3. Registra se la risposta è corretta e quale pagina cita.

4. Correggi l'articolo da cui ogni risposta errata avrebbe dovuto provenire, poi rifai la domanda il mese successivo.

Per vedere il lato del traffico, segmenta le visite per referrer (chatgpt.com, perplexity.ai, claude.ai) e controlla i log del tuo server per i nomi dei bot nella tabella sopra (eccetto Google-Extended, che non ha un proprio user agent). Google conta i clic dalle funzionalità AI nel Rapporto sulle prestazioni di Search Console, sotto il tipo di ricerca Web.

Come rendere la documentazione pronta per l'AI: la checklist#

Come i centri assistenza Clevera sono costruiti per i lettori AI#

Clevera è una piattaforma AI che trasforma una registrazione dello schermo in un video tutorial narrato, un articolo di assistenza passo-passo e una pagina sul tuo centro assistenza ospitato, in 74 lingue. I suoi centri assistenza ospitati gestiscono la maggior parte della metà tecnica della checklist, su ogni piano incluso quello Gratuito:

• Pagine prerenderizzate e una sitemap, in modo che il testo dell'articolo sia nell'HTML che i crawler recuperano.
• llms.txt, llms-full.txt e una copia .md di ogni pagina, sotto l'impostazione llms.txt e copie Markdown ("Consenti agli strumenti AI di leggere la tua documentazione"), che è attiva per impostazione predefinita. Sul nostro centro assistenza le copie Markdown sono servite con noindex. I centri assistenza privati (Pro e superiori) mantengono tutto questo dietro l'accesso.
• Chiedi all'AI per i tuoi lettori (attiva Mostra l'assistente in Impostazioni → Assistente AI; 300 risposte al mese sul piano Gratuito). L'assistente integrato risponde solo dalle tue pagine pubblicate, collega le sue fonti, lo comunica quando la documentazione non copre una domanda ed elenca tali domande sotto Domande senza risposta così sai cosa scrivere dopo (la nostra guida ai gap di contenuto del centro assistenza mostra come lavorarci).
• Agenti AI e MCP (Pro e superiori). Claude Code, Codex, Cursor, Claude o ChatGPT possono cercare, redigere e, con i diritti di pubblicazione, aggiornare il tuo centro assistenza tramite il server MCP e l'API di Clevera. Un token Assistente di supporto può cercare solo pagine pubblicate e pubbliche.

Questa è la parte superiore del llms.txt che il nostro centro assistenza pubblica (accorciato):

# Clevera Help Center

> Clevera turns screen recordings into polished videos: record your screen
> or let the AI record a website, edit with zooms, captions and AI
> voice-overs, then share or embed the result. ...

Every page is also available as Markdown: append `.md` to its URL.
The full text of all pages is at https://help.clevera.ai/llms-full.txt.

### Getting started

- [Understand what Clevera makes](https://help.clevera.ai/docs/getting-started/what-clevera-makes.md): ...

La metà della scrittura rimane tua, e Clevera aiuta anche lì: gli articoli generati da una registrazione dello schermo risultano come passaggi numerati con screenshot di ciò che è sullo schermo, e la registrazione dietro un video può anche produrre il suo articolo scritto, così i passaggi non vivono solo in un video. Nessuna piattaforma può promettere che ChatGPT ti citerà, e non lo facciamo nemmeno noi.

Inizia gratuitamente con un centro assistenza ospitato, o importa quello attuale da Zendesk, Intercom, GitBook e altre piattaforme. Le impostazioni sono in Controlla chi può leggere un sito di documentazione, Configura l'assistente del sito di documentazione e Collega gli agenti AI ai tuoi siti di documentazione. La panoramica del prodotto è sulla pagina del software per centri assistenza e nel nostro post di lancio dei siti di documentazione.

FAQ#

Vale la pena aggiungere llms.txt a un centro assistenza?#

Aggiungilo se la tua piattaforma lo genera gratuitamente. Non costa nulla e gli agenti di programmazione lo leggono, ma Google non lo usa e gli studi mostrano quasi nessuna richiesta da parte dei bot di ricerca AI. L'HTML scansionabile e articoli chiari e aggiornati contano molto di più.

Come faccio a far rispondere correttamente ChatGPT alle domande sul mio prodotto?#

Assicurati che OAI-SearchBot possa scansionare il tuo centro assistenza pubblico, che il testo dell'articolo sia nell'HTML e che ogni articolo risponda a una domanda con le condizioni dichiarate. Poi testa mensilmente le domande reali dei clienti e correggi le pagine dietro le risposte errate. Questo migliora le probabilità; nessuno può far sì che ChatGPT ti citi.

Dovrei bloccare GPTBot e ClaudeBot?#

Questa è una decisione di addestramento, non di visibilità. Bloccare GPTBot e ClaudeBot mantiene la tua documentazione fuori dall'addestramento del modello; non ti rimuove dalla ricerca di ChatGPT o Claude, che usano OAI-SearchBot e Claude-SearchBot. Non bloccarli se vuoi essere citato.

I dati strutturati aiutano le Panoramiche AI?#

Google afferma che non è necessario alcuno schema speciale per le funzionalità AI. Usa i dati strutturati dove descrivono il contenuto visibile, come faresti per la normale ricerca.

Qual è la differenza tra documentazione pronta per l'AI e un chatbot AI sul mio centro assistenza?#

La documentazione pronta per l'IA aiuta gli assistenti esterni a rispondere basandosi sulle tue pagine. Un chatbot per il centro assistenza, come Ask AI di Clevera, risponde ai tuoi lettori direttamente sul tuo sito utilizzando le stesse pagine. Entrambi dipendono da articoli chiari e aggiornati.