Una pagina di documentazione può sembrare completa in un browser mentre il suo codice HTML originale non contiene il testo di cui il lettore ha bisogno. Un agente AI che recupera quella pagina tramite una semplice richiesta HTTP senza eseguire JavaScript mancherà quel testo. Agentic Engine Optimization (AEO) aiuta a identificare queste barriere controllando l'accesso ai contenuti, la struttura e le modalità per scoprire il materiale correlato.
L’audit AEO di Milten esamina una pagina selezionata e i file pubblici del sito. Il report mostra i controlli superati, i problemi da approfondire e le informazioni mancanti.
Cos'è Agentic Engine Optimization?
Agentic Engine Optimization significa preparare un sito Web che gli agenti AI possano leggere e utilizzare. Per la documentazione, ciò significa che un agente può recuperare la descrizione di un'operazione, trovare un esempio e seguire un collegamento a un riferimento correlato.
L'audit è utile per guide di integrazione, riferimenti API e pagine con esempi tecnici. Completa la SEO esaminando il modo in cui un client software può accedere ai contenuti pubblicati. Il rapporto non misura le classifiche di ricerca o la probabilità di essere citati nelle risposte dell’intelligenza artificiale.
Cosa verifica l’audit del sito web di un AEO?
L’audit AEO esamina otto aspetti, raggruppati qui sotto. Consulta il singolo report per sapere quali controlli si applicano e come viene calcolato il punteggio:
| Gruppo | Elementi esaminati |
|---|---|
| Scoperta dei contenuti | Regole di robots.txt e indice llms.txt |
| Struttura della pagina | Titoli, markup semantico, esempi, Markdown e indizi di dipendenza da JavaScript |
| Dimensione del contesto | Numero di token e metadati della pagina |
| Regole di interazione | Descrizioni di accessi e vincoli in agent-permissions.json |
| Trasferimento del testo a un agente | Comandi per copiare i contenuti e collegamenti al testo originale |
Ogni controllo presenta un esito e osservazioni; il contributo al punteggio dipende dalle regole del report. Per esempio, l’audit verifica sia la presenza di llms.txt sia i suoi link, le descrizioni e le sezioni. Il solo file non rende la documentazione facile da usare.
I conteggi dei token aiutano a stimare la quantità di testo che un modello dovrebbe elaborare. Non calcolano i costi della richiesta, poiché i modelli utilizzano tokenizzatori e prezzi diversi.
L'audit esamina la risposta originale del server senza eseguire JavaScript. Cerca segnali strutturali di problemi ma non esegue un agente AI su un'attività dell'utente. Controllare se un particolare agente può utilizzare la documentazione richiede un tentativo separato di svolgere tale attività.
In che modo ARD aiuta gli agenti a scoprire le risorse del sito
Agentic Resource Discovery (ARD) descrive la scoperta delle risorse disponibili per un client AI, come un'API, un server MCP o un flusso di lavoro. Il client può utilizzare una descrizione per trovare una risorsa adatta, quindi accedervi tramite l'interfaccia di quella risorsa.
La sezione ARD verifica come vengono pubblicate queste descrizioni. Cerca /.well-known/ard.json, link nell’HTML e nelle intestazioni HTTP, direttive Agentmap in robots.txt e ARD JSON-LD incorporato. Riconosce anche il formato precedente ai-catalog.json, per individuare materiali che potrebbero richiedere una migrazione.
Nel report vengono elencate le risorse rilevate, gli indirizzi delle loro descrizioni, gli errori nei campi e gli eventuali limiti che impedivano un controllo completo. Un catalogo mancante, un recupero non riuscito e un documento non valido vengono visualizzati come risultati diversi. Questo controllo della pubblicazione non conferma il funzionamento delle API o dei server MCP elencati.
I risultati ARD vengono visualizzati separatamente e non influiscono sul punteggio AEO. Questa sezione in precedenza apparteneva allo scanner della velocità; nuovi controlli vengono eseguiti in AEO, mentre i rapporti sulla velocità salvati rimangono accessibili.
Come migliorare il tuo sito dopo un audit AEO
Inizia con una pagina che un agente deve leggere per un'attività specifica. Per una guida all'integrazione, ad esempio, controlla se sono disponibili la descrizione dell'operazione, i parametri e la richiesta di esempio.
- Controlla l’accesso al testo principale. Se il report segnala una dipendenza da JavaScript, confronta l’HTML originale con il contenuto del browser. Se manca il testo necessario, valuta il rendering lato server o una versione Markdown accessibile.
- Rivedi la struttura. Usa livelli di titolo consecutivi, colloca gli esempi accanto alle operazioni descritte ed elimina le spiegazioni ripetute. Le tabelle aiutano a confrontare parametri o opzioni.
- Valuta la quantità di testo. Dividi i riferimenti estesi in argomenti collegati, conservando condizioni ed esempi necessari per comprendere ogni pagina.
- Controlla come vengono scoperti i materiali di supporto. Se usi
llms.txt, aggiorna link e descrizioni brevi. Per ARD, correggi gli indirizzi di catalogo irraggiungibili e le voci non valide. - Ripeti l’audit dello stesso URL dopo la pubblicazione. Confronta le osservazioni, poi assegna all’agente il compito originale, per esempio trovare i parametri di un’operazione API e preparare una richiesta.
Come leggere il punteggio AEO
Leggi la percentuale insieme ai controlli applicabili, ai punteggi massimi e agli esiti incompleti. Questo audit non esegue controlli su AGENTS.md e SKILL.md.
Regole e pesi possono cambiare. Confronta report con le stesse regole e usa il massimo indicato nel report, senza presumere un totale fisso da un vecchio esempio. La sola percentuale non spiega un problema ancora presente.
Esamina le osservazioni e gli errori di recupero. Le regole si basano su euristiche e potrebbero non riconoscere markup, formulazioni o lingue insolite. Un punteggio elevato non garantisce posizioni nei motori di ricerca, citazioni nelle risposte AI o supporto di tutti i formati da parte di un agente specifico.
Domande frequenti sull'ottimizzazione per gli agenti IA
Un audit AEO controlla l’intero sito web?
Ogni esecuzione esamina l’URL selezionato e i file pubblici recuperati per quell’URL. Non visita tutte le pagine e non legge repository privati. Avvia un controllo separato per un’altra guida o pagina di riferimento.
Devo consentire tutti i crawler in robots.txt?
No. Bloccare un crawler specifico può essere una scelta deliberata del sito. Confronta l’osservazione con la tua politica di accesso e modifica le regole solo per i client che vuoi autorizzare.
Aggiungere llms.txt è sufficiente?
No. Un indice di link non corregge testi inaccessibili, errori di recupero o esempi incompleti. Rendi prima disponibili i contenuti necessari, poi valuta se llms.txt è adatto ai tuoi flussi di lavoro con gli agenti.
Esegui un audit del sito web AEO su una guida o pagina API. Utilizza i risultati per scegliere le modifiche, quindi confronta il risultato con la stessa attività.